Skip to main content

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

  1. Follow the steps to select a dataset for export and choose Google DV 360 from the list of connectors.
  2. 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.

Note: For more information about user consent requirements, see the Google Display & Video 360 Help Center.