Skip to content
Clarisights Knowledge Center home
InboxAsk a human

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_DENIED and 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