Connecting AdRoll on Clarisights
AdRoll (NextRoll) is a display retargeting and prospecting platform. Connecting AdRoll to Clarisights lets you analyze impressions, clicks, spend, and view/click-through attribution from your retargeting campaigns alongside the rest of your paid stack.
At a glance
| Authentication | OAuth 2.0 (NextRoll / AdRoll) |
| Permissions needed | A user role on the AdRoll organization with read access on advertisables (the AdRoll term for ad accounts) |
| Account discovery | Automatic: every advertisable your AdRoll user can see is offered |
| Data freshness | Daily (deliveries and attribution reports refresh each cycle) |
| Lookback window | Configurable backfill window; default daily refresh covers recent days |
| Backfill on connect | Recent reporting window pulled on first connect |
| Timezone | UTC (all AdRoll stats are stored in UTC) |
| Currency | Account native currency (auto-converted to your reporting currency) |
| Levels supported | Account (Advertisable) · Campaign · Ad Group · Ad |
| Limited rollout | Yes. AdRoll is not listed on the Integrations page. Contact your Clarisights account manager to connect it. |
Prerequisites
An active AdRoll / NextRoll account with at least one advertisable
A user role on the AdRoll organization with read access to advertisables, campaigns, and reporting
Permission to authorize third-party apps with your AdRoll account
Steps to Connect
AdRoll is not available as a self-serve card on the Integrations page. Your Clarisights account manager sets up the connection with you.
Step 1: Contact your account manager
Reach out to your Clarisights account manager (or support from the in-app messenger) and ask to connect AdRoll. Share the names or Advertisable IDs (EIDs) of the advertisables you want to report on.
Step 2: Authorize Clarisights in AdRoll
During setup you are asked to sign in to AdRoll with a user that has access to those advertisables. AdRoll shows a permission screen listing the read access Clarisights needs (advertisables, campaigns, ad groups, ads, and reporting). Click Allow.
⚠ Authorization fails → AdRoll did not grant Clarisights a long-lived token. Retry the sign-in; if it fails again, make sure your AdRoll user has access to at least one advertisable in the organization.
Step 3: Confirm the advertisables
Clarisights discovers every advertisable your AdRoll user can see. Your account manager connects the ones you asked for and confirms once the first sync has run.
Verify the connection
Your account manager confirms which advertisables are connected.
First data appears within 24 hours, after the next scheduled sync.
Quick start: create a new report, add AdRoll as the data source, and add Account · Campaign · Impressions · Clicks · Spend · Click-Attributed Revenue.
Data available
Hierarchy
How AdRoll's native levels map to the standard Clarisights levels:
Native level (AdRoll) | Clarisights level |
Advertisable | Account |
Campaign | Campaign |
Ad Group | Ad Group |
Ad | Ad |
Dimensions
Dimension | Level | Description |
Account | Account | AdRoll advertisable name and ID |
Channel | Account | Always "AdRoll"; useful in cross-channel reports |
Campaign | Campaign | Campaign name and ID |
Campaign Status | Campaign | Configured status of the campaign |
Campaign Start Date | Campaign | Start date of the campaign |
Daily Budget | Campaign | Daily budget set on the campaign |
Audience Strategy | Campaign | Retargeting or Prospecting |
Targeting Types | Campaign | Web or Facebook |
Bidding Strategy Type | Campaign | Automatic or Manual for web campaigns; the bid strategy for Facebook campaigns |
Ad Group | Ad Group | Ad group name and ID |
Ad Group Status | Ad Group | Configured status of the ad group |
Targeted Audience | Ad Group | Audience segments targeted by the ad group (excluded segments are not listed) |
Publisher Platforms | Ad Group | Websites and Apps, Facebook, and/or Instagram |
Facebook Positions | Ad Group | Facebook placements, for example Desktop News Feed or Audience Network |
Ad | Ad | Ad name and ID |
Ad Status | Ad | Configured status of the ad |
Ad Type | Ad | Type of creative |
Creative Size | Ad | Ad format or size |
Headline | Ad | Ad headline |
Images | Ad | Creative image, shown as a thumbnail |
Landing Pages | Ad | Destination URL of the ad |
Metrics
Delivery
Metric | Description |
Impressions | Total ad impressions |
Clicks | Total clicks |
Spend | Total spend in account currency |
CTR | Click-through rate (clicks / impressions) |
CPM | Cost per thousand impressions |
CPC | Cost per click |
Attribution
Metric | Description |
VTC | View-through conversions (precise) |
CTC | Click-through conversions (precise) |
Assists | Precise assist conversions |
Conversions | VTC + CTC |
VTC Rate | VTC / Impressions |
CTC Rate | CTC / Clicks |
CPA | Spend / Conversions |
Click CPA | Spend / CTC |
View CPA | Spend / VTC |
Revenue
Metric | Description |
Click-Attributed Revenue | Revenue attributed to ad clicks |
View-Attributed Revenue | Revenue attributed to ad views |
Assist Revenue | Revenue from assist conversions |
Attributed Revenue | Click + View attributed revenue |
Click ROI | Click revenue / Spend |
View ROI | View revenue / Spend |
ROI | Attributed revenue / Spend |
Limitations & known constraints
Two report streams: AdRoll exposes performance via two separate endpoints: deliveries (impressions / clicks / spend) and attributions (VTC / CTC / revenue). Both are pulled and stitched together in Clarisights, but a delay in one stream can briefly show inconsistent numbers between delivery and attribution metrics.
UTC-only timezone: All AdRoll stats are stored in UTC. Day-boundary comparisons against channels in other timezones may show small alignment differences.
Ad → Ad Group association: Some AdRoll API responses don't include the parent ad group on an ad. Clarisights reconstructs the mapping by walking ad-group-to-ad relationships during sync, but if a brand-new ad lands between syncs it may briefly appear without an ad-group parent.
Audience names: Targeted Audience values come from AdRoll's segment names. A newly created segment may take until the next sync to appear.
Revoked access: if you revoke Clarisights' access in AdRoll, the integration stops syncing until it is reconnected.
Operating notes
Refresh schedule: data is pulled daily; access tokens auto-refresh on demand.
Multi-account: a single AdRoll user can connect every advertisable they have access to. Use additional AdRoll users for advertisables managed by separate organizations.
Currency conversion: native account currency is preserved on ingest and converted to your reporting currency by Clarisights.
Reconnecting: AdRoll authorization expires after about a year, and stops immediately if access is revoked in AdRoll. Contact your account manager to reconnect; you will be asked to sign in to AdRoll again.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and Advertisable ID
The exact error message or screenshot
The step where the issue occurred
When the issue started