Configure destinations for DV360

Display & Video 360 (DV360) enables advertising on connected TVs (CTVs), such as Android TV and Chromecast, online video platforms, such as YouTube, along with providing access to a variety of third-party partner exchanges.

What is Display & Video 360?

Display & Video 360 (DV360) is Google’s demand-side platform (DSP) for programmatic advertising. It enables brands and agencies to plan, buy, and measure digital media across display, video, TV, and audio channels–including YouTube and web placements–through a single platform.

DV360 supports two account types:

  • Display Video Advertiser An individual brand or business that runs programmatic campaigns directly within DV360.

  • Display Video Partner An agency, trading desk, or large advertiser that manages programmatic campaigns across many advertiser accounts under a single partner account.

Use Amperity to build high-value audience segments from first-party data, and then send those segments to DV360 to activate them in programmatic advertising campaigns.

Note

This destination uses the Google Audience Partner API .

Changes to audiences are not immediately available in DV360. Allow for up to 48 hours after the point at which Amperity has finished sending audience updates for them to be available.

Get details

Review the following details before configuring credentials for DV360 and before configuring Amperity to send customer profiles to DV360.

Detail 1.

Credential settings

Refresh token

A refresh token is generated by the OAuth process and authorizes Amperity to send data to DV360. The value for the refresh token is automatically updated.

Important

Authentication for “Display Video Advertiser” or “Display Video Partner” must be completed within Google before configuring Amperity to send customer profiles to DV360.

Detail 2.

DV360 configuration

Amperity must be configured as a linked account in DV360 before audience lists can be sent from Amperity to partners or advertisers.

  1. In DV360, open Advertiser Settings, and then select Linked Accounts.

  2. Click Link New Account, and then select External Data Partner.

  3. Select “Amperity” from the dropdown menu, and then click Link.

  4. Confirm Amperity as a linked external data partner, and then click Create Link.

What are advertisers? What are partners?

Display & Video 360 Advertisers

Display & Video 360 Advertisers represent individual businesses that run advertising campaigns.

Use your Advertiser ID to identify the customer ID to which Amperity should send data.

Display & Video 360 Partners

Display & Video 360 Partners represent agencies, trading desks, and large individual advertisers. Multiple advertisers are often grouped under a single partner.

Use your partner ID to identify the customer ID to which Amperity should send data.

After choosing the type of advertising your brand runs on DV360, add your customer ID.

Detail 3.

Review user consent policy

Review the user consent policy for the European Union (EU) and European Economic Area (EEA), and then add the required columns to your orchestration or campaign.

Detail 4.

Required configuration settings

Customer ID

The customer ID for your brand’s DV360 account. This value must be 10 digits and may not contain dashes.

Audience name (Required at orchestration)

The name of the audience in DV360 managed by Amperity. Amperity creates the audience if it does not exist. Audience names may only contain letters, numbers, underscores, dashes, and spaces. Any other characters are automatically removed.

Audience description (Required at orchestration)

A description of the audience managed by Amperity.

Membership duration

The length of time (in days), after which a customer is removed from this audience. This value may be between “0” - “540”. Set this value to “0” to remove all audience members.

To ensure customers stay in this audience ensure the frequency at which Amperity sends the audience to DV360 is less than the membership duration.

Upload key type

The key to use for audience matching in DV360. May be one of “Contact Info”, “Mobile ID”, or “User Id”. The upload key type cannot be changed after an audience is created. To use a different key type, create a new audience.

Mobile app ID

When the value of “Upload key type” is “Mobile ID”, the mobile ID for the iOS or Android app.

Configure credentials

OAuth is an open standard for access delegation, commonly used to grant websites or applications access to information on other websites.

Use OAuth to configure Amperity to send customer profiles to DV360.

Important

OAuth for “Google Customer Match” must be completed within Google before configuring OAuth in Amperity.

To configure OAuth for DV360

Step one.

Open the Destinations tab and click Add Destination. The Add Destination dialog box opens.

Select DV360 from the Plugin dropdown, and then from the Credential dropdown, select Create a new credential.

This opens the Create New Credential dialog box.

Step two.

In the Create New Credential dialog box, click “Generate authorization URL”.

Copy the URL, and then provide the URL to a user who has credentials that allow access to DV360. The user must log in and complete the steps required by the OAuth process for DV360.

After this is completed, you will be redirected to the Credentials page in Amperity.

Verify the credential is on the page, and then return to the Destinations tab.

Step three.

Open the Destinations tab and click Add Destination. The Add Destination dialog box opens.

Select DV360 from the Plugin dropdown, and then from the Credential dropdown, select the credential that is authorized to access DV360.

Note

The value for the Refresh Token setting is updated automatically after you select the credential.

Reauthorize Amperity

