Overview
The Google DV360 connector provides a convenient way of exporting data directly from the Decentriq platform as a first/third-party audience to Google DV360. The dataset should have only one column with SHA256 hashed email addresses. The connector uses the Display & Video 360 API v3, specifically the firstAndThirdPartyAudiences.create endpoint to create audiences.
Prerequisites
- Have a valid Google DV360 advertiser ID.
- Have existing Google DV360 credentials.
- Have an audience to push in Decentriq Datasets
- Note the emails composing the audience to push have to be hashed to be accepted by Google DV 360
In addition to the above, your service account will need:
- Service Account with appropriate permissions: You'll need to create a service account in Google Cloud Console with the necessary roles to access DV360.
- OAuth 2.0 credentials: Your service account will need OAuth 2.0 credentials (client ID and client secret).
- The correct API scope: Specifically for DV360, you'll need
https://www.googleapis.com/auth/display-video
scope. - DV360 user permissions: Your service account needs to be granted specific permissions within DV360:
- It needs to be added to the DV360 account with appropriate access levels
- Most likely Partner-level or Advertiser-level access depending on what you're trying to accomplish
- Private key (JSON format): When setting up your service account, you'll download a JSON key file that contains the private key your application will use for authentication.
- API enablement: You need to enable the Display & Video 360 API in your Google Cloud Console project.
Step-by-step guide
- Follow the steps to select a dataset for export and choose Google DV 360 from the list of connectors.
- Input the requisite information:
- Advertiser ID: The ID of the advertiser under whom the audience will be created.
- Audience name: The name of the audience as it will be displayed in Google DV 360.
- Description: Description of the audience as it will be displayed in Google DV 360.
- Membership duration in days: The duration in days that an entry remains in the audience after the qualifying event. See here for more info.
- Credentials: The service account credentials associated with the service account (see the DV360 API documentation for more details). This takes the form of a JSON file generated when setting up the service account and contains the following information:
- type: Identifies the type of credentials (this will be set to service_account).
- project_id: The ID of your Google Cloud project.
- private_key_id: The identifier for the private key.
- private_key: The actual private key used for authentication - in PEM format.
- client_email: The email address of the service account.
- client_id: A unique identifier for the service account.
- auth_uri: The URL to initiate OAuth2 authentication requests.
- token_uri: The URL to retrieve OAuth2 tokens.
- auth_provider_x509_cert_url: The URL to get Google's public certificates for verifying signatures.
- client_x509_cert_url: The URL to the public certificate for the service account.
- universe_domain: The domain of the API endpoint
- Select the checkbox to consent to sharing the data with Google.
- This is required by Google DV360 when creating first/third-party audiences. Selecting this checkbox gives consent for the following:
- adUserData: Sending user data to Google for advertising purposes.
- adPersonalization: Personalization of ads.
- This is required by Google DV360 when creating first/third-party audiences. Selecting this checkbox gives consent for the following:
Note: For more information about user consent requirements, see the Google Display & Video 360 Help Center.