Bid Modifier and Delivery Modifier Terms

Like Targeting Modules, Buzz allows you to create lists of criteria for Bid Modifiers and Delivery Modifiers according to various targeting modules and keys. For example, you can indicate that when the browser is Safari the bid should be multiplied by 1.5.

A list of valid keys and values can be found in this Google Sheet. Note that these keys do not fully match the List of Targeting Modules and Keys as some keys are only available for Modifiers and Models while others are only available for targeting.

A JSON object of Terms is an element of a POST or PUT to the bid_modifier endpoint or the delivery_modifier endpoint.

Modifier Terms JSON

Modifier Terms are expressed as a JSON list of objects. Each object must contain the following fields:

Field	Description	Notes
`targeting_module`	The targeting module, e.g. `geo`
`targeting_key`	The targeting key within the module, e.g. `country`
`modifier_type`	The matching method for the modifier, default is `INCLUDE`	See explanation below
`value`	The value to match, e.g. `USA`	Must always be a string, even if value is an integer or array
`modifier`	Amount to apply to the modifier. For Bid Modifiers this will be the multiplier, for Delivery Models this will be the relative weight of delivery.	Min=0 (don't bid) Max = 10
`field_label`	Human readable label for the field. Automatically added to the Terms.	Cannot be set by the user.

An example of a Bid Modifier Term list is shown below:

[
  {
		"targeting_module": "geo",
		"targeting_key": "country",
		"value": "USA",
		"modifier": 0.8,
		"modifier_type": "include",
		"field_label": "USA"
  },
	{
		"targeting_module": "geo",
		"targeting_key": "country",
		"value": "CAN",
		"modifier": 2.3,
		"modifier_type": "include",
		"field_label": "CAN"
	},
	{
		"targeting_module": "platform",
		"targeting_key": "browser",
		"value": "Safari",
		"modifier": 1.3,
		"modifier_type": "include",
		"field_label": "Safari Browser"
	}
]

Modifier Types

There are four modifier_types associated with any Modifier Term. These types determine how the modifier is matched with a bid request. Note, although exclude is available as a targeting criteria, it is not allowed for modification since it would never match.

Modifier Type	Matching Logic	Notes
include	Targeting criteria much match the `value` field exactly.	Default modifier type
include_range	Targeting criteria must be within range of values, for example a start and end time	Only available on `time` and `ip_address` targeting modules.
boolean	The `value` field is passed as a string in a boolean expression	Only available for segment targeting
dynamic	The multiplier provided in the Modifier Term is a default, the actual modifier is provided by the association of the user and the segment or the custom list item.	Available for segment targeting as well as all Custom Lists types.

Row Limits

Delivery Modifiers are limited to 100 rows of terms. Bid Modifiers are limited to 1,000 rows.