Understanding Yahoo Opt-Outs in Narrative

Overview

Yahoo’s Opt-Out feature allows you to remove user identifiers (for example, PXIDs) from any ad targeting and measurement activities within Yahoo DSP. In Narrative, you can manage these opt-outs by designating a dataset containing the user IDs you wish to exclude. Once configured, the Yahoo Connector automatically sends these opt-outs to Yahoo’s Opt-Out API, which processes them within approximately 24 hours.

This article explains:

1. What a Yahoo Opt-Out dataset is and why you need one
2. How to create and map a dataset for opt-outs
3. How to configure the opt-out dataset in Narrative’s Yahoo Connector
4. What happens after your opt-out request is submitted

For additional details, see Yahoo’s official documentation:
Data Opt-Out | Yahoo Help

1. What Is a Yahoo Opt‐Out Dataset?

A Yahoo Opt‐Out dataset is a specialized collection of user identifiers representing individuals who should be excluded (“opted out”) from Yahoo DSP targeting and/or measurement. For example, if a user revokes consent for data collection or requests not to be targeted by certain campaigns, their ID belongs in this dataset.

Key points:

• Supported identifier types include PXIDs (common in Yahoo DSP), emails, and others that Yahoo supports.
• Once these identifiers are processed, Yahoo ensures they are removed from audience targeting and measurement.

2. Creating and Mapping a Dataset for Opt‐Outs

Before you can configure an opt‐out dataset in Narrative’s Yahoo Connector, you will need to create a dataset that:

1. Contains only the user identifiers to be opted out (PXIDs, email addresses, etc.).
2. Matches the schema of the Narrative attribute tied to the opted-out identifier. To create this schema, upload a dataset with the opt-ed out identifiers, map the dataset to the opted out identifier's attribute(s) (to learn more about mappings check out this dataset details article), then materialize a dataset by selecting the attributes in Data Studio. Make sure the materialized dataset has an ongoing refresh schedule that matches the cadence in which you plan on uploading opt-ed out identifier.
3. Is kept up to date whenever new opt‐out requests come in.

To create a dataset within Narrative:

1. Go to My Data
2. Then Datasets
3. Select New Dataset

3. Configuring the Opt‐Out Dataset in the Yahoo Connector

Once you have a valid opt‐out dataset, you can connect it to Yahoo DSP via Narrative’s Yahoo Connector:

1. In Narrative, navigate to Yahoo DSP Connector.
2. Click the Opt Out Configuration tab at the top.
3. Click + Connect opt out dataset.
4. Select the dataset you created or identified for opt‐outs from the drop‐down list.
5. Click Create to finalize the connection.

That’s it! Narrative will now recognize this dataset as your source of user IDs to be removed from Yahoo DSP.

4. After Submitting Your Opt‐Out Request

Once an opt‐out dataset is connected, Narrative automatically:

• Processes the IDs in your dataset and forwards them to Yahoo’s Opt‐Out API.
• Enqueues a status check to confirm when Yahoo has completed removal of those IDs.

Within ~24 hours, Yahoo will remove those IDs from:

• Active targeting: Yahoo DSP will no longer match or serve ads to these users.
• Measurement: These users will also be removed from Yahoo’s in-house mapping tables used for measurement.

Frequently Asked Questions (FAQ)

1. Can I use multiple opt‐out datasets?
Yes. However, each dataset must be mapped to a Yahoo‐supported identifier type. You can configure multiple connections if needed.

2. What if some IDs in my opt‐out dataset are invalid?
Yahoo’s Opt‐Out API will ignore any IDs that are invalid or do not match Yahoo’s identifier format. Valid IDs will still be processed.

3. Can I reverse the opt‐out once submitted?
Opt‐outs are typically considered final. If a user changes their preferences, you would remove them from the opt‐out dataset and work with Yahoo DSP/Narrative to re-target or re-measure those IDs.

Further Assistance

• Yahoo Documentation: Data Opt-Out | Yahoo Help
• Narrative Support: Contact your Narrative representative or open a support ticket if you need additional help configuring opt-outs.