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"}]
To streamline your audience creation, you can upload a template with your entire taxonomy to Adform DMP, including both IAB taxonomy and custom categories. You can also download the uploaded files to update them and then upload the taxonomy again. With this, you can ensure that your categories and audiences always are up to date.
Tip
For more information about creating taxonomies in bulk, see Manage Taxonomy.
With taxonomy upload and download, you can create your audiences in bulk and prepare them to receive audience data. After you have your taxonomy available in Adform DMP, you can start onboarding data to populate your audiences.
With the Taxonomy section of the Data Management Platform API, you can upload your own taxonomy to create your audiences, and download or delete the uploaded taxonomy files. With the Category, Segment, and Unified Taxonomy sections of the Data Management Platform API, you can retrieve the categories and audiences you already created, and standard IAB categories to use in your taxonomy.
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 bulk create audiences, 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.segments: Grants access to the Segment section of the Data Management Platform API. -
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.dataproviders: Grants access to the Taxonomy section of the Data Management Platform API. -
http://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 bulk create audiences with API, use the following ID in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the data provider account to which the audience belongs |
DataProvider section in Data Management Platform API |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
You can bulk create all your categories and audiences with a single taxonomy upload. If you already have a category and an audience created, you can retrieve them to include in your taxonomy file.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To bulk create audiences with API, use these endpoints:
-
(Optional) GET endpoints in Category section of Data Management Platform API: To retrieve the existing custom categories to use in your taxonomy file.
-
(Optional) GET endpoints in Segments section of Data Management Platform API: To retrieve the existing audiences to use in your taxonomy file.
-
GET endpoint in UnifiedTaxonomy section of Data Management Platform API: To retrieve a list of IAB categories to use in your taxonomy file.
-
Use this template to prepare your taxonomy file.
-
POST endpoint in Taxonomy section of Data Management Platform API: To upload your taxonomy file.
After you've created your audiences, you can continue onboarding audience data using API or through a server-to-server transfer.
[{"api":"Data Management Platform","titles":"Category, Segment, Taxonomy, UnifiedTaxonomy"}]
After creating an audience, you can add complex rules for the data sources that you want to collect user information from. Using audience building rules, you can define the criteria a unique user ID (UUID) has to meet to be added to an audience, in this way creating unique and effective target audiences for your campaigns.
Tip
For more information about defining criteria for building audiences, see Build Audiences.
Note
When creating audiences, clients should ensure that the underlying data has been lawfully collected and may be used for the intended purpose. Audience creation involving demographic information, geolocation, behavioral targeting, or similar attributes should comply with applicable privacy laws, contractual restrictions, and Adform policies, including any restrictions relating to sensitive categories of personal data.
You can define building segmentation rules to fit the specific needs of your campaign. For example, you can narrow down an audience by demographics or geolocation, or retarget visitors who have shown interest in a specific product but haven't purchased it yet.
Important
You need specific access to use the audience builder. For more information, contact DMP Support (dmp@adform.com).
With the Segmentation Rule section of the Data Management Platform API, you can create new audience building rules and retrieve, update, or delete existing rules.
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 build complex audiences, 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.segments: Grants access to the Segment section of the Data Management Platform API. -
https://api.adform.com/scope/dmp.segmentbuilder: Grants access to the Segmentation Rule 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 build complex audiences with API, use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the data provider account to which the audience belongs |
DataProvider section in Data Management Platform API |
|
|
Specify the audience to assign audience segmentation rules to |
Provided as part of response body after retrieving an audience (see step 1 in Workflow) |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
After you've created an audience, you can add audience building rules to build complex audiences.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To build complex audiences with API, use these endpoints:
-
GET endpoints in Segments section of Data Management Platform API: To retrieve audiences to assign audience building rules to.
-
POST endpoint in Segmentation Rule section of Data Management Platform API: To create a building rule for the audience.
After you've added a building rule to your audience, your DMP account will start to populate that audience with unique user IDs matching that rule. You can then create additional rules and target that audience in your programmatic line items or share it with advertisers.
[{"api":"Data Management Platform","titles":"Segment, SegmentationRule"}]
To populate your audience with unique user IDs, you can create complex rules to automate audience data collection, or you can manually upload third-party cookies, mobile advertising IDs (MAIDs), or first-party IDs. You can use the onboarded audience data to run quick tests with the audience. For example, you can test an audience with a new partner. You can also generate a report on a set of users from another system.
Tip
For more information about when and how to manually onboard audience data, see Manually Upload and Download Audiences.
Note
Clients may upload only audience data that has been lawfully collected and for which they have the necessary rights and permissions to process and share with Adform. Where required by applicable law, valid consent or other applicable legal requirements must be satisfied before audience data is onboarded. Use of the API remains subject to the Adform DMP Audience Policies and applicable contractual documentation.
Use the onboarded audience data to populate the audience that you've created. This means that when you're uploading the IDs, you must specify the audience where you want to onboard data.
With the Cookie section of the Data Management Platform API, you can upload audience data and assign it to a specific data provider and audience ID. You can also retrieve IDs from a specific audience.
Tip
You can automate the audience import process by establishing a server-to-server transfer.
Here are the guidelines for an effective audience data upload:
-
Upload the list of IDs in .csv format.
-
Upload a maximum of 4 files at a time. File size can't exceed 100 MB.
-
Use the following structure in every row of the uploaded file:
{ID}{tab_separator}{SegmentOwnerID1},{SegmentOwnerID2},{SegmentOwnerIDn} -
Specify at least one audience, but you may specify more. Every row in the file assigns a user ID, such as a cookie, mobile, or first-party ID, to one or more audiences. After uploading the file, the IDs are added to the specified audience.
-
Create one file for each type of ID. For example, have one file for Adform cookies, one for MAIDs, and another for first-party IDs. An audience may have different types of IDs in it.
Note
Importing third-party cookies requires an ID sync between the partner and Adform. For information about synchronizing IDs, contact DMP Support (dmp@adform.com).
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 onboard audience data, Adform DMP user account must have this permission assigned by the business account admin:
-
Manage DMP Entities
You also need the following scope assigned to your OAuth client by Adform Support (dmp@adform.com):
-
https://api.adform.com/scope/dmp.segments: Grants access to the Cookie and UserIdentityType sections of 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 onboard audience data with API, use the following ID in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the data provider's account to which to upload the audience data |
DataProvider section in Data Management Platform API |
|
|
Specify the audience data type (Adform cookie, external cookie, advertising ID, or first-party ID) |
Provided as part of response body after (see step 1 in Workflow) |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
To onboard the data, you must first create an audience. In the in the data upload file, you must then define the owner ID of that audience.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To onboard audience data with API, use this endpoint:
-
GET endpoint in UserIdentityType section of Data Management Platform API: To retrieve the list of possible audience data types.
-
POST endpoint in Cookie section of Data Management Platform API: To upload the file with audience data to a specific data provider.