Cookie Mapping¶

Parameter Names¶

• gdpr - use this to pass EU user consent:

  • true - Europe audience data. Data provider indicates that the data is subject to GDPR regulations.

  • false - Rest of the world. Data provider indicates that the data is not subject to GDPR regulations.

  • empty - DataX will handle the jurisdiction flag as true and process the data applying GDPR regulations.

• gdpr_euconsent - use this to include user consent attributes (using IAB Purpose bit descriptions):

  • Storage and Access of Information - the storage of information, or access to information that is already stored, on user device such as accessing advertising identifiers and/or other device identifiers, and/or using cookies or similar technologies.

  • Personalization - the collection and processing of information about user of a site to subsequently personalise advertising for them in other contexts, i.e., on other sites or apps, over time. Typically, the content of the site or app is used to make inferences about user interests, which inform future selections.

Notes¶

• The gdpr value must be included (true or false) at the time of the pixel fire.

  • false - data provider indicates that the data is not subject to GDPR regulations.

  • true - data provider indicates that the data is subject to GDPR regulations.

  • empty - UPS cookie sync pixel will decide the user’s jurisdiction based on the user’s IP address and stored profile.

• gdpr_euconsent GDPR user-consent string. Required if the gdpr parameter is set to 1 or true.

• Parameter values are case-insensitive.

• If gdpr and gdpr_euconsent parameters ARE NOT included as part of the UPS cookie sync pixel.

  • Yahoo will look at the user’s IP address and store the profile to retrieve jurisdiction and consent status.

  • Yahoo will drop all EU-based identified users and process all others.

UPS Cookie Sync¶

The Yahoo UPS cookie sync enables data partners to initiate a cookie sync and receive a unique encrypted Yahoo cookie ID (AXID). This encrypted ID will then be used to post cookie data via Yahoo’s DataX API.

Partner requirements:

• Yahoo developer APP ID.

• Preferred endpoint for Yahoo to use as the redirect described below.

• Expose Yahoo’s cookie sync to high volumes of your traffic for at least 3-4 weeks prior to integration completion.

Workflow¶

The workflow is illustrated in the mapping table shown below:

The sequence is as follows:

1. A web browser visits the site with a Yahoo cookie sync. The web browser requests a cookie sync pixel.

2. The Yahoo UPS server responds with a redirect to partner cookie sync. The Yahoo cookie id (AXID) is appended to the partner url (for example. user_id=123).

3. A web browser requests the partner cookie sync. The partner pixel server records the mapping between the Yahoo id / partner id and responds.

Optional Workflow¶

As an alternative to the workflow described above, the Yahoo cookie sync can also be configured to store the mapping table on the Yahoo side, as illustrated in the mapping table shown below:

The optional sequence is as follows:

1. A web browser visits the site with a Yahoo cookie sync. The web browser requests a cookie sync pixel with the partner cookie id appended to the url (for example, _hosted_id=abc).

2. Yahoo stores the mapping between the Yahoo id / partner on receipt of the request. In return, the Yahoo UPS server response can be configured to either:

• Respond with a redirect to the partner cookie sync and the Yahoo cookie id (AXID) is appended to the partner url (for example, user_id=123).

• Alternatively, the Yahoo UPS server can perform a 204 (success, no content) instead of a 302 with AXID. This saves an additional redirect/request if the partner has no use for it.

3. (optional): The web browser requests the partner cookie sync.

Pixel¶

The following table describes the pixel parameters for the Yahoo UPS cookie sync pixel. Note that GDPR flags are required.

Pixel URL:

https://ups.analytics.yahoo.com/ups/####/cms?partner_id=******&gdpr=1&gdpr_consent=....[&_hosted_id={user_id}]

Response¶

The Yahoo cookie sync pixel will perform a 302 redirect to the configured partner endpoint.

An example redirect URL: Redirect:

https://pixel.partner.com/partner/pixel?user_id=####&gdpr=1&gdpr_consent=....