Models

Overview

Models are used to configure Buyer Cloud's bidding strategy and delivery distribution.

A model is associated with either a bid modifier or delivery modifier as a more powerful alternative to manually creating multiple bid or delivery modifier terms.

As new models are created, the model will have model version objects associated with it, and the user may choose which version is the "live" version.

Models have three different value types (shown in the value_type field):

  • BUDGET_WEIGHT (delivery model): Allocates a campaign or line item's budget to spend certain percentages of the budget on specific inventory based on relative weights. This does not impact bid prices; instead, it dynamically moves budget to ensure target spend categories are reached.
  • BID (bid model): Sets a specific CPM bid to send when the bid request matches the set parameters in a row of the bid model.
  • MULTIPLIER (bid model): Each row in the model is a multiplier applied to the bid value when the parameter in the row matches.

Use the Models API to accomplish the following tasks:

  • List all models
  • List all model versions
  • Retrieve a model version using its ID
  • Create a model
  • Retrieve, update, partially update, or reset the upload status of a model using its ID
  • Retrieve model versions for a model ID

Uniform Resource Identifiers (URI)

URI
https://{buzz_key}.api.beeswax.com/rest/v2/models