Skip to main content
Setup is the checklist you follow to set up Cometly in a new space (a space is one workspace inside your account, with its own tracking and data). Its seven steps install the Cometly pixel (the script that tracks your website visitors), connect your ad accounts, tag your ads and create the events you want to measure. An event is an action you track, such as a lead or a purchase. Once the steps are done, Cometly can tie each lead and sale to the ad or channel that produced it. That lets you see which campaigns bring in revenue and which only spend budget. This page gives you the short version of every step and links to the detailed guide for each.

Start here

Before you start, take a moment to understand how Cometly works. How Cometly works gives you a high-level view of what Cometly does and how it helps you track and optimize your marketing. Setup lives in the left sidebar under Setup. It has seven steps. Cometly checks each step against your live data, so a step is marked complete when the work is really done; you cannot tick a step by hand. You can leave a step and come back to it at any time. If you would rather be guided, click Use the AI assistant on the Setup page. The setup assistant walks you through the same steps in a chat and uses no AI credits.

Step 1: About your business

Enter your website and click Look at my site. Cometly reads most of what it needs from your site, then asks a few questions: what kind of business you run, whether you have forms on your site, whether you use native lead forms, where your leads or sales get recorded, and which ad platforms you run. Click Save and continue. Your answers tailor the later steps. Steps 4 and 6 show Waiting until this step is answered. See About your business for each question and what it changes. It also helps to decide now which events you want to track (for example leads, purchases, sign-ups, deals created, closed won). There are tracking plan templates for each business type in Create a tracking plan.

Step 2: Install the Cometly pixel

The Cometly pixel tracks where your website visitors come from and captures opt-in data from your forms (name, email and phone number). Place it in the <head> section of every website or domain you want to track: your main domain (for example cometly.com) and any subdomains (go.cometly.com, blog.cometly.com, academy.cometly.com and so on). Once the pixel is in the <head>, no further code is needed for basic tracking. If you are a SaaS company, see the SaaS pixel setup guide. This step has five parts. The full walkthrough is in Install and verify the Cometly pixel. Add domains. Add each domain and subdomain where you will place the pixel. Open your website in a browser first: if the address includes www. when the page loads, include www. when you add the domain (www.yourdomain.com); if it does not, leave it out (yourdomain.com). Then click Add Domain. Pixel options. Turn on Automatic Cross Domain Tracking if visitors move between your domains. For example, if traffic flows from cometly.com to app.cometly.com, cross-domain tracking makes sure the visitor is tracked as the same person on both. SaaS companies with a separate app domain need it. See Cross-domain tracking for the automatic (recommended) and manual setups. Install the pixel. Click Copy Code and paste the script into the <head> section of your website (or websites). For platform-specific instructions, see pixel installation by platform. Verify your pixel. Click Verify next to each domain. A dialog explains that Cometly will open your website in a pop-up window and check for the pixel, which usually takes a few seconds. Do not close the pop-up until the check is finished. Testing a specific page is optional. SaaS companies that only add the pixel to their login and registration pages typically use it: expand Test a specific page and enter the page path. Click Verify in the dialog. Each domain then shows Pixel detected (the pixel is installed correctly) or Pixel not detected (it is not). If the pixel is not detected, see the pixel troubleshooting guides. Test form tracking. Cometly automatically captures these fields on your forms: full name, first name, last name, email and phone number. The data is captured in real time as visitors type. Email is the most important field, because it connects events to the correct contact. If you use third-party embedded forms (or iframes), extra setup is required. See Third-party forms, and Test form tracking to check that your forms are detected.

Step 3: Connect your ad platforms

Connecting your own profile on an ad platform lets Cometly see the ad accounts you have permission to use. You then connect those ad accounts to your space for tracking and reporting. The Setup step lists each platform with a Connect button that takes you to the Integrations page. The full walkthrough is in Connect ad platforms and ad accounts.
  1. In the left sidebar, click Integrations.
  2. In the Ad Platforms section, find the platform you want (for example Meta Ads, Google Ads, TikTok Ads or LinkedIn Ads) and click its sign-in button, such as Sign in with Facebook.
  3. Follow the prompts to approve access.
After your profile is connected, expand the platform’s row to see the ad accounts you have access to. These connections are tied to your user account, so only you can see and manage them. Click Connect & Sync Data next to each ad account you want to add to the space. Once an ad account is connected:
  1. It appears in the Connected Ad Accounts card for that platform and is visible to everyone in the space.
  2. Cometly starts pulling ad data for all active campaigns. It takes 30 to 60 minutes for the data to appear in your space.
  3. During that time, active campaigns do not show in the Ads Manager. They appear automatically once the data has refreshed.
  4. Ad and event conversion data is shown from the moment tracking is enabled. Past data cannot be retrieved retroactively.
If you generate leads with Meta Instant Forms (formerly Meta Lead Forms), make sure you have the permissions needed to track those leads in Cometly. See Meta lead form tracking.

Step 4: Add URL parameters to your ads

Add Cometly’s URL parameters to your ads, emails, SMS and custom sources so every click carries the information Cometly needs for attribution. In this step, pick a platform under Select integration and click Copy Parameters (or Copy Tracking Template for Google Ads and Microsoft Ads). Learn how to set up URL parameters

Step 5: Create conversion events

Events track actions such as form submissions, lead qualification, scheduled calls, deals created or purchases, wherever they happen: your website, funnel, CRM or payment processor. Choose the app or integration that sends the data, pick or create the event, and click Create Event. Then configure each event in Events Manager so it starts receiving data. Create and configure events

Step 6: Send conversions to ad platforms

The Conversion API sends the conversions Cometly attributes back to the ad platforms, such as Meta, Google and TikTok, from the server. This improves ad performance because their optimization sees every lead and sale. Let event data flow for about seven days first, so you can confirm the attribution looks right. Then click Open the Conversion API. See Send conversions to ad platforms for when to turn it on, and the Conversion API guides for each platform.

Step 7: Add Cometly to your AI agent

Use your Cometly data outside the app. The step has two tabs:
  • MCP: connect an AI assistant or coding agent to Cometly’s MCP server. See the MCP overview.
  • Data Warehouse: stream your Cometly data into your warehouse. See the data warehouse overview.
See Add Cometly to your AI agent for both tabs and how the step is marked complete.

Check it worked

Click Setup in the left sidebar. When all seven steps are done, each step shows Complete, the page heading changes to Your space is set up and a Setup complete card appears with a Tracking Health button.

Check your tracking health

When your steps are done, open the Tracking Health tab on the Setup page. It scores your setup and lists any issues found, with a button to fix each one. See Tracking Health for what each check looks at.

Frequently asked questions

Why does a Cometly Setup step say Waiting?

Waiting means Cometly does not have what it needs to check that step yet. Steps 4 and 6 show it until you answer step 1, About your business. Step 6 also shows it when the Conversion API is on but no conversion has been processed so far.

Why did a completed Setup step go back to incomplete?

Cometly keeps checking some steps against your live data after you finish them. Step 4 returns to not done when ads with URL parameter errors are found. Step 6 returns to incomplete if no conversion has been sent successfully in the last 14 days.

What is a good Tracking Health score in Cometly?

A score of 71 to 100 is labelled Healthy. The score is the share of your active checks that pass, so three passing checks and one failing check give 75. Checks that are waiting for data or do not apply to your setup are left out.

Next steps

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