You can manually upload third-party cookies, mobile advertising IDs (MAIDs), or first-party IDs to populate an audience. To onboard the IDs, you must specify the DMP account and the audiences you have created and want to onboard data to.
See the guidelines for effective upload:
-
You can upload the list of IDs in a .txt or .csv format.
-
We recommend that the file size doesn't exceed 100 MB.
-
You can upload 4 files at a time.
-
Every row in the uploaded file must have the following structure:
{ID}{tab_separator}{SegmentOwnerID1},{SegmentOwnerID2},{SegmentOwnerIDn} -
Every row in the file assigns a user ID, such as a cookie, mobile, or first-party ID, to one or more audiences. You must specify at least one audience, but you may specify more. After importing the file, those IDs are added to the specified audience.
-
We recommend creating 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).
Tip
You can automate the audience import process by establishing a server-to-server transfer.
To start working with Cookie section of the Data Management Platform API, you need:
-
Adform DMP user account that has these permissions assigned:
-
View DMP Entities
-
-
The following scopes assigned to your OAuth client by Adform Support (dmp@adform.com):
-
https://api.adform.com/scope/dmp.segments: Grants full access to the Cookie section of the Data Management Platform API.
-
https://api.adform.com/scope/dmp.segments.readonly: Grants read-only access to some endpoints of the Cookie 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.