An audience is a consumer segment differentiated by specific demographics, interests, or other characteristics. With a specific audience, you can target the right users with the right ad at the right time and on the right device.
Note
Before onboarding data, you must create an audience to receive it. You must also create a custom category that you can assign the audience to.
With the Segment section of the Data Management Platform API, you can search for and create new audiences, retrieve audiences based on their taxonomy or their DMP account, and update or delete audiences.
To work with audiences, you need category ID, data provider, and advertiser (data consumer) IDs to use in your requests. You must use these IDs to search for and retrieve specific audiences. In addition, use the category ID to map your audiences to specific categories.
Tip
To learn about DMP API structure, see Learn About Data Management Platform APIs.
To start working with Segment 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.segments: Grants access to the Segment section of the Data Management Platform API.
-
-
The following IDs to use in your requests:
-
Data consumer ID (Advertiser ID in DSP and Ad Server, Publisher ID in Publisher Ad Server)
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, update, and delete audiences, and retrieve audiences based on a DMP account in DMP Postman collection.