There are a few ways in which you can approach this and it will depend on your preference. This process is the same for when you need to map a client for Adform.
Contact your account manager at Adform and ask them to extract the list of existing media names and media IDs (for example like this: "uuid": "4ab1f13c-7744-e711-9406-00155d168a00, "name": "Ad Gallery"). Once you have the list you can either do the mapping yourself or ask our team for assistance.
Extract the list yourself using a 3rd party API application. You will need the client ID and client secret from Adform in order to do this - so reach out to them for this information first. In the example below we will show you how to do this yourself using Postman (https://www.getpostman.com/downloads/ - download the app based on your operating system).
1. Create a collection and authenticate yourself
Open up Postman and select 'New' from the top left hand corner. From the options available select 'Collection'. A pop-up box will appear, all you need to do is enter in a name and create - Adform could be an example name to use.
Next step is to make a new request. You can either do this by clicking on the new button again located top left corner or by clicking on the link underneath the collection.
Give the new request a name - this should be called 'Authenticate'.
- This request needs to be a POST and the endpoint should be https://id.adform.com/sts/connect/token
- Select 'body' from the sub menu tab and enter in the grant_type, client_id and client_secret
- The scope needs to have the following:
https://api.adform.com/scope/eapi https://api.adform.com/scope/buyer.advertisers https://api.adform.com/scope/buyer.campaigns.api https://api.adform.com/scope/buyer.direct.lineitems https://api.adform.com/scope/buyer.media.readonly
- Click on the send button (located top right corner)
Within the bottom body section you will see an access token being generated. That piece of code will be needed as part of the new request that will be generated in order to GET the advertiser ids. Simply copy the code contained within the "" after "access_token":
2. Get media IDs
Create a new request and call it 'Media Ids'.
The request needs to be a GET with the following endpoint: https://api.adform.com/v1/buyer/media?active=true&limit=500&fields=name,uuid
You will need to select 'headers' from the sub menu (located underneath the endpoint URL) and under the key column 'Authorization' select the within the value column where is says 'Bearer' and paste the access token code next to the word 'Bearer'.
Then click on the 'send' button located top right corner. From within the bottom section in the body the data will appear and should look similar to this:
You provide Adslot support team with the client ID and client secret and the team will assist with the mapping the requirements for you. The team will collaborate with you on the media ID mappings and assist with any testing - such as trafficking.