Notification

Only available in Google Ad Manager 360.

Request first-party data deletion

The data deletion API allows you to request deletion of data associated with first-party identifiers, such as PPID. This API can help you meet your obligations in relation to regional regulatory requirements. The process follows the IAB Data Deletion Request Framework.

Ad Manager, AdSense, and AdMob publishers can request deletion of data associated with the following identifier types:

  • Publisher provided identifiers (PPID) 
  • Publisher first-party identifiers (on web), including IDFV on iOS14+ 

Note that data deletion via the data deletion API is not available for some identifiers, such as AdID.

How it works

The process triggers data deletion for data on Google platforms, including Google Ad Manager, AdSense, and AdMob. Data deletion requests will also be shared to Authorized Buyers, Open Bidders, and SDK Bidders if they have implemented data deletion support. For more information about whether a particular buyer supports data deletion, contact that buyer. 

The high-level request flow for the data deletion API is as follows:

  1. A publisher uses the API to request deletion of a single first-party identifier.
  2. Ad Manager, AdSense, or AdMob receives the request and:
    1. Acknowledges receipt via an Adobe Common JSON Web Token (acJWT).
    2. Deletes the data.
  3. Ad Manager, AdSense, or AdMob forwards the deletion request to buyers who support data deletion. Buyers may acknowledge receipt via an acJWT.

The process results in data deletion on the Google platforms, as well as a request for data deletion to buyers who support data deletion. Transparency is provided through acJWT acknowledgements.

Steps for publishers

Step 1: Create your dsrdelete.json file

To get started, create your dsrdelete.json file and host it at the root of your domain. You can learn more about the dsrdelete.json file, and its required and optional fields, in the IAB documentation.

Step 2: Complete registration with the IAB Tech Lab

Register with the IAB Tech Lab. To do so, visit the IAB Tech Lab Tools Portal and complete the following steps:

  1. Create an account (if you don’t already have one).
  2. Register the URL of your dsrdelete.json file with the IAB data deletion registry.

Step 3: Enable data deletion requests

Next, before submitting a request for data deletion, reach out to your account manager to be added to our registry for the IAB framework. You’ll need to provide the URL that hosts your dsrdelete.json file.

Step 4: Review details for an identifier type

Lastly, for detailed steps to implement the data deletion API, visit the following articles:

For data deletion on  Visit this article
Ad Manager About publisher provided identifiers
Access publisher first-party IDs and delete associated user data
AdSense How AdSense uses cookies
AdMob First-party identifiers and data

Was this helpful?

How can we improve it?
true
Unlock your revenue with personalized tips today!

Visit the Optimization tips for Google Ad Manager page to see personalized suggestions to maximize your revenue.

Unlock now

Search
Clear search
Close search
Main menu
8800922561613871757
true
Search Help Center
false
true
true
true
true
true
148
false
false
false
false
false