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

# AdRoll Ads integration

> Connect AdRoll to Cometly to see your AdRoll spend next to the leads and sales each ad produced, and send those conversions back to AdRoll.

When you connect AdRoll to Cometly, your AdRoll campaigns, ad groups and ads appear in the Ads Manager with their spend, impressions and clicks, and Cometly attributes conversions to the ad that drove them. Once connected, you can also send attributed conversions back to AdRoll through the Conversion API, a server-to-server connection between Cometly and the ad platform.

This puts AdRoll's spend next to the leads and sales Cometly tracked, so you can see which AdRoll ads produce conversions and which only spend money. You connect once, choose your ad accounts, then add Cometly's URL parameters (the tags on an ad's link that tell Cometly which ad a visitor clicked) to your ads.

## Before you start

* You need the **Administrator** or **Advertiser** role in the space to connect ad accounts.
* Sign in with the AdRoll login that has access to the ad accounts you want to track. Cometly lists the accounts AdRoll returns for that login.
* Allow pop-ups for Cometly in your browser. The AdRoll sign-in opens in a pop-up window.
* Switch to the space the ad account should report into. A space is a workspace in your Cometly account, and an ad account is connected to the space you are in.

## Connect AdRoll to Cometly

**1. Sign in with AdRoll**

In the left sidebar, click **Integrations**. Under **Ad Platforms**, find **AdRoll Ads** and click **Sign in with AdRoll**. Sign in and approve access in the window that opens. When it shows **Your AdRoll profile was synced successfully.**, click **Done**.

![The AdRoll Ads row on the Integrations page with the Sign in with AdRoll button on the right.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/integrations/ad-platforms/ad-roll/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=2e8a4903293d20fb6e91ad267840156c)

**2. Choose your ad accounts**

The **AdRoll 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 AdRoll Ad Accounts** card, where everyone in the space can see it and who connected it.

An ad account can be connected to only one space in your Cometly account. See [Same ad account in two spaces](https://docs.cometly.com/support/troubleshooting/ad-accounts/same-ad-account-in-two-spaces.md).

## Add Cometly's URL parameters to your ads

Add this to the URL of every AdRoll ad, in the query string (after a `?`, or after an `&` if the URL already has parameters):

```text theme={null}
comet_source=adroll&comet_campaign=[CAMPAIGN_EID]&comet_ad_group=[ADGROUP_EID]&comet_ad_id=[AD_EID]
```

![Setup step 4, Add URL parameters to your ads, with AdRoll Ads selected, showing the AdRoll Ads URL Parameters template and the Copy Parameters button.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/integrations/ad-platforms/ad-roll/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=5493e7956e0950ba6616cc83c012b2eb)

Paste it exactly as shown and leave the placeholders in square brackets as they are. You can copy the template in Cometly under **Setup**, step 4 **Add URL parameters to your ads**, with **AdRoll Ads** chosen under **Select integration**.

Cometly can't add the parameters to AdRoll ads for you, so add them to each new ad you create. See [AdRoll Ads URL parameters](https://docs.cometly.com/getting-started/url-parameters.md#adroll-ads-url-parameters).

On every sync, Cometly reads each ad's destination URL and looks for `comet_ad_group=[ADGROUP_EID]` and `comet_ad_id=[AD_EID]`, written exactly like that. An active ad without them, including an ad whose URL has no parameters at all, 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**. After you fix an ad in AdRoll, the red dot stays until the next data refresh. See [Fix UTM Setup Errors](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md).

## Send conversions back to AdRoll

The **AdRoll** section of the Conversion API (**Events Manager**, then the **Conversion API** tab) sends conversions to AdRoll, server to server. You turn on data sharing, paste an **AdRoll server access token** (issued by AdRoll, separate from this connection) and map your Cometly events to AdRoll events. Only conversions that Cometly attributed to an AdRoll click are sent. See [Configure the AdRoll Conversion API](https://docs.cometly.com/guides/conversion-api/ad-roll.md).

## What to expect after connecting

* **First data.** Active campaigns begin populating data within 30 to 60 minutes.
* **Refresh.** Cometly refreshes AdRoll data every 60 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 starts tracking every campaign that is running in AdRoll. For a campaign that isn't running, or with auto-tracking turned off, see [Manually turn on tracking for your ad campaigns](https://docs.cometly.com/support/troubleshooting/ad-data/manually-turn-on-tracking.md).
* **In the Ads Manager.** You get campaigns, ad groups and ads with spend, impressions and clicks. If you have ads management permission, you can rename and pause or activate campaigns and ad groups. Budgets and individual ads can't be changed from Cometly.

On the **Integrations** page, the **AdRoll Ads** row shows **Connected** or **Connection Issue, Resync Required**, and **Last Synced**: the time your AdRoll connection was last refreshed (when you signed in or resynced, or when Cometly last renewed its access), not the time of the last data refresh. **Resync** runs the AdRoll sign-in again. **Disconnect** removes your AdRoll profile and stops tracking for every ad account connected through it. See [Disconnect an ad platform connection](https://docs.cometly.com/support/troubleshooting/ad-accounts/disconnect-an-ad-platform.md).

## Troubleshooting

### Nothing happens when you click "Sign in with AdRoll"

Your browser is most likely blocking the pop-up window. Allow pop-ups for Cometly, then click **Sign in with AdRoll** again.

### The AdRoll window shows an error instead of a success message

**AdRoll authorization failed**, followed by AdRoll's reason, means AdRoll did not grant access: click **Done**, then **Sign in with AdRoll**, and approve access. For **Invalid OAuth state while connecting AdRoll. Please try again.**, **Missing authorization code from AdRoll.** or **There was an error syncing your AdRoll profile. Please try again later.**, click **Done** and start again. If it keeps happening, [contact support](https://docs.cometly.com/support/contact.md) and include the name of the AdRoll ad account, the status the **AdRoll 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 AdRoll Connection"

AdRoll no longer accepts the connection. The user who connected the profile needs to expand the **AdRoll Ads** row, click **Resync** and sign in to AdRoll again. When data flows again, you get an **AdRoll Connection Restored** notification, and data from the past 48 hours is restored automatically. See [Ad data not syncing for hours or days](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md).

The row shows the same status when AdRoll's daily API request quota has been reached. If a resync does not clear it, try again the next day.

### An ad account is missing, or the table says "No ad accounts found"

The table only lists accounts that AdRoll returns for the login you used. Sign in with an AdRoll login that has access to the account. If your AdRoll login loses access to an ad account that is already connected, Cometly disconnects that ad account from its space.

### You got a "Tracking Error: AdRoll" notification

Active ads with recent spend are running without Cometly's URL parameters. Click **View affected ads**, fix each ad's URL in AdRoll (**Copy Parameters** copies the template), and the notification clears on its own.

## Frequently asked questions

### Does Cometly import past AdRoll data when I connect?

No. Cometly does not track campaigns retroactively: it tracks a campaign from the moment its tracking is turned on, and from that point forward. See [Tracking historical ad data](https://docs.cometly.com/support/troubleshooting/ad-data/historical-ad-data.md).

### Who can see and manage my AdRoll connection in Cometly?

Your AdRoll connection is personal: it is tied to your user account, and only you can see and manage it. The ad accounts you connect to a space are listed in the **Connected AdRoll Ad Accounts** card, where everyone in the space can see them and who connected them.

### Do I need the Cometly pixel to track AdRoll ads?

Yes. The Cometly pixel is a small script on your website that records each visit, and without it Cometly has no record of the visitor an AdRoll ad sent. The URL parameters on the ad tell Cometly which ad that visitor clicked. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Next steps

* [Add URL parameters to your AdRoll ads](https://docs.cometly.com/getting-started/url-parameters.md)
* [Send conversions to AdRoll with the Conversion API](https://docs.cometly.com/guides/conversion-api/ad-roll.md)
* [Compare your AdRoll campaigns in the Ads Manager](https://docs.cometly.com/guides/ads-manager/overview.md)
* [Fix UTM Setup Errors on your ads](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md)
* [See how often ad data updates in Cometly](https://docs.cometly.com/support/troubleshooting/ad-data/data-update-frequency.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.