Connecting Search Ads 360 on Clarisights

Search Ads 360 (formerly DoubleClick Search) is Google's cross-engine search management platform. Connecting Search Ads 360 to Clarisights brings your manager-account, sub-manager, and client customer hierarchy — along with campaigns, ad groups, ads, and keywords across Google Ads, Microsoft Advertising, Yahoo, and Baidu — into one unified reporting layer with the rest of your paid media.

At a glance

Authentication	Google OAuth 2.0 with the https://www.googleapis.com/auth/doubleclicksearch scope
Permissions needed	Read access on the Search Ads 360 manager and/or client accounts you want to connect (Standard or higher role)
Account discovery	Automatic via the ListAccessibleCustomers + customer_client queries; the full manager / sub-manager / client tree under the authenticated user is offered
Data freshness	Daily, with a 3-day rolling refresh and an extended 7-day backfill DAG
Lookback window	3 days on the regular refresh; 7 days on the backfill
Backfill on connect	Last 7 days by default — contact support for a deeper historical backfill
Timezone	Account-level timezone (inherited from the Search Ads 360 customer)
Currency	Account-native currency, auto-converted to your reporting currency
Levels supported	Account · Campaign · Ad Group · Ad · Keyword (segments also supported)
Limited rollout	No

Prerequisites

• An active Search Ads 360 account in Search Ads 360

• A Google account with at least Standard access on every manager / client account you want to connect (Read-only is also sufficient for reporting)

• Permission on your Google account to authorize third-party apps (some Google Workspace policies block this)

• If you use a Search Ads 360 manager hierarchy, know which manager account ID acts as the login-customer-id for child accounts — Clarisights detects this automatically, but it's useful for troubleshooting

Steps to Connect

Step 1 — Sign in with Google from Clarisights

In Clarisights, go to Integrations → SearchAds 360 and click Connect. You'll be redirected to Google to authenticate. Sign in with the Google account that has access to your Search Ads 360 manager and/or client accounts.

[TODO: Screenshot needed — Integrations page SearchAds 360 row]

Step 2 — Authorize Clarisights

Google will display a permission screen requesting the doubleclicksearch scope. Click Allow.

⚠ "This app is blocked" / "Access blocked" → Your Google Workspace admin restricts third-party apps. Ask the admin to allowlist Clarisights, or sign in with a Google account whose organisation permits OAuth to external apps.

Step 3 — Select accounts

After authorization, Clarisights walks the Search Ads 360 customer tree starting from ListAccessibleCustomers, then traverses each manager via customer_client to discover every client account you can report on. Choose the customers (client accounts) you want to connect, optionally rename them, and click Create Accounts.

⚠ "Forbidden" / 403 errors during account discovery → The Google user is missing access on one or more manager accounts in the chain. Ask your Search Ads 360 admin to grant Standard or Read-only access on the missing managers and retry.

Verify the connection

• Go to Integrations → SearchAds 360. Each connected client account should show a "Connected" status with its customer ID.

• First data appears within ~24 hours of the next scheduled sync.

• Quick start: create a new report, add SearchAds 360 as the data source, and add Account · Campaign · Ad Group · Impressions · Clicks · Cost.

Data available

Hierarchy

How Search Ads 360's native levels map to the standard Clarisights levels:

Native level (Search Ads 360)	Clarisights level
Customer (client account)	Account
Campaign	Campaign
Ad Group	Ad Group
Ad	Ad
Keyword	Keyword (additional level under Ad Group)
Segment	Segment (e.g., device, network, query)

Manager and sub-manager customers are used for hierarchy discovery and as the login-customer-id when querying child customers; only client accounts surface as Clarisights accounts.

Dimensions

Dimension	Level	Description
Account / Customer ID / Manager ID	Account	Client customer name, ID, and the manager / sub-manager that owns it
Account Currency / Account Timezone	Account	Native currency and timezone configured on the customer
Account Status	Account	Active, paused, hidden, test_account, etc.
Campaign Name / ID / Status	Campaign	Standard campaign attributes
Campaign Type / Sub-Type / Channel	Campaign	Engine type and channel (Google Ads, Microsoft, Yahoo, Baidu)
Bidding Strategy / Budget	Campaign	Configured bidding strategy and budget
Ad Group Name / ID / Status / Type	Ad Group	Standard ad group attributes
Ad Name / ID / Status / Type / Final URL	Ad	Standard ad / creative attributes
Keyword Text / Match Type / Status / Quality Score	Keyword	Keyword-level attributes
Custom Columns	Account / Campaign / Ad Group	Custom columns defined in Search Ads 360 are discovered via list_customer_custom_columns and surfaced in reports
Labels (custom tag groups)	Account / Campaign / Ad Group / Ad / Keyword	Search Ads 360 labels are pulled per level
Segments — Device / Network / Query / Date	Segment	Standard report segments

Metrics

Reports filter to rows with metrics.impressions > 0 for performance level data. Metrics are pulled at every level (campaign, ad group, ad, keyword) and at segment level when supported.

Core performance

Metric	Description
Impressions	Total ad displays
Clicks	Total clicks
Cost (Cost Micros)	Spend in account currency, converted from micros
CTR / Average CPC / Average CPM	Standard rate metrics
Search Impression Share / Search Top Impression Share	Auction insights metrics where available

Conversions

Metric	Description
Conversions / All Conversions	Standard and all-conversion counts
Conversion Value / All Conversion Value	Revenue tied to those conversions
Conversions From Interactions	Conversions attributed to ad interactions
Cross-engine conversion variants	Search Ads 360 cross-engine conversion metrics where configured
Floodlight conversion columns	Surfaced via Search Ads 360 custom columns and per-conversion metrics

Video & engagement

Metric	Description
Video Views / Engagements / Engagement Rate	For video and engagement campaign types
Interaction Rate / Interaction Event Types	Video, image, and rich-media interaction metrics

Limitations & known constraints

• Standard SA360 API quotas: GA-tier API limits apply per developer token / OAuth client. Very large customer trees may take longer to ingest end-to-end on the first sync.

• impressions > 0 filter: performance reports only return rows with at least one impression. Zero-impression entities are still discovered as dimensions (via the core / labels queries), but won't appear in performance metric tables.

• Manager-only customers don't surface as accounts: managers and sub-managers are used to traverse the tree, not as reportable accounts. Only client customers (i.e., non-manager) appear in Clarisights.

• Cost is reported in micros: the API returns cost as cost_micros. Clarisights divides by 1,000,000 to give a normal currency value before converting to your reporting currency.

• Custom Floodlight columns must be enabled in SA360: only custom columns visible in the Search Ads 360 UI are pulled. Add them in Search Ads 360 first, and they'll appear on the next refresh.

• Token revocation: revoking the Clarisights connection in your Google account stops all syncing until you re-authenticate.

Operating notes

• Refresh schedule: a daily DAG pulls today + 3 days. A separate 7-day backfill DAG runs to catch later attribution.

• Lookback: 3 days on every regular run; 7 days on the backfill run.

• Adding new accounts: when a new client customer is added under a manager, return to Integrations → SearchAds 360 and re-discover. Already-connected accounts are not re-prompted.

• Currency conversion: native amounts are pulled as-is from cost_micros and converted to your Clarisights reporting currency.

• Credential rotation: OAuth tokens auto-refresh. You only need to re-authenticate if you change your Google password or revoke the Clarisights connection.

Need help?

When contacting support from the in-app messenger, please include:

• The integration name and customer ID + manager ID (Integrations → SearchAds 360)

• The exact error message or screenshot

• The step where the issue occurred

• When the issue started