Skip to main content
An event is an action Cometly tracks, such as a form submission, a booked call or a purchase. Custom events are the events you define yourself, on top of the standard events every space (a workspace in your Cometly account) starts with. Each space has 50 custom event slots, and this page shows you how to manage custom events in Cometly: name them, configure them and reset them. Custom events let you track the steps that are specific to your business, such as “Deal Created” or “Lead Qualified”. Once a custom event receives data, you can see how many times it happened, what it was worth and what it cost for each campaign, ad set and ad.

Open custom event management

  1. Click Events Manager in the sidebar.
  2. Click Manage custom events.
You only see Manage custom events if your space role is Administrator, or you own the account.
The Custom Event Management dialog lists all 50 custom events. The ones you have set up are listed first.
Custom Event Management dialog listing custom events, three of them with a Configured badge
Each custom event has a fixed event_name, shown under its name:
  • custom_event_1
  • custom_event_2
  • custom_event_3
  • and so on, up to custom_event_50
You use this event_name when you send events to Cometly with the Cometly API or Zapier.

Configure a custom event

  1. Click a custom event in the list.
  2. Give it a Name.
  3. Choose the options below.
  4. Click Save.

Include this event value in the “Gross Revenue” metric (optional)

Tick this option if the value of this event should count toward the Gross Revenue metric.
  • Use it for events that are confirmed revenue.
  • Leave it off for events whose value is only potential, such as “Deal Created”. This keeps Gross Revenue limited to revenue you have actually earned.
The Purchase event already counts toward Gross Revenue. Gross Revenue is the total revenue before any deductions, and it is the basis for metrics such as:
  • ROI (Return on Investment): how much profit you made compared to what you spent.
  • ROI%: the percentage return on your investment.
  • ROAS (Return on Ad Spend): how much revenue you earned for every dollar spent on ads.
  • Net Profit: the profit left after subtracting costs from Gross Revenue.

Map the custom event to a standard event (optional)

By default, Cometly sends your custom event back to the ad platform as a custom event. Under Advanced settings, you can tick “Map the custom event to one of our standard events to send this data back to the ad platform as a standard event” and pick a Standard event (for example Lead or Purchase). Mapping helps when your ads are optimized for a specific event. For example, if you send data with Cometly’s Conversion API (the server-side connection that sends your conversions back to the ad platforms) and your campaigns optimize for Lead, mapping a custom event to the Lead standard event lets the ad platform recognize it and use it for that conversion goal.

Check that the event is configured

Once a custom event is saved with a name, it shows a Configured badge in the list, and you can start sending data for it:
Custom event row named Lead Form Initiated with an arrow pointing to its Configured badge

Reset a custom event

To clear a custom event and all of its data:
  1. Click the custom event in the list.
  2. Click Reset.
  3. Confirm with Yes, reset the data.
Resetting a custom event deletes all of its past data. This cannot be recovered.
Custom event settings with name, Gross Revenue and standard event options, and an arrow pointing to Reset

Analyze custom event data

Once an event is configured, its data appears in every reporting area of Cometly: the Ads Manager columns, the Report Builder and your dashboards. For each event you get the count of events, the cost per event, the event value and the event ROAS.

Check it worked

In Events Manager, click Manage custom events. The event you set up appears at the top of the list under the name you gave it, with a Configured badge. Once data arrives for the event, its metrics show up in the Ads Manager columns, the Report Builder and your dashboards.

Frequently asked questions

Can I rename a custom event in Cometly without losing its data?

Yes. Open the custom event, change its Name and click Save. The data stays with the event, because it is stored under the fixed event_name (for example custom_event_1), not under the name you chose.

Which event_name do I send for a custom event through the API or Zapier?

Send the fixed event_name of the custom event, such as custom_event_1, not the name you gave it. To find the exact value, open the custom event in Manage custom events and look under How to set up your custom event, where you can copy it.

Can I reuse a custom event slot for a different event?

Yes, by resetting it. A reset clears the event’s name, its settings and all of its past data, so the slot is empty again and you can set it up as a new event. The deleted data cannot be recovered, so only reset an event you no longer need.

Next steps

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.