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

# How Cometly works

> How Cometly works, step by step: the pixel tracks your visitors, events tie each lead and sale to an ad, and conversions go back to your ad platforms.

Cometly is a marketing attribution platform. It tracks the visitors who reach your site, ties each lead and sale back to the ad or channel that produced it, and sends those conversions back to your ad platforms. This page explains how Cometly works, one concept at a time, with a short video for each.

Knowing how the pieces fit together helps you decide what to track, and helps you trust the numbers when you choose which ads to scale or turn off. This page does not explain how to set Cometly up. For step-by-step setup instructions, see [Set up Cometly](https://docs.cometly.com/getting-started/setup.md).

## How Cometly works, and why you're using it

Ad platforms only report the conversions they can see for themselves. Cometly collects the full picture: where each visitor came from, what they did on your site, and whether they later became a lead or a sale. You can then see which ad produced each result, and share that data with the ad platforms.

Four parts make this work, and the sections below cover each one: the Cometly pixel, events, the Conversion API, and the reporting inside your account.

**Watch time:** 4 minutes

**Agenda:**

* What this course covers.
* Why you're using Cometly.

[Introduction and why you're using Cometly](https://www.loom.com/embed/458c031e96aa464d95598ae83ca21da0)

## How our tracking works: the Cometly pixel

The Cometly pixel is a tracking script you place in the `<head>` section of every website or domain you want to track, including subdomains. It tracks where your website visitors come from and captures opt-in data from your forms (name, email and phone number).

The pixel works together with URL parameters, the tags you add to the links in your ads, emails and other sources. When someone clicks, the parameters tell Cometly which source sent that visitor, so later events can be attributed to it.

**Watch time:** 4 minutes

**Agenda:**

* Overview of the Cometly pixel and how it works.
* A visual demonstration of how the pixel works.

> [!NOTE]
>
> The video calls the pixel the "base code". They are the same thing: the tracking script you add to your site in Setup, under **Install the Cometly pixel**.

[How our tracking works: base code](https://www.loom.com/embed/196f89644cb542af9b118169fda703ca)

## How our tracking works: tracking events

An event is an action you want to measure, such as a form submission, a qualified lead, a scheduled call, a new deal or a purchase. You track events so you can see which ads lead to those actions, not only which ads get clicks.

Events can come from your website, funnel, CRM or payment processor. Some are captured in the browser, and others are sent from the server by an integration, a webhook or the Cometly API. When you create an event, Cometly generates four metrics for it: the count, the value, the cost per event and the return on ad spend (ROAS).

**Watch time:** 7 minutes

**Agenda:**

* What are events?
* Why would you want to track an event?
* How can you set up events? (Browser and server.)
* A visual demonstration of how events work.

[How our tracking works: tracking events](https://www.loom.com/embed/7a01628f34eb4453a4a0fa7054621386)

## Feeding the ad platform's AI with accurate data

The Conversion API sends the events Cometly tracks back to your ad platforms from the server. Each platform can then optimize and report on conversions it would otherwise miss, not only the ones a browser pixel caught.

This matters because ad platforms decide who sees your ads based on the conversions they know about. The more complete that data is, the better the platform can find people like the ones who already became leads and customers.

**Watch time:** 3 minutes

**Agenda:**

* How does feeding the data work?
* Why does this matter?
* A visual explanation of the Cometly data flywheel.
* Results of feeding data to the ad platforms.

[Feeding the ad platform's AI with accurate data](https://www.loom.com/embed/1b4fcb623b17409ba6a2547ec21330e1)

## Account overview: spaces and users

Cometly is organized into an account and its spaces. The account is the top level and is linked to billing. A space is like a workspace or project, with its own settings, integrations, data and members, which is useful if you run several businesses or work with several clients.

Every user you add belongs to the account and has an account role: Owner, Administrator or Member. Inside each space, a user also has a space role (Administrator, Advertiser or Viewer) that controls what they can do there. See [How accounts and spaces work](https://docs.cometly.com/getting-started/teams-and-spaces.md) for what each role allows.

**Watch time:** 2 minutes

**Agenda:**

* What are spaces?
* Adding users to Cometly.
* Permissions for users.

[Account overview: spaces and team members](https://www.loom.com/embed/50c41d564d074ed5aa65167ea8215c3b)

## Analyzing data inside Cometly

The Ads Manager is where you compare your ads against the events Cometly tracked. It shows one ad account at a time, split into level tabs such as **Campaigns**, **Ad Sets** and **Ads**, so you can see results for a whole campaign or a single ad.

Above the table, the **Attribution model** and **Attribution window** selectors control how credit for a conversion is assigned to your ads. The **Columns** dropdown lets you choose which metrics to show and save them as a preset. See [Use the Ads Manager](https://docs.cometly.com/guides/ads-manager/overview.md) for the full tour.

**Watch time:** 8 minutes

**Agenda:**

* A live walkthrough of a real Cometly account.
* Overview of the Cometly Ads Manager.
* Customizing your data columns.

[Analyzing data inside Cometly](https://www.loom.com/embed/12c39edf9a85435db1e55c80202bc6d9)

## Getting help

If something does not look right, start with [Troubleshooting](https://docs.cometly.com/support/troubleshooting/overview.md), which covers the most common pixel, event, ad data and integration issues. The [Event Log](https://docs.cometly.com/support/troubleshooting/general/event-log.md) shows the events Cometly received and is the fastest way to confirm whether an event arrived.

[Getting help](https://www.loom.com/embed/124acfc9ad4044208fa1c732df509613)

## Frequently asked questions

### What is the difference between the Cometly pixel and the Conversion API?

The pixel collects data: it runs on your website and tracks where visitors come from and what they submit in your forms. The Conversion API sends data the other way, passing the events Cometly tracks back to your ad platforms from the server.

### When should I turn on the Conversion API in Cometly?

Let event data flow for about seven days first. That gives you time to confirm the attribution looks right before the ad platforms start optimizing on it. Step 6 of Setup, **Send conversions to ad platforms**, shows where your space stands.

### Can I use Cometly for more than one business or client?

Yes. Create a space for each business, brand or client inside your account. Each space has its own Cometly pixel, integrations and data, and nothing is shared between spaces.

## Next steps

* [Set up Cometly](https://docs.cometly.com/getting-started/setup.md)
* [Create a tracking plan](https://docs.cometly.com/getting-started/tracking-plan.md)
* [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md)
* [Learn how standard and custom events work](https://docs.cometly.com/guides/events/how-events-work.md)
* [Documentation home](https://docs.cometly.com/index.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.