Cometly is a server-side attribution platform that provides more accurate conversion data than traditional pixel-based tracking. Once connected, you can use Cometly's attribution data as your Results metric for campaign performance analysis and AI optimization.
Before you start
You'll need:
An active Cometly account with data flowing
Your Cometly API key (found in Cometly on Integrations → API)
At least one Meta ad account connected to AdStellar AI
Ads running that are being tracked by Cometly
Connect your Cometly account
in AdStellar AI go to Settings → Integrations
Find the Cometly card and click Connect
Generate a Cometly API key (In Cometly go to Integrations → Settings → API)
Paste your Cometly API key in AdStellar AI
Click Connect
Once validated, the card will expand to show configuration options.
Configure your integration
After connecting, configure these three settings before syncing.
Attribution model
Choose how credit is assigned to your ads for conversions:
First Touch – Source Specific (recommended): The first paid ad interaction gets full credit
Last Touch – Source Specific: The last paid ad interaction gets full credit
First Touch works best for most advertisers since it identifies which ads initiate customer journeys.
Attribution window
Define how long after an ad interaction a conversion can be credited:
Lifetime (LTV) (recommended)
1 day, 7 days, 14 days, 30 days, 60 days, or 90 days
Lifetime attribution gives you the most complete picture, especially for products with longer sales cycles.
Timezone
Select the timezone that matches your Cometly Space settings. This ensures dates convert correctly when syncing. The timezone must match exactly, or data may be attributed to incorrect dates.
The timezone in AdStellar AI must match Cometly's Space timezone exactly, or data may be attributed to incorrect dates.
Select events to sync
The Events to Sync section lets you choose which Cometly conversion events to bring into AdStellar AI.
Cometly tracks two types of events:
Standard events: Purchase, Lead, Add to Cart, etc.
Custom events: Events you've configured with custom names.
To add an event, click it in the Available Events column to move it to Selected Events.
To remove one, click the X next to it.
Only selected events will sync and become available as result metrics.
Sync your data
After configuring settings and selecting events:
Click Sync Now
Confirm if prompted (changing attribution settings requires reprocessing historical data)
Wait for the sync to complete
The Last Synced timestamp updates once finished.
Use Cometly as your result metric
Once synced, you can set Cometly events as the result metric for any campaign.
In AdStellar AI go to Performance in the left sidebar
Find your campaign and click Configure in the Results column
Select a Cometly event from the list (marked with a Cometly label)
Click Save & Update Results
A progress banner will appear while AdStellar AI backfills historical data. Once complete, the Results column shows your Cometly conversion data.
Automatic sync frequency
Cometly data syncs automatically based on your plan:
Plan | Sync frequency |
Hobby | Every 6 hours |
Pro | Every 3 hours |
Ultra | Every 1 hour |
You can trigger a manual sync anytime from Settings → Integrations by clicking Sync on the Cometly card.
Troubleshooting
No events found when selecting events to sync Your Cometly account may not have conversion events yet, or data hasn't started flowing. Verify your Cometly setup and ensure ads are running with tracking enabled.
Sync fails or shows an error Your API key may have expired or been revoked. Check it's still valid in Cometly, wait a few minutes, and try again.
Cometly events not appearing in Configure Results Make sure you've selected events to sync in the integration settings and that the initial sync has completed.
Result counts don't match Cometly dashboard Check that your attribution model, window, and timezone settings match between AdStellar AI and your Cometly Space.
Data isn't updating Verify your subscription is active (paused subscriptions don't sync) and check your plan's sync frequency.
Need help?
Contact our support team at [email protected] or use the chat icon in the bottom right corner. Include your workspace name, any error messages, and screenshots of your settings.



