An audience is a consumer segment differentiated by specific demographics, interests, or other characteristics. Audiences are classified into categories to help you organize your data and make it easier to search for, filter, and manage audiences. In Adform, you can create custom categories according to your needs. You also need to assign IAB taxonomy to your audiences for a more standard categorization.
Tip
For more information about audiences, see Create and Manage Audiences.
For more information about custom and standard categories, see Manage Taxonomy.
Targeting a specific audience can help advertisers reach their campaign goals, for example, increasing brand recognition and trust, driving conversions, or fostering customer loyalty. To ensure that advertisers can find your audiences, you must create custom categories and assign IAB taxonomy to your audiences. Custom categories help define the unique characteristics of your data, while IAB taxonomy makes the audience easy to discover and target.
With the Category and Segment sections of the Data Management Platform API, you can create, retrieve, update, and delete categories and audiences. With the Unified Taxonomy section of the Data Management Platform API, you can retrieve the standard IAB categories to assign them to your audiences.
To authenticate and use Adform APIs, your user account must have the necessary permissions and your OAuth client must have the required scopes assigned to it.
To create an audience, Adform DMP user account must have this permission assigned by the business account admin:
-
Manage DMP Entities
You also need 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.segments: Grants access to the Segment section of the Data Management Platform API. -
https://api.adform.com/scope/dmp.authenticated: Grants access to the Unified Taxonomy section of the Data Management Platform API.
Tip
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.
To create an audience with API, use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the data provider's account to which the audience belongs |
DataProvider section in Data Management Platform API |
|
|
Specify the buy-side or sell-side account that'll be using the audience. Provide Agency ID for DSP and Ad Server account, or Publisher ID for Publisher Ad Server account. |
DataConsumer section in Data Management Platform API |
|
|
Specify the category to which the audience belongs |
Provided as part of response body after creating a category (see step 1 in Workflow) |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To create an audience with API, use these endpoints:
-
POST endpoint in Category section of Data Management Platform API: To create a custom category to assign the audience to.
-
GET endpoint in UnifiedTaxonomy section of Data Management Platform API: To retrieve a list of IAB categories to assign to the audience.
-
POST endpoint in Segments section of Data Management Platform API: To create an audience and assign custom and IAB categories.
After you've created an audience, you can continue onboarding audience data using API or through a server-to-server transfer. You can also bulk create all your audiences before proceeding to onboard data.
Tip
See examples of how to create, update, and delete categories, and retrieve audiences based on a DMP account in DMP Postman collection.
[{"api":"Data Management Platform","titles":"Category, Segment, UnifiedTaxonomy"}]