> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage custom events

> Manage custom events in Cometly: name each event, count its value toward Gross Revenue, map it to a standard event, or reset it.

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**.

> [!NOTE]
>
> 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](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/events/custom-events/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=81751c27c7d5c217be42fa57a3c55773)

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](https://docs.cometly.com/integrations/api.md) or [Zapier](https://docs.cometly.com/integrations/zapier.md).

## 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](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/events/custom-events/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=744d9b952bbe7f7a3163f0c56a3a5e4e)

## 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**.

> [!WARNING]
>
> 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](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/events/custom-events/04.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=c4677e9dfa5ed430538ed1063a922bea)

## 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.

[Analyzing custom event data](https://www.loom.com/embed/51862247aa0349b294b0090057b37ae8)

## 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

* [Create and configure events](https://docs.cometly.com/getting-started/events.md)
* [How events work](https://docs.cometly.com/guides/events/how-events-work.md)
* [Send events with the Cometly API](https://docs.cometly.com/integrations/api.md)
* [Conversion API overview](https://docs.cometly.com/guides/conversion-api/overview.md)
* [Metrics glossary](https://docs.cometly.com/guides/analyzing-data/metrics-glossary.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.