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 allpublishers on agiven admin network*, use thepublishers endpoint. (Refer to the account_id field returned.) Speak to your account managerto obtain the list ofadmin networksthat 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 itscpc_modification to 0.5:
site-specific bid = 0.8 x 0.5 = 0.4
To apply a newboost of -12.5%, set it'scpc_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 thesite-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.