Manage Floor Prices With API

Solveiga
Solveiga
  • Updated

You can use pricing rules to set floor prices for your inventory in open programmatic auctions and manage pricing during real-time bidding (RTB). You can also set custom pricing for specific deals based on inventory, demand, or timing. With pricing rules, you can control revenue and apply differentiated pricing across your inventory.

Tip

For more information about pricing rules, see Guide to Inventory Pricing Rules and Guide to Deal Pricing Rules.

After you've set up your inventory, deals (if needed), and targeting rules, you need to set up pricing rules. With pricing rules, you can set floor prices for your inventory or specific deals.

With Pricing Rules API, you can create, retrieve, update, and delete pricing rules.

Authentication

To authenticate and use Adform APIs, your user account must have the necessary permissions and your OAuth client must have the required scopes assigned to it.

To set up and manage targeting and pricing rules, Adform SSP user account must have these permissions assigned by the user account admin:

  • View RTB Rules

  • Manage RTB Rules

You also need the following scope assigned to your OAuth client by Adform Support:

  • https://api.adform.com/scope/api.pricingrules: Grants access to Pricing Rules API.

Tip

If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.

Prerequisites

To set up and manage pricing rules, use the following IDs in your requests:

ID

Used To

Retrieve From

ruleId

Specify the deal pricing rule to update, retrieve its information, or delete

Provided as id in the initial response body after creating a deal pricing rule or as ruleId in subsequent requests (see step 1 in workflow)

pricingRuleId

Specify the inventory pricing rule to update, retrieve its information, or delete

Provided as id in the initial response body after creating an inventory pricing rule or as pricingRuleId in subsequent requests (see step 1 in workflow)

inventorySourceId

Specify the inventory source that a publisher, placement, or deal is using

To get the ID, contact Adform Publishers Support (publishers@adform.com)

Note

Inventory source ID is your Adform SSP account ID and is sent after Adform creates your SSP account.

inventoryRuleId

Specify the placement or publisher targeting rule to apply the pricing for

Targeting Rule API

dealRuleId

Specify the deal targeting rule to apply the pricing for

Targeting Rule API

demandRuleId

Specify the advertiser targeting rule to apply the pricing for

Targeting Rule API

schedulerRuleId

Specify the scheduling targeting rule to apply the pricing for

Targeting Rule API

Note

Additional IDs might be used, but the listed ones are required to pass a request.

Workflow

After you've set up targeting rules, you can continue with creating pricing rules.

Tip

To learn how to use Adform APIs, read Guide to Using Adform APIs.

To create and manage pricing rules with API, use these endpoints:

  1. POST endpoints in Deal Pricing Rule and Pricing Rule sections of Pricing Rules API: To create a new pricing rule.

  2. (Optional) GET endpoints in Deal Pricing Rule and Pricing Rule sections of Pricing Rules API: To retrieve a specific pricing rule or a list of all pricing rules.

  3. (Optional) PUT endpoints in Deal Pricing Rule and Pricing Rule sections of Pricing Rules API: To update a pricing rule.

  4. (Optional) DELETE endpoints in Deal Pricing Rule and Pricing Rule sections of Pricing Rules API: To delete a pricing rule.

Endpoints

[{"api":"Pricing Rules","titles":"Deal Pricing Rule API, Pricing Rule API"}]

Pricing Rules

Was this article helpful?

/
How can we make it better?

Thank you for your feedback!