Before you start
- You need the Administrator or Advertiser role in the space to connect ad accounts. A space is a workspace in your Cometly account, with its own settings, integrations and data.
- Sign in with the X account that has access to the ad accounts you want to track. Cometly lists the ad accounts X returns for that login.
- Allow pop-ups for Cometly in your browser. The X sign-in opens in a pop-up window.
- Switch to the space the ad account should report into. An ad account is connected to the space you are in.
Connect X Ads
1
Sign in with X
In the left sidebar, click Integrations. Under Ad Platforms, find X Ads and click Sign in with X. Sign in and approve access in the window that opens. When it shows Your X profile was synced successfully, click Done.

2
Choose your ad accounts
The X Ads row expands and shows your profile with an Ad Accounts table. Use Search ad account to find an account, then click Connect & Sync Data next to each one you want in this space.
Check it worked
You’ll see the message Ad Account Connected - Data will sync in 30-60 minutes. The account now shows Connected, and it appears in the Connected X Ad Accounts card, where everyone in the space can see it and who connected it. Within 30 to 60 minutes, your active X campaigns start to show data in the Ads Manager.Add Cometly’s URL parameters to your ads
Add this to the URL of every X ad, in the query string (after a?, or after an & if the URL already has parameters):
{{campaign_id}}, {{adgroup_id}} and {{ad_id}} are X’s dynamic parameters, and X fills them in when someone clicks the ad. You can copy the template in Cometly under Setup, step 4 Add URL parameters to your ads, with X Ads chosen under Select integration.
Cometly can’t add the parameters to X ads for you, so add them to each new ad you create. See X Ads URL parameters.
On every sync, Cometly reads each ad’s destination URL. An active ad whose URL has parameters but not comet_source=x and comet_ad_id={{ad_id}} gets a UTM Setup Error: a red dot on the Ads tab of the Ads Manager and next to the ad’s name. To see what each ad carries, open the Columns menu on the Ads tab and select URL Params and Tracking Status. See Fix UTM Setup Errors.
Send conversions back to X
The X Ads section of the Conversion API (Events Manager, then the Conversion API tab) sends your Cometly events to X, server to server. You choose a data sharing mode (Send only attributed events or Send all events), set a default pixel for each ad account and map your Cometly events to X events. It uses the X connection you made above, so there is no extra token to create. See Configure the X Ads Conversion API.What to expect after connecting
- First data. Active campaigns begin populating data within 30 to 60 minutes.
- Refresh. Cometly refreshes X Ads data every 30 minutes and pulls the previous two days again once a day.
- Which campaigns are tracked. With Auto-track new campaigns turned on (Settings, then Campaign tracking under Workspace), Cometly tracks the campaigns that are active when you connect the account and the campaigns you create afterwards. For any other campaign, see Manually turn on tracking for your ad campaigns.
- In the Ads Manager. Each ad is a promoted post, named after the post’s text. Spend is converted to your space’s currency. If you have ads management permission, you can rename and pause or activate campaigns and ad groups, and change a budget on the level that holds it. Individual ads can’t be paused from Cometly.
Troubleshooting
”Your browser blocked the X sign-in popup. Please allow popups and try again.”
Allow pop-ups for Cometly in your browser, then click Sign in with X again.The X window shows an error instead of a success message
You cancelled the X connection. Please try again to connect your X account. means the request was declined in the X window: click Done, then Sign in with X, and approve access. For We were not able to start the X connection, We were not able to sync your X profile or There was an error syncing your X profile, click Done and start again. If it keeps happening, contact support and include the name of the X ad account, the status the X Ads row shows, and the destination URL of an ad that isn’t tracking.The row shows “Connection Issue, Resync Required”, or you got “Action Required: Resync X Ads Connection”
X no longer accepts the connection, and X connections do not renew on their own. The user who connected the profile needs to expand the X Ads row, click Resync and sign in with the same X account. When data flows again, you get an X Ads Connection Restored notification, and data from the past 48 hours is restored automatically. See Ad data not syncing for hours or days.An ad account is missing, or the table says “No ad accounts found”
The table only lists ad accounts that X returns for the login you used. Sign in with an X account that has access to the ad account. If your X login loses access to an ad account that is already connected, Cometly disconnects that ad account from its space.You got a “Tracking Error: X Ads” notification
Active ads with recent spend are flagged with a UTM Setup Error. Click View affected ads, fix each ad’s URL in X (Copy Parameters copies the template), and the notification clears on its own.Frequently asked questions
Do I need the X pixel installed to send conversions from Cometly to X?
Yes. The X Ads Conversion API needs your X pixel installed on your site and at least one event you created yourself in X Ads Manager under Tools > Events Manager. Cometly can only map events that have their own event tag, so X’s auto-created standard events can’t receive the data.How long does it take for Cometly to pick up URL parameter changes on my X ads?
Cometly reads your ads’ parameters each time it refreshes your ad data, so a change does not show right away. Allow up to 1 hour for the next data refresh before you troubleshoot further.What happens to X ad clicks that don’t have Cometly URL parameters?
The click does not carry the information Cometly needs to attribute it to that ad. Cometly still tracks the referrer (the site the visitor came from), but the referrer is not always passed correctly, so some of that traffic can show as “No Source” in your reports.Next steps
- Configure the X Ads Conversion API
- Add URL parameters to your ads on every platform
- Check your setup in Tracking Health
- Fix UTM Setup Errors on your ads
- Use the Ads Manager