Yahoo DataX Connector Setup Guide

Yahoo DataX is an aggregate Yahoo Ad Tech infrastructure that hosts various components that enable Yahoo Ad Tech to exchange data with its external partners in a secure, automated, and scalable manner. Through this integration, Tealium customers can exchange structured data against user identifiers, such as cookies, user-matched IDs, etc.

API Information

This connector uses the following vendor API:

• API Name: Yahoo API
• API Version: v1
• API Endpoint: https://datax.yahooapis.com
• Documentation: Yahoo API

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 10000
• Max time since oldest request: 60 minutes
• Max size of requests: 100 MB

Connector Actions

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

When configuring the Yahoo DataX connector, you will be prompted with an End User Licensing Agreement (EULA) that must be accepted before continuing with the configuration. At the bottom of the window, you can download the agreement for legal review. Redlines are not accepted on the EULA.

In the Connector Configuration section, perform the following steps:

1. Enter a name for this connector configuration and any optional notes for the connector.

2. Under the Authentication section, set Environment to Production.

   This value must always be set to Production, unless a Yahoo or Tealium representative instructs you to change it.

3. Select the GDPR mode that will be assigned to the segments.

The data that is sent to Yahoo must have the appropriate segment created within a Yahoo-hosted taxonomy file.

If you are implementing this connector for the first time, perform the following steps:

1. Click New Taxonomy Segments.
2. On the Create New Taxonomy Segments screen, enter your Yahoo MDM Number to add it to the taxonomy branch.
   • If multiple users are being added, separate those entries with a comma.
3. Enter a name for the segment your audience data is being sent to. We recommend that this segment name match the Tealium audience name.
4. (Optional) Enter a Description.
5. Click Create Account (Profile) Segment.
   • This adds three nodes to the taxonomy file: your Tealium account name, Tealium profile name, and the audience segment that receives the data.

If you have already created an account and profile segment for the taxonomy file (by setting up a different YahooX connector on your Tealium profile), perform the following steps:

1. Click Add Audience to Taxonomy.

2. Enter an audience name.

3. (Optional) Enter a Description.

4. Click Add Audience.

   Yahoo’s process for setting up taxonomy segments can take up to 45 minutes. If you begin sending data during this window, it will not be accepted and will give an error because the segments do not yet exist in Yahoo.

5. Click Done when you are finished configuring the connector.

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter a name for the action and then select the action type from the drop-down list.

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

Yahoo keeps the user data in their segment for only 30 days, at which point users need to be re-sent through the DataX connector. Tealium recommends performing Audience Sizing to capture the active visitors for the audience and then creating a job for the audience to send that data to Yahoo so Yahoo maintains the data in their segment.

Action — Add User to Segment

Parameters

Action — Opt Out

Parameters