'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 allpublishers on a
    given 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.