Integrating DV360 on Clarisights
Display & Video 360 (DV360) is Google's enterprise demand-side platform. Connecting DV360 to Clarisights gives you cross-channel visibility into programmatic display, video, audio, and CTV spend alongside the rest of your paid stack.
At a glance
Authentication | Google OAuth 2.0 |
Permissions needed | Read access to the partners and advertisers you want to connect, plus access to the Display & Video 360 API and DoubleClick Bid Manager API on the authorising Google account |
Account discovery | Automatic — every partner and advertiser the authorising Google user has access to is offered |
Data freshness | Daily (with a 7-day rolling backfill) |
Lookback window | 7 days |
Backfill on connect | Last 7 days; longer historical backfills can be requested via support |
Timezone | Advertiser timezone (as configured in DV360) |
Currency | Advertiser currency (Partner currency also available as a metric) |
Levels supported | Account (Advertiser) · Campaign (Insertion Order) · Ad Group (Line Item) · Ad (Creative) |
Limited rollout | No |
Heads up: Older versions of this article described a mail-based integration in which DV360 emailed scheduled CSV reports to Clarisights. That flow is no longer required. The integration is now fully API-based via Google OAuth — you do not need to schedule offline reports in DV360. If you have an existing mail-based DV360 channel, leave it as-is and contact your CSM to migrate.
Prerequisites
An active DV360 partner or advertiser account on displayvideo.google.com
A Google user that can read the partners and advertisers you want to connect
The Google user must be able to authorise third-party apps for your organisation
Steps to Connect
Step 1 — Open the DV360 integration page in Clarisights
In Clarisights, go to Integrations → DV360 and click Connect. Clarisights redirects you to Google to authenticate.
[TODO: Screenshot needed — Clarisights Integrations page DV360 row with Connect button]
Step 2 — Sign in with Google
Sign in with the Google account that has access to the DV360 partners and advertisers you want to connect.
Step 3 — Authorise Clarisights
Google displays a consent screen listing the access Clarisights needs (read access to Display & Video 360 and DoubleClick Bid Manager). Click Allow.
⚠ "Access blocked: this app is not verified" → Your organisation has restricted third-party app access. Ask your Google Workspace admin to whitelist Clarisights, or use a Google account where the policy is less restrictive.
Step 4 — Select advertisers
After authorisation, Clarisights discovers every partner and advertiser the Google user has access to. Pick the advertisers you want to connect, optionally rename them, and click Create Accounts.
For some partners, DV360 returns
PERMISSION_DENIED. Clarisights skips those partners and continues with the rest — if a specific partner you expected is missing, confirm the Google user has read access at the partner level in DV360.
Verify the connection
Go to Integrations → DV360. Each connected advertiser should show a "Connected" status.
First data appears within 24 hours of the next scheduled sync.
Quick start: create a new report, add DV360 as the data source, and add Account · Campaign · Ad Group · Impressions · Clicks · Media Cost (Advertiser Currency).
Data available
Hierarchy
DV360 has a deeper native hierarchy than the standard Clarisights 4-level model. The mapping below collapses Partner above Advertiser into the Account level (Partner is exposed as Account dimensions), and "DV360 Campaign" sits between Insertion Order and Advertiser as a label dimension on Campaign rather than its own level.
Native level (DV360) | Clarisights level |
Partner | Account (exposed as Partner / Partner ID / Partner Currency / Partner Status dimensions) |
Advertiser | Account |
Campaign | Available as DV360 Campaign / DV360 Campaign ID dimensions on Campaign level |
Insertion Order | Campaign |
Line Item | Ad Group |
Creative | Ad |
Dimensions
Dimension | Level | Description |
Account / Account ID | Account | Advertiser name and ID |
Advertiser Currency | Account | Currency configured on the advertiser |
Advertiser Time Zone | Account | Reporting timezone configured on the advertiser |
Advertiser Status | Account | Active, Paused, etc. |
Advertiser Integration Code | Account | Custom integration code on the advertiser |
Partner / Partner ID | Account | Parent partner name and ID |
Partner Currency / Partner Status | Account | Parent partner currency and status |
DV360 Campaign / DV360 Campaign ID | Campaign | The DV360 "Campaign" object that groups Insertion Orders |
Insertion Order Goal Type / Goal Value | Campaign | Configured optimisation goal on the IO |
Insertion Order Integration Code / Status | Campaign | Custom integration code and status |
Ad Group Budget | Ad Group | Line Item budget |
Ad Group Start Date / End Date | Ad Group | Line Item flight dates |
Ad Group Status / Type | Ad Group | Line Item state and type |
Ad Group Integration Code | Ad Group | Custom integration code on the Line Item |
Ad Width / Height | Ad | Creative dimensions in pixels |
Ad Source / Type / Status | Ad | Creative source, type, and status |
Ad Integration Code | Ad | Custom integration code on the Creative |
Video Ad Duration / Duration (Skippable) | Ad | Duration of video creatives, including skippable variant |
Metrics
Core engagement
Metric | Description |
Impressions | Total ad impressions |
Clicks | Total clicks |
Cost (Advertiser Currency)
Metric | Description |
Media Cost (Advertiser Currency) | Cost of media in advertiser currency |
Billable Cost (Advertiser Currency) | Cost billable to the advertiser |
Total Media Cost (Advertiser Currency) | Total media cost incl. fees |
Refund Media Cost (Advertiser Currency) | Refunded media cost |
Refund Billable Cost (Advertiser Currency) | Refunded billable cost |
Revenue (Advertiser Currency) | Revenue attributed to DV360 in advertiser currency |
Cost (Partner Currency)
Metric | Description |
Media Cost (Partner Currency) | Cost of media in partner currency |
Total Media Cost (Partner Currency) | Total media cost incl. fees, in partner currency |
Revenue (Partner Currency) | Revenue in partner currency |
Conversions
Metric | Description |
Total Conversions | All conversions, all attribution |
Post-Click Conversions | Conversions attributed to the last click |
Post-View Conversions | Conversions attributed to the last impression |
CM Post-Click Revenue / CM Post-View Revenue | Campaign Manager post-click and post-view revenue |
Active View & viewability
Metric | Description |
Active View: Viewable Impressions | Impressions that met Active View viewability criteria |
Active View: 15 sec. cap Impressions / Measurable Impressions | Audible & fully on-screen for half of duration with 15 sec. cap |
Active View: TrueView Impressions / Measurable Impressions | Audible & fully on-screen for half of duration (TrueView) |
Video
Metric | Description |
Complete Views (Video) | 100% complete video views |
First-Quartile / Midpoint / Third-Quartile Views (Video) | Video quartile completion counts |
Audio
Metric | Description |
Complete Listens (Audio) | Listens to 100% of an audio creative |
First-Quartile / Midpoint / Third-Quartile Listens (Audio) | Audio quartile completion counts |
Limitations & known constraints
Partner permissions: For partners where the authorising Google user lacks read access, DV360 returns
PERMISSION_DENIEDand the partner is skipped silently. Confirm partner-level access in DV360 if an expected partner is missing.Reporting delay: Performance data is generally available within 24 hours but can take up to 48 hours to fully reconcile, especially for conversions.
Token revocation: If the authorising Google user revokes Clarisights' access, the integration stops syncing. Re-authenticate from Integrations → DV360.
Schema differences vs. UI: Reporting metric names follow the DV360 reporting API (e.g.,
Media Cost (Advertiser Currency)), which may differ slightly from the DV360 UI labels.YouTube Ads via DV360: YouTube reporting on DV360 is supported through the same API integration; you do not need a separate offline mail report.
Operating notes
Refresh schedule: data is pulled daily.
Lookback: 7 days are re-fetched daily to capture late-arriving conversions.
Adding new advertisers: when a new advertiser is created in DV360, return to Integrations → DV360 in Clarisights to refresh and add it. There is no need to re-authenticate.
Currency conversion: native amounts (advertiser currency by default, partner currency when available) are pulled as-is and converted to your reporting currency by Clarisights.
Credential rotation: OAuth tokens refresh automatically. You only need to re-authenticate if the authorising user changes their Google password or revokes access.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → DV360)
The DV360 advertiser ID (visible in the DV360 URL)
The exact error message or screenshot
The step where the issue occurred
When the issue started