Skip to main content
Events let you track the actions that matter most to your business: someone visits a key page, a new deal is added to your pipeline, or a lead becomes qualified. On this page you create conversion events in Cometly, connect each one to the app that sends its data, and test that the data arrives. Events are what Cometly attributes to your ads. Once an 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, so you know which ads produce leads and sales.

Create events

We recommend creating all of the events you want to send to Cometly before you start configuring them.
  1. In the left sidebar, click Setup.
  2. Open step 5, Create conversion events.
    Setup page on the Setup tab with an arrow pointing at step 5, Create conversion events, in the step list
  3. Under App / Integration, choose the app or integration that will send the data for this event.
    Step 5, Create conversion events, with an arrow pointing at the App / Integration dropdown, above the Select Webhooks link and the Create Event button
    If your integration is not listed, click Select Webhooks. Webhooks let you send data from any application, map its fields and apply filters. Each integration article says which method to choose for that app. See integrations by platform.
  4. Under Events, select the event name. Pick a default (built-in) event, or choose Create New Event to make a custom event. Learn more about default events and custom events.
  5. Optionally enter an event description, then click Create Event.
You can also create an event from Events Manager: click Create Event, fill in the same fields and click Create.
When you create an event, Cometly generates four metrics for it:
Example: If you create a custom event called “Deal Created”, these metrics appear in your Cometly reporting:
  • Deal Created
  • Cost per Deal Created
  • Deal Created Value
  • Deal Created ROAS
Repeat these steps for every event you want to track. New events are listed under the form as drafts.
Drafts to configure section with the Configure Events button and two draft events, each with a Draft badge and a Configure button
Once you have added all your events, you can configure them. Configuring an event means connecting it to its integration so it receives data whenever that event happens.

Configure events

If Cometly has no direct integration for the application you want to send event data from, webhooks are the easiest way to send data from it. See integrations by platform.
  1. In the left sidebar, click Events Manager. (From Setup, the Configure Events button takes you to the same page.)
    Events Manager page with an arrow pointing at Events Manager in the left sidebar
  2. Find the event you want to configure and click Configure, then follow the steps on screen.

Configure webhooks

Cometly webhooks let you send event data from any app to Cometly. You can map the data to Cometly fields and set up filters for events. Example: if your payment platform has no direct integration with Cometly, you can still send events like New Payment, New Trial, Converted Trial or Canceled Subscription to Cometly using webhooks. Learn how to send event data using webhooks

Configure Zapier

Zapier makes it easy to send event data to Cometly from apps without a direct integration. Example: if your CRM has no direct integration with Cometly, you can still send an event such as a deal moving to a new stage to Cometly using Zapier. Learn how to send event data using Zapier

Send custom event data using webhooks, Zapier or the API

You can send events server-side from a payment platform, CRM or any other back-end system. For a custom event, the event_name you send is the key of the custom event, not the name you gave it. For example, if you named your first custom event Deal Created, you send the server event through the Cometly API or Zapier with the event name custom_event_1. To find the exact value, go to Events Manager, click Manage custom events, select the event and look under How to set up your custom event. Your options for sending event data to Cometly:

Test your events

After you set up your events, test them to make sure everything works.
  1. Go to Events Manager and click the Events Log tab.
  2. Trigger a test event using your webhook or Zapier.
  3. Refresh the Events Log page.
  4. Check that the test event appears in the log.
    Events Log tab with Source set to Server and a box around the newest event in the list, which shows the status Processed
  5. Open the event’s details and confirm that all the information you sent is displayed correctly.

Check it worked

Your test event appears in the Events Log with the details you sent. In Events Manager, an event you have configured shows the status Active instead of Draft. On the Setup page, step 5 is marked complete once at least one event is connected to an integration.

Send events to the ad platforms

You can send an event to the ad platforms under its custom event name, or map the custom event to a standard event in Cometly and send it as a standard event. Standard events in Meta are predefined actions used to track and measure what people do on your website or app. Set up the Conversion API so Cometly can send conversion data to ad platforms such as Meta, Google, TikTok, LinkedIn and Microsoft, which improves ad performance. Learn how to activate the Conversion API

Frequently asked questions

How many custom events can I create in Cometly?

Each space (a workspace in your Cometly account) has 50 custom events, on top of the standard events every space starts with. You name and manage them in Events Manager under Manage custom events.

Why does my event still show as Draft in Cometly?

An event stays a draft until you connect it to its integration. In Events Manager, click Configure on the event and follow the steps on screen so it can start receiving data.

Does the value of a custom event count toward Gross Revenue?

Only if you choose so. The Purchase event already counts toward Gross Revenue. For a custom event, tick Include this event value in the “Gross Revenue” metric in its settings, and leave it off for events whose value is only potential, such as “Deal Created”.

Next steps

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