Inventory is a set of digital advertising spaces — entire platforms and specific placements — that you, as an advertiser, can buy. In the inventory setup, you can define the feasible supply sources for your campaigns to target:
-
Which SSPs & Ad Exchanges (Adform supply partners) you want to work with.
-
Which publishers, or types of publishers, are relevant to you.
-
Which of their ad spaces (placements) work best for your campaign type.
Important
Each inventory has its own set of rules for campaigns and ads. By selecting an inventory source, you accept its terms and conditions. You can't use ads that violate these terms and conditions. You're responsible for any violations of these rules.
When you create a programmatic line item, you specify the settings that define the inventory for your campaign to run in.
With the following inventory-related APIs, you can prepare your own inventory setup:
-
Inventories Search API: Use to search for specific deals or inventory sources.
-
Mobile Apps Search API: Use to retrieve lists of apps, supported app categories, or stores.
-
RTB Targeting Lists API: Use to retrieve lists of all or specific apps or domains.
With the above APIs, you retrieve the lists of inventory sources, apps, websites, or deals, which you can then assign them to the programmatic line items using RTB Line Items Setup API.
To start working with inventory-related APIs, you need:
-
Adform DSP user account that has these permissions assigned:
-
Manage Programmatic Line Items
-
Manage Campaigns & Orders
-
-
The following scopes assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/marketplace.inventory.search.api: Grants access to all endpoints of the Inventories Search API.
-
https://api.adform.com/scope/mobile.apps.readonly: Grants read-only access to all endpoints of the Mobile Apps Search API.
-
https://api.adform.com/scope/buyer.rtb.targetinglists: Grants access to all endpoints of the inventories RTB Targeting Lists API.
-
Note
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.