To ensure that your programmatic line item delivers effectively, you need to specify its targeting settings. You can choose to target based on geography, technology, contextual, or audience criteria.
With the following APIs, you can prepare different types of targeting setups:
-
Device and cookie ID Lists section of the RTB Line Items Setup API: Upload a list of device and cookie IDs.
-
IP Range Lists section of the RTB Line Items Setup API: Upload a list of IP ranges.
-
Campaigns V2 section of the Campaigns Management API: Retrieve information about the contextual targeting setup and update it.
-
Segments section of the Data Management Platform API: Retrieve the list audience IDs.
To retrieve the list of third-party audience IDs, contact the third-party provider directly or find them in Adform Data Management Platform.
-
Classifiers API: Retrieve criteria for technology and geography targeting.
To prepare a targeting setup, you must use an advertiser ID and a user ID in your requests. Use the advertiser ID to assign the new campaign to a specific advertiser in order to define the place of your campaign in your account. Use user ID to specify the general and scheduling settings for your campaign.
Tip
To learn about Adform DSP and Ad Server API structure and use cases, see Learn About DSP and Ad Server APIs.
With the above APIs, you retrieve the lists of targeting characteristics, which you can then assign them to the programmatic line items using RTB Line Items Setup API.
To start working with targeting-related APIs, you need:
-
Adform DSP user account that has these permissions assigned:
-
Manage Campaigns & Orders
-
Manage Programmatic Line Items
-
-
The following scopes assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/integrations.classifiers.readonly: Grants read-only access to the endpoints of the Classifiers API.
-
https://api.adform.com/scope/buyer.rtb.lineitem: Grants access to all endpoints of the RTB Line Items Setup API.
-
https://api.adform.com/scope/buyer.campaigns.api.readonly: Grants read-only access to some endpoints of the Campaigns API.
-
https://api.adform.com/scope/dmp.segments: Grants access to all endpoints of the Segments section of the Data Management Platform API.
-
https://api.adform.com/scope/dmp.segments.readonly: Grants read-only access to some endpoints of the Segments 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.