Events FAQ

Learn what events are and how to configure them using the Events page.

Introduction

Events help you answer questions such as:

  • How many purchases were made by app users acquired via my Facebook campaign? 
  • How many users got to level 4 of my game from an Adwords campaign?
  • How many users who got to my website from a marketing activity registered to my platform?

Purchases, level-ups, and registrations are all examples of user events within your app or website that Singular can track for you.

Use the Events page (Settings > Events) to tell Singular which events you want to measure.

Note: Depending on your customer tier and the platform(s) of your products, the Events page may let you define cohort events (mostly associated with mobile apps), conversion events (mostly useful for websites), or both.

Cohort Events

What are cohort events?

Cohort events are in-app user events such as sign-ups, purchases, leveling up in a gaming app, etc. Singular tracks these events in a cohort-based manner, where the cohorts are based on the date of install (see What are cohort metrics in Singular?).

This means that cohort events answer questions such as:

  • In the group of users who installed the app on a certain day, how many users made a purchase within 7 days after installing?
  • In the group of users who installed the app on a certain day, how many users leveled up within 14 days after installing?
Where does the data for cohort events come from?

Cohort events are defined based on information from your attribution tracker. Any user interaction that your app reports to your tracker can be used to define a cohort event so you can track the stats for it in aggregate.

Doesn't Singular track my cohort events automatically?

If you use Singular's attribution service, the in-app events that your app sends to the Singular server appear automatically in the user-level attribution logs (see Exporting Attribution Logs).

However, they are not automatically arranged by cohort and measured in aggregate.

Only events that you define in the Events page are available as metrics in your reports.

What are "global events" and "app-specific events"?

You may want to track the same type of event across multiple applications. If so, select Global Events and then add the event.

If the event you want to add is only relevant to a specific app, select App-Specific Events and select the app.

What is a "unique event"?

In a unique event, you count the number of unique users who did something, e.g., how many distinct users made a purchase (unique event) vs. how many purchases were made through the app (non-unique event).

Note that unique events are counted based on cohort only (see What are cohort metrics and cohort periods?).

For example, say you run a report on the date of January 1 with a cohort period of 7 days. This is what occurred for that cohort in that period:

Screen_Shot_2020-08-31_at_15.55.52.png

The number of purchases (non-unique) is 4.

The number of unique purchases is 2.

If you choose a date range of more than one day, you are looking at more than one cohort, so the unique events for the different cohorts are simply added up.

For example, running a report on unique purchases in the date range of January 1-10, with the same cohort period, will result in a summary of how many distinct users who installed the app on those days made a purchase within 7 days after installing the app.

Usage notes:

  • If you run a report with unique events, you have to choose a cohort period (and can't choose "Actual").
  • When you create a new event, selecting "unique" changes the in-app events you can choose in the drop-downs.
  • You cannot create an event that measures both unique users and a simple count at the same time.
When I define a cohort event, can I map it to more than one in-app event?

Yes, you can map the event to more than one in-app event in the list. For example, if you are defining a cohort event called "sign-up", you can map it to the sign-up event defined in your attribution tracker, and to the sign-up event defined in Facebook.

Note: Make sure not to combine "sum" and "count" events. These are very different types of events and combining them under the same cohort event will lead to misleading numbers.

What is "Cost per Event (CPE)"?

Check the Cost per Event checkbox to have Singular add a metric that calculates your marketing costs per 1 event of this type (in the same way that Singular measures cost per install).

For example, if you define a "Registration" event, you can have Singular calculate your marketing costs per registration event. The metric will appear in your reports as "Registration CPE".

What is the "Event Conversion Rate" (ECVR)?

Check the Event Conversion Rate checkbox to have Singular add a metric that calculates the conversion rate from installs to your event. This is useful if you are optimizing your campaigns toward a certain event.

For example, if you are interested in how many users register to your platform after they install your app, add a "Registration" event, map it to the app's user registration event, and check the Event Conversion Rate checkbox. The Reports page will now include a Registration Conversion Rate metric that is calculated as registrations divided by installs.

How can I see stats for an event after I've created it?

The events you create appear in your query options on the Reports page. The calculated metrics are shown under Cohort Metrics (see What are cohort metrics?).

You can also view event stats through the Singular Reporting API. Use the Cohort Metrics endpoint to retrieve a list of all the cohort events defined in your account. Then, run a report through the Create Async Report endpoint including one or more of those events.

Note:

  • Allow 24 hours for the data from the event to start appearing in your reports.
  • If you save any reports or create any widgets in the dashboard based on events, deleting the event requires you to reset the saved reports.
Can I see cohort events in the API?

Yes. Use the Cohort Metrics endpoint to retrieve a list of all the cohort events defined in your account. Then, run a report through the Create Async Report endpoint including one or more of those events.

Can I edit an event after I saved it?

You can modify an existing event, with some limitations:

  • You can edit the name.
  • You can add or remove CPE and ECVR (Event Conversion Rate).
  • You can add other events to be mapped to this event, but you cannot remove events that have already been mapped. To remove mapped events, you have to delete the entire event and create a new one from scratch.
  • You can't make a unique event non-unique or vice versa.

Conversion Events

What are conversion events?

Conversion events are any user actions inside your product (typically, a website), that you want Singular to measure in aggregate.

Choose which events you consider to be "conversions" based on the nature of your product and your goals and KPIs. 

For example:

  • If you are marketing an online store, your conversion events could be the user making a purchase or signing up for an account.
  • If you're marketing a B2B solution, your conversion event could be a lead (the user asking for a product demo).
Where does the data for conversion events come from?

Conversion events are based on information from your ad networks. Any user interactions that are reported by the network can be used to define a conversion event in Singular.

How do I add conversion events?

To add a new conversion event:

  1. Go to Settings > Events and click New Event.
  2. Give your event an indicative name and choose what event it maps to in your advertising platform.
  3. If you also would also like to see the cost per event calculation in your reports, select the Cost Per Event (CPE) checkbox.
  4. Click Save.
What's the difference between "count" events and "sum" events?

Some events, such as purchases and lead creations, are associated with a dollar value. In that case, you can choose if you want your conversion event to track the count of events or the sum of the events' dollar values.

Can I track both the "count" and the "sum" of a certain user event?

Yes - just define a separate conversion event for each in the Events page.

Once I've added conversion events, how do I view their stats in my reports?

After you add a conversion event, it is available in the Reports page under "Conversion Events", with the name you configured for it:

Yes - if you have conversion events defined in your account, you can pull their stats through the Singular Reporting API. Use the Conversion Metrics endpoint to retrieve a list of all the conversion events defined in your account. Then, run a report through the Create Async Report endpoint including one or more of those events.

Note: Conversion events are never tracked by cohort and you do not need to pick a cohort period for them (see What are cohort metrics and cohort periods?). They are always tracked for the actual date.

You can also view conversion event stats through the Singular Reporting API. Use the Conversion Metrics endpoint to retrieve a list of all the conversion events defined in your account. Then, run a report through the Create Async Report endpoint including one or more of those events.

Was this article helpful?