Skip to main content

Connect Cometly to AdStellar AI

How to connect Cometly data to AdStellar AI

Updated this week

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

  1. in AdStellar AI go to Settings → Integrations

  2. Find the Cometly card and click Connect

  3. Generate a Cometly API key (In Cometly go to Integrations → Settings → API)

  4. Paste your Cometly API key in AdStellar AI

  5. 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:

  1. Click Sync Now

  2. Confirm if prompted (changing attribution settings requires reprocessing historical data)

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

  1. In AdStellar AI go to Performance in the left sidebar

  2. Find your campaign and click Configure in the Results column

  3. Select a Cometly event from the list (marked with a Cometly label)

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

Did this answer your question?