'Bid Modifier Per Publisher' Object

The Publisher Bid Modifier Object stores an array of these in its values property.

Fields

Property/Field_Name

Modifiers and Defaults

Type

Description

target

Required

String

The account_id of the publisher (aka site) to which the bid modifier should be applied.

Note:

For a list of all publishers on a given admin network, use the publishers endpoint. (Refer to the account_id field returned.) Speak to your account manager to obtain the list of admin networks that are applicable for your campaigns.

For a list of publishers (sites) on which your campaigns have previously run, use the Campaign Summary Report, with the site_breakdown dimension. Refer to the site field in that report. (The site field is the publisher account_id.)

cpc_modification

Required

Double
Must be between values 0.011 - 2.0
(CPC boost must be between -99% and 100%)

Min/Max cpc_modification values:

0.011 - apply a boost of -99% (Min)
2.0 - apply a boost of +100% (Max)

Example:

Campaign-level cpc = 0.8

To apply a boost of -50% for demo-site-1, set its cpc_modification to 0.5:
site-specific bid = 0.8 x 0.5 = 0.4

To apply a new boost of -12.5%, set it's cpc_modification to 0.875:
site-specific bid = 0.8 x 0.875 = 0.7

To apply a new boost of +12.5%, set it's cpc_modification to 1.125:
site-specific bid = 0.8 x 1.125= 0.9

At all times, the campaign-level cpc remains unchanged (0.8)

Notes:

  • cpc_modification is publisher-specific and has no effect on the campaign-level cpc.
  • Modifiers are not accumulative. The modifier most recently submitted for that publisher is applied against the campaign-level cpc.
  • Aside from the min/max values for boost (above), the API also enforces a min/max value for the resulting bid - see Get list of Minimum CPC values.

🚧

Minimum CPC

For each campaign, Taboola Backstage enforces a minimum CPC.

As of July 8, the minimum CPC is also enforced for site-level bids:

  • The system compares the site-level bid to the allowed minimum and uses the higher of the 2.

  • This is the bid amount that will be used in auctions, and the value that will be charged for a click.

For more detail, see: Get list of Minimum CPC values

📘

Field Name

For future extensibility, the field property is called target. The target property expects a publisher account_id.

📘

See

Patching Collections for an overview.
Patch a Collection for examples and restrictions.