You may need to reauthorize access to DV360. This is necessary when an authorization token has expired or when it has been removed by someone with permission to manage access within DV360. To reauthorize access to DV360, follow the steps to configure OAuth and create a new credential.

Add destination

Use a sandbox to configure a destination for DV360. Before promoting your changes, send a sample audience, and then verify the results in DV360. After verifying the end-to-end workflow, push the destination from the sandbox to production.

To add a destination for Display & Video 360

Step one.

Open the Destinations page, select the New destinations button, and then select Orchestration.

Add

To configure a destination for DV360, do one of the following:

  1. Click the row in which DV360 is located. Destinations list alphabetically and you can scroll up and down the list.

  2. Search for DV360. Start typing “google”. The list filters to show only matching destinations. Select “Google Customer Match”.

Step two.

Select the credential for DV360 from the Credential dropdown, and then click Continue.

Tip

Amperity validates the connection when the destination is saved. If the connection cannot be validated, an error is shown and the destination is not saved.

Step three.

In the “Destination settings” dialog box, assign the destination a name and description that ensures other users of Amperity can recognize when to use this destination.

Configure business user access

By default a destination is available to all users who have permission to view personally identifiable information (PII).

Enable the Admin only checkbox to restrict access to only users assigned to the Datagrid Operator and Datagrid Administrator policies.

Enable the PII setting checkbox to allow limited access to PII for this destination.

Use the Restrict PII access policy option to prevent users from viewing data marked as PII anywhere in Amperity and from sending data to downstream workflows.

Step four.

Configure the following settings, and then click “Save”.

Customer ID

The customer ID for your brand’s DV360 account. This value must be 10 digits and may not contain dashes.

Audience name (Required at orchestration)

The name of the audience in DV360 managed by Amperity. Amperity creates the audience if it does not exist. Audience names may only contain letters, numbers, underscores, dashes, and spaces. Any other characters are automatically removed.

Audience description (Required at orchestration)

A description of the audience managed by Amperity.

Membership duration

The length of time (in days), after which a customer is removed from this audience. This value may be between “0” - “540”. Set this value to “0” to remove all audience members.

To ensure customers stay in this audience ensure the frequency at which Amperity sends the audience to DV360 is less than the membership duration.

Upload key type

The key to use for audience matching in DV360. May be one of “Contact Info”, “Mobile ID”, or “User Id”. The upload key type cannot be changed after an audience is created. To use a different key type, create a new audience.

Mobile app ID

When the value of “Upload key type” is “Mobile ID”, the mobile ID for the iOS or Android app.

Step five.

After configuring this destination users may use:

  • Orchestrations to send query results

  • Orchestrations and campaigns to send audiences

  • Orchestrations and campaigns to send events

Step six.

Validate the audience with DV360 by using a sample audience with a very small membership. For example: 10 or 100 members or the minimum audience size recommended by DV360. Send the sample audience to DV360 and verify the sample audience is correct in DV360. Make adjustments if necessary. Only send full audiences after validation is complete.

Google Audience Partner API Matching

DV360 matching can be done through the following list ID types:

Contact Info Matching

Personally identifiable information (PII) is any data that could identify a specific individual. PII data includes details like names, addresses, email addresses, and other profile attributes. PII data sometimes includes attributes like a loyalty number, customer relationship management (CRM) system identifiers, or foreign keys in customer data.

A list can be matched to contact information that has PII data. If a row has a NULL value, it will be automatically filtered out by the connector and is shown in the error logs. Each field should be matched to one of the following columns:

Amperity Column

Google API Key

Description

Email Address

email

For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to lowercase

  • Hashes data as one-way SHA-256

Phone Number

phone

Converts each phone number to E.164 format which represents a phone number as a number up to fifteen digits in length (without spaces) that starts with a + symbol. For example: +12061234567.

For this key, the connector:

  • Trims leading and trailing whitespace

  • Hashes data as one-way SHA-256

Last Name

lastname

For this key, the connector:

  • Trims leading and trailing whitespace

  • Removes spaces in-between

  • Converts to lowercase

  • Hashes data as one-way SHA-256

First Name

firstname

For this key, the connector:

  • Trims leading and trailing whitespace

  • Removes spaces in-between

  • Converts to lowercase

  • Hashes data as one-way SHA-256

ZIP Code

zip

For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to lowercase

Country Code

country

A two-letter country code in ISO 3166-1 alpha-2 format.

For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to upper-case

Mobile Device ID Matching

A list can be matched to mobile device IDs. These may be identifier for advertising (IDFA) or Google advertising IDs (AAID) for mobile devices. If a row has a NULL value, it will be automatically filtered out by the connector and is shown in the error logs.

Amperity Column

Google API Key

Description

Mobile Device ID

mobile-id

A list of mobile device IDs provided to Amperity by the customer. For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to lowercase

  • Retains any hyphens in the mobile device ID