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:
- A publisher uses the API to request deletion of a single first-party identifier.
- Ad Manager, AdSense, or AdMob receives the request and:
- Acknowledges receipt via an Adobe Common JSON Web Token (acJWT).
- Deletes the data.
- 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:
- Create an account (if you don’t already have one).
- Register the URL of your
dsrdelete.jsonfile 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 |