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.
To create a programmatic line item, you must define the inventory settings for your campaign to run in. You can choose to target specific ad exchanges, deals, apps, domains, and inventory sources.
With the following inventory-related APIs, you can prepare your own inventory setup:
-
Inventory Marketplace API: Use to create lists of or retrieve specific ad exchanges, deals, apps, domains, or inventory sources and the relevant bid stream data.
-
RTB Targeting Lists API: Use to create or retrieve programmatic line item targeting 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/buyer.marketplace.inventories.readonly: Grants read-only access to all endpoints of the Inventory Marketplace 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.