First-party data can be useful when creating a campaign's retargeting strategy. Companies often first-party data from the website traffic, customer data, ad-serving data, or data from customer data platforms (CDPs) and customer relationship management platforms (CRMs). Your customers provide this data in online or offline interactions, such as interactions with ads, websites, apps, or from filling out surveys or reviews.
If you have an Adform DSP account, you can use your first-party data to create audiences to target in your programmatic campaigns. You can use your own first-party data to add users that meet specific criteria to your audience, or you can use data from a third-party platform. This way you can build unique and reusable audiences for different campaigns.
Note
To start using the Audience Manager, request that your account administrator enables it for your account.
For more information about creating, managing, and activating your audiences in DSP, see Learn About Audience Manager.
With Audience Management API, you can create, update, retrieve, and delete audiences. You can also retrieve the categories to assign to the audiences that you create.
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 audiences, Adform DSP user account must have this permissions assigned by the business account admin:
-
Manage Audiences
Depending on your objectives and workflow, you'll need some or all of the following scopes assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/buyer.audiences: Grants access to Audience Management API. -
https://api.adform.com/scope/buyer.advertisers: Grants access to Advertisers Management API.
To create audiences with API, use the following ID in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the category for the new audience |
Categories section of Audience Management API |
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:
-
GET endpoints in the Categories section of Audience Management API: To retrieve the list of available categories. You need to assign a category to the audience you create.
-
(Optional) GET endpoint in the Advertisers Management API: To retrieve the list of advertisers. You can define which advertisers will have access to the audience. If you don't define this, all advertisers will have access.
-
(Optional) If you're creating an audience with data from your third-party partner, retrieve the third-party audience ID from that partner's platform. If it's not relevant to you, you can enter any ID when creating an audience (see step 4).
-
POST endpoint in the Audiences section of Audience Management API: To create an audience.
To target the audiences you created with API (or with Audience Manager functionality in the Adform FLOW), you need to retrieve the created audiences using the Audiences section of Audience Management API. You can then set up audience targeting when you create a programmatic line item.
Note
The GET endpoint in Audiences section returns all created audiences, including inactive ones. You can target only active audiences when you create line items.