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 connection 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: Enable data deletion requests
Before submitting a request for data deletion, you must first reach out to your account manager to be added to our registry for the IAB framework. You’ll need to submit a domain that will host your dsrdelete.json file.
Once your domain is registered with Google, you should create the 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: Review details for an identifier type
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 |