DoubleClick for Publishers (DFP) Connector Setup Guide

[#1]

This article describes how to set up the DoubleClick for Publishers (DFP) connector in your Customer Data Hub account.

Before you use this connector you must request that Google add your account to their whitelist. This allows Tealium AudienceStream to create segments in your Google account.
Learn more about how to request that Tealium be whitelisted for your Google products.

In this article:

• Connector Actions
• API Information
• Configure Settings
• Create a New Segment
• Action Settings - Parameters and Options
• Action - Add Visitor to User-List or Segment
• Action - Remove Visitor from User-List or Segment

Connector Actions

Action Name	AudienceStream	EventStream
Add Visitor to User-List or Segment	✓	✓
Remove Visitor from User-List or Segment	✓	✓

API Information

This connector uses the following vendor API:

• API Name: Google Audience Partner API DmpUserListService
• API Version: v201809
• API Endpoint: https://ddp.googleapis.com/
• Documentation: Google Ad Manager API

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

When you add this connector you are prompted to accept the vendor's data platform policy.

After adding the connector, configure the following settings:

• Client Customer ID
  • Required
  • Your (DoubleClick Customer) Identifier in the selected Product.

Create a New Segment

Use the following steps to create a new segment in AudienceStream:

1. Click Create a New Segment from the top of the Actions selection drop-down screen.
2. Enter the following fields:
   • Segment Name
   • Segment Member Lifespan
   • Integration Code - Integration Code is an ID used by user list sellers to correlate IDs on their systems. If no ID is available, enter a random number between 1 and 1000.
   • Segment Description.
     
3. Click Create Segment.
   Upon success, a check mark displays next to the Create Segment button.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Add Visitor to User-List or Segment

User segments created outside of the whitelisted connector will not be available in the connector configuration. Only segments created by the connector after your account has been whitelisted can be used.

Parameters

Parameter	Description
Select the Target User-list/Segment	Required User map identifier. Specifies the user that this operation applies to. This is the target User-list/Segment where the user will be added to.
Google User ID	Google User ID Provided by the ADX cookie-matching service.
iOS Advertising ID	iOS Advertising ID
Android Advertising ID	Android Advertising ID
RIDA	Roku ID
AFAI	Amazon Fire TV ID
MSAI	Xbox/Microsoft ID
Data Source ID	Optional An ID indicating the data source that contributed this membership. Required to be in the range of 1 to 1,000. Any ID greater than 1,000 results in a BAD_DATA_SOURCE_ID error. These IDs do not have reference or meaning for Google and are only used as labels for reporting purposes.

Action - Remove Visitor from User-List or Segment

User segments created outside of the whitelisted connector will not be available in the connector configuration. Only segments created by the connector after your account has been whitelisted can be used.

Parameters

Parameter	Description
Select the Target User-list/Segment	Required, this is the target User-list/Segment where the user will be removed from.
Google User ID	Google User ID Provided by the ADX cookie-matching service.
iOS Advertising ID	iOS Advertising ID
Android Advertising ID	Android Advertising ID
RIDA	Roku ID
AFAI	Amazon Fire TV ID
MSAI	Xbox/Microsoft ID
Data Source ID	Optional An ID indicating the data source that contributed this membership. Required to be in the range of 1 to 1,000. Any ID greater than 1,000 results in a BAD_DATA_SOURCE_ID error. These IDs do not have reference or meaning for Google and are only used as labels for reporting purposes.