With categories, you can organize your audience data, which makes it easier to search for, filter, and manage audiences. You can create your custom categories according to your needs. Often, data owners develop their own categories in addition to the IAB taxonomy, which represent the unique characteristics of the data they sell.
With the Category section of the Data Management Platform API, you can create, update, and delete categories, retrieve a list of all categories, retrieve categories by data provider, and retrieve categories available for specific data users.
Once you create at least one custom category, you can map your audiences to them using the Segments section of the Data Management Platform API.
To start working with Category section of the Data Management Platform API, you need:
-
Adform DMP user account that has these permissions assigned:
-
Manage DMP Entities
-
-
The following scopes assigned to your OAuth client by Adform Support (dmp@adform.com):
-
https://api.adform.com/scope/dmp.categories: Grants access to the Category section of the Data Management Platform API.
-
https://api.adform.com/scope/dmp.categories.readonly: Grants read-only access to the Category section of the Data Management Platform API.
-
-
The following IDs to use in your requests:
Note
Additional IDs might be used, but the listed ones are required to pass a request.
Note
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.
Tip
See examples of how to create and delete categories, and retrieve categories based on a DMP account in DMP Postman collection.