Integrations

Google DV360 & Ad Manager
CategoriesAll

Audience

This integration forwards audiences from mParticle to Google Display & Video 360 and Google Ad Manager. Google Display & Video 360 provides end-to-end campaign management for enterprises in one tool — from media planning and creative development to measurement and optimization. Google Ad Manager is a complete platform to grow ad revenue and protect your brand wherever people are watching, playing or engaging.

Prerequisites

In order to use Google DV360 & Ad Manager Audience integration, your Audience Partner account needs to be allowlisted to be able to create DMP lists and upload identities. The next step is to enable Audience Partner API in your cloud project and create your OAuth token, the steps can be found here.

If you need assistance, you can reach out to your Google Technical Account Manager (TAM) or Account Manager (AM) to walk you through the allowlisting process. Create a separate configuration for each Google Product where you`d like to forward your audiences to.

Supported Identities

Email

mParticle sends email addresses to Google as normalized and SHA-256 hashed values.

Phone Numbers

mParticle sends phone numbers to Google as normalized and SHA-256 hashed value. You can use any or all three phone number identities to forward phone numbers.

Device ID

mParticle forwards IDFAs and Google Advertising IDs to Google.

Publisher Provided ID

mParticle forwards PPID when forwarding audience data to Google. In order to send PPID, you must select one of the options from the PPID Identity Type dropdown.

Address Info

mParticle sends Address Info to Google. This data will only be sent if all of the following fields are present:

Google Field mParticle Field Description
hashedFirstName $FirstName First name of the member, which is normalized and SHA-256 hashed by mParticle.
hashedLastName $LastName Last name of the member, which is normalized and SHA-256 hashed by mParticle.
countryCode $Country 2-letter ISO-3166-1 alpha-2 country code.
postalCode $Zip Postal code.

Membership Duration

Google’s user lists have a membership lifespan - that is, a maximum amount of time a member stays on the list without requalifying. Google allows a minimum of 0 and a maximum of 540 days; if not set, the default limit of 365 days is used.

Upload Frequency

The Google DV360 & Ad Manager Audience Integration uses Bulk Forwarding. Bulk Forwarding means that, instead of uploading updates to an audience in real time, mParticle compiles updates into a queue until either a given amount of time has passed since the last upload, or until a certain number of updates are waiting to be sent.

By default, mParticle uploads to Google whenever at least one of the following conditions is met:

  • 12 hours have passed since the last update.
  • The total queued messages exceeds 100000.

Upload frequency can sometimes be adjusted. Contact to your mParticle Customer Success Manager if you need to discuss upload frequency.

Configuration Settings

Setting Name Data Type Default Value Description
Client ID string Google OAuth2 Client ID to generate access tokens.
Client Secret string Google OAuth2 Client Secret to generate access tokens.
Refresh Token string Google OAuth2 Refresh token to generate access tokens.
Client Customer ID string Account number of the Google product where you would like to forward audience data.
Product Type string Ad Manager The Google product where you would like to forward audience data.
Login Customer ID string Your Audience Partner account ID.
Linked Customer ID string Id of the account that is directly linked to your Audience Partner account.
Linked Customer Product Type string Ad Manager The Google product associated with the Linked Customer Id.

Connection Settings

Setting Name Data Type Default Value Description
Membership Lifespan int 365 The number of days that users remain as part of an audience list after they’re added. A minimum of 0 and a maximum of 540 days are accepted; if not set, the default limit of 365 is used.
PPID Identity Type string Set the mParticle User Identity type to be forwarded to Google as the Publisher Provided ID (PPID).

Was this page helpful?