...

...

Follow these three steps to create a bid model: 

1. Create the data model offline 
2. Upload the bid model to S3
3. Upload the bid model to Buzz

For a more information on what fields can be used in a bid model, please see Bid and Delivery Models Fields.

How To Create a Bid Model (offline)

1. The first step is to create the model offline. This can be done by training a model using Beeswax log data, or a different first/third party data source, or any other modeling technique. The bid model consists of 2 files: the manifest file and the prediction file.
   
   
2. Creating the Prediction File: Prediction files are the table that contains the bid model. Prediction files should be kept to a maximum size of 25MB each, and an accumulative maximum size of 100MB per Bid Model, to optimize loading performance and should be in the below format:
   • pipe-delimited ("|") text files
   • no compression
   • first row of each file contains headers
   • at least one bid request key field
   • a required field called "value", which represents either the CPM Bid or Bid Multiplier for that row
   • null values should be left blank
   • an asterisk (*) can optionally be used to match any value (note: a maximum of three wildcard fields are supported)
   • max file size = 25MB
   • Prediction files can only include values that are bids or multipliers
     
     
3. Creating the Manifest File: The manifest file is a .json file with the below format:
   

• The model predictions object includes a list of S3 paths to all prediction files (previous step) associated with this model version. The files live under the following path: s3://beeswax-data-<region>/bid_models/<buzz key>/
• The metadata.fields object contains a list of feature fields that are included in this model version and, optionally, the fields which contain wildcards. 
• A sample manifest can be downloaded here.

How to Upload a Bid Model

1. In order to use a bid model, the files must be uploaded to S3. Please reach out to your support team if you are not set up for this and request access. Instructions on how to access S3 buckets for upload can be found here.
   
   
2. Once access is granted, follow the API documentation to upload the manifest and data files to s3://beeswax-data-<region>/bid_models/<buzz key>/. Regardless of which region you upload the files to, the data will be replicated to each region in which your bidder is live.
   
   
3. File structure is largely flexible, but please note that manifest files must be under the following path: s3://beeswax-data-<region>/bid_models/<buzz key>/customer_manifests/`.
   
   
4. An example file structure would be:

s3://beeswax-data-us-east-1/bid_models/canary/customer_manifests/manifest_20mb.json

How To Create a Bid Model in

...

Beeswax UI

1. Select Create > From Trafficking > Models, click New Model. If creating the model via API, instructions can be found   here. 
   
   
   

2. Complete the following fields in the Overview:
   *Required

   Field Name	Description
   Model ID	An ID associated to the model generated after creation.
   Model Name*	Desired name for the Model.
   Value Type*	CPM Bid Multiplier
   Active	Active or Inactive.
   Alternative ID	Any number or string. Used to map this object to an object in an outside system.
   Notes	Any desired notes about this model.

   Click Save & Continue.
   
   

3. The Model Versions screen will appear to associate a model version with this model. Enter the Manifest S3 Path Enter all the required (marked with asterisk) field values such as Model Name and Value Type; then select Save and Continue.
   In Model Versions, create the first Bid Model Version by entering the Manifest S3 Path  (location of the pre-loaded manifest file) and  a Model Version Name, then click Add Version.
   
   
4. The model will automatically go into PENDING status. This status signifies the version is being validated and prepared to receive traffic. The Status will subsequently change to LIVE or FAILED.
   
   

5. The final step is to associate the bid model with a line item.

   On the

   Under the Modifiers tab during line item

   Overview page, select either Flat CPM or CPC Goal as the Bidding Strategy; the bid model will default to this when there’s no match on the bid model.
   Continue

   creation, an existing bid model may be selected.
   
   

   Info
   Matching Bid Model’s values will be multiplied with Bid Modifier terms.

   
   

6. Click Save & Continue to apply the model to the line item.

   through Targeting and onto Optimization > Bid Modifier view. Select Create New or Choose Existing and set the Max Bid. This value will override the Bid Model and should be used as a control to prevent accidental bidding with an extremely high CPM.
   Fill in all the required fields (marked with an asterisk). 
   Select Save Bid Modifier to continue setting up the line item.