Use * syntax for faster search

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column
width45%


Panel
borderColor#004b8d
borderWidth2
borderStylesolid

In this article:

Table of Contents
maxLevel3
stylenone



Column
width55%


Column
width55%

UI Button
colorpurple
newWindowtrue
titleView FreeWheel Academy Instructional Video
urlhttps://academy.freewheel.com/learn/course/1068/play/4855:184/trafficking-a-line-item-in-beeswax

UI Button
colorblue
newWindowtrue
titleNot Registered for the FreeWheel Academy?
urlhttps://hub.freewheel.tv/category/academy



...

Overview

Line items are act as the actual workhorse engine of the Campaign. These campaign that are configured with different targeting criteria to help an ad reach the right viewer. This page will review the process of creating a new line item.


...

Creating a Line Item

  1. Start by navigating to TraffickingLine Items, and selecting "New Line Item" on the top right of the list view.

  2. A window will open asking to define certain criteria for the Line Itemline item. These fields include:
    *Required

    Field NameDefinition
    Advertiser*Select an Advertiser advertiser to associate this Line Item line item to.
    Campaign*Select a Campaign campaign for this Line Item line item to operate under.
    Line Item Name*This should should correspond with the purpose of this Line Item. I.e." Banner for xyz.com"as a freeform field allowing for line item naming in accordance with your taxonomy requirements.
    Line Item Type*Line item type can be either Banner, Video, or Native. The selected type will only allow creatives with that file type to run on this line Item. For example, a banner creative may only run on a Line Item with "Banner" selected as the Line Item Type. Mobile campaigns can be set up as either “video” or “banner” depending on the creative format being used.
    Programmatic Guaranteed"Yes" or "No" toggle. A Programmatic Guaranteed line item will have a guaranteed revenue outcome. must be used when targeting a Programmatic Guaranteed deal.


    Section



  3. Next, Once the fields are completed, click Create & Continue for the creation screen will appear. Alternatively, click the dropdown arrow next to create & continue displaying the options to Create & Close or Create & Start Another.


Below are the

...

available screens with their corresponding fields

...

needed to complete the

...

line item creation process. 


...

General Tab

Essential Settings

These The essential settings are important in defining the key components of the Line Item line item activity behavior.

*Required

Field NameDescription
Start Date*When this Line Item line item will begin being eligible to serve.
End DateWhen this Line Item line item will no longer be eligible to serve.
Budget Type*Budget types at the Line Item line item level can be of type “Spend” (dollar amount) or “Impressions” (number of impressions). Line Item budget types do not have to item budgets must be the same as Campaign budget typesthe budget used in the campaign that houses the line item.
Budget*Overall budget of the Line Itemline item. The budget of an individual Line Item line item can not exceed the Campaign campaign budget.
Daily BudgetDaily budget cap of the Line Itemline item. Daily budget must is recommended to be high enough to allow entire budget to spend over the dates of the Line Itemline item.
Bidding Strategy*

Bidding strategy to use for this Line Itemline item. A Line Item line item can only have one Bidding bidding strategy . Either - Flat CPM, CPC Goal, VCR Goal , or CPA Goal. Learn more about Bidding Strategies.

Note

When selecting CPA Goal (Cost Per Acquisition) bidding strategy, a conversion event (Creating an Event Tag) must be created prior. The event pixel must have at least 1,000 Beeswax-attributed conversions within the last 30 days to be used in the CPA bidding strategy. Learn more about CPA here.


Pacing*Determines how your budget is spent through the life of the campaign. Can be Daily, Lifetime, Flight, or None
Pacing Behavior* (Will display when a Pacing option has been chosen).

Pacing behavior determines the rate at which the budget is spent. Options include:

  • Even - This pacing will evenly distribute the budget during the lifetime, day, or flight duration. This type is best for those who want to spend the same amount of money during the campaign duration and the inventory is consistent. Even is the default setting chosen.

  • Ahead - Attempts to spend slightly faster than Even. This option is best for those who's main goal is to avoid any risk of under-delivery.
Multiplier* (Will display when a Pacing option has been chosen).Multiplier enables control over spending speed. For example, setting it to 1.5 will spend 150% of the allocated target amount. Enter a numerical value in this field.
Catchup Behavior* (Will display when a Pacing option has been chosen).

Catchup behavior determines how the pacemaker responds when the budget delivery falls behind and inventory becomes suddenly available at a certain point. Options include:

  • Immediate - When inventory becomes available, it will try to use all spend immediately to catchup.

  • Even - Will evenly catchup to the desired spend rate.

  • Smooth - Will spend slightly more in the beginning when the inventory is available and gradually catchup with the target spend rate.
CPM Bid* (Available when using CPM bidding strategy)This is the bid amount for the line item.

Bid Shading (Fees Apply)

(Available when using CPM bidding strategy)

By enabling Bid Shading, the CPM bid in first price auction environments will be reduced in order to generate savings while minimizing reductions in the win rate. A fee will be applied on the savings rate.
Bid Shading Control (Available when using CPM bidding strategy)Choose either Normal, Less Aggressive, or More Aggressive.
eCPC Target* (Available when using CPC Goal)The target effective Cost per Click.
Max CPM Bid* (Available when using CPC Goal)The maximum amount to bid.
CPA Target* (Available when using CPA Goal)CPA performance goal; displayed numerically.
CPA Event* (Available when using CPA Goal)This strategy will determine bid amounts based on historical performance of the event and help optimize line items towards goals.
Max Bid* (Available when using CPA Goal)The maximum amount to bid.
Use Custom Bidding AgentToggle "Yes" or "No" to activate a custom bidding agent.
Alternative IDA separately created ID that may be used for outside reporting purposes.
NotesFree text field to apply notes relevant to the line item.

...

Include A Shared Block
shared-block-keyFlights
pageLine-Item Flights

Frequency Cap

Info

Up to three frequency caps are allowed at the line item level. Frequency caps are also available to set at the line item level.


When trafficking a Line Item, users have line item, there is the option of setting a Frequency Cap to restrict the number of times a particular ad will be shown to a particular user. Frequency is typically determined by the ID found in the bidRequest.user.buyeruserID or device.ifa openRTB fields, which correspond to the Beeswax Standard uses the Beeswax cookie ID on web traffic, and the mobile device ID on in-app traffic. Additionally, Beeswax has optional support for enhanced frequency capping on IP Address, IDFV, proprietary customer IDs, and cross device IDs.

Field NameDescription
ID Type

Select the level of ID for which the frequency cap will be applied:

  • Standard
  • IP Adress
  • Customer ID
  • Person ID
  • Household ID
Info

When selecting either Person ID or Household ID, an option will appear to select a cross-device vendor. Dropdown options will appear with either Person or Household vendor depending on ID type selection.


Use Fallback"Yes" or "No" toggle. Learn more about fallback here.
Add Another Frequency CapAdd additional lines of frequency cap settings to configure the ads per number of time periods (day, hour, minute, or week). Adding the Frequency CapConfigure how many ads may display every certain time period for this Line Item.

Vendor Fees

Be sure to account for any vendor fees that may be associated to this line item. Fees may include FreeWheel Identity Network, or other data providers.

Multiexcerpt
MultiExcerptNamevendor


Field NameDescription
IDOnce a Vendor Fee is applied, an ID will be created for it.
VendorSelect the vendor associated with this fee via dropdown. If an inactive vendor is selected, an error message will display when moving to the next screen.
Vendor Fee NameAssociate a free-text field name for this Fee.
Fee TypeOptions include: Default, Custom CPM, Custom Percent.
Fee AmountAdjust the fee amount that will be allocated to this Line Item.


...

Note

To associate an Event, the event must be set to allow only selected Line Items line items for attribution.

Events without whitelabled assignments will automatically track conversion for all line items under the advertisers.

If an event has been created on the Accountaccount, it will be selectable to apply to this Line Itemline item. To learn more, see Events

...

On a line item, there is an option set a Revenue value, which can be used to report on the revenue made from running a given Campaign campaign. Profit margin is then able to be calculated by subtracting the spend from the Revenue.  

Revenue is calculated according to one of four calculations:

  1. CPM Basis - Cost Per Mille
  2. CPC - Cost Per Click. 
  3. CPCV - Cost Per Complete ViewCompleted video
  4. CPA/CPI - Cost Per Acquisition/Installation

Once the Revenue Type is selected, apply a numerical currency figure in the Revenue Amount field.

Learn more about Revenue.


...

Targeting

...

Info

To learn more about Modifiers, please see Delivery Modifiers and Bid Modifiers.

Bid Modifier

*Required

Field NameDefinition
Name*Name the modifier to be relevant to the certain modifier terms selected. I.e. Language Modifier
Advertiser*Select an Advertiser via dropdown to associate the modifier to. Modifiers can be applied to the account level, or to an Advertiser.
Bid ModelMatching Bid Model’s values will be multiplied with Bid Modifier terms. Learn more about Bid Models.
Max Bid*Final bid prices will be capped at this value.
Min BidFinal bid prices will be floored at this value.
Alternative IDSeparately created ID for use of external reporting purposes.
NotesAny desired notes about this modifier.
Add Bid Modifier TermsHere is where multiple targeting fields may be selected and applied to the Modifier.


Delivery Modifier

*Required

Field NameDescription
Name*Name the modifier to be relevant to the certain modifier terms selected. I.e. Language Modifier
Advertiser*Select an Advertiser advertiser via dropdown to associate the modifier to. Modifiers can be applied to the account level, or to an Advertiseradvertiser.
Modifier TypeModify with either terms or model. Choosing terms will allow a manual selection of Targeting targeting requirements. A Delivery Model can be used in place of Modifier Terms, and requires choosing a Delivery Model and Fallback Weight. Learn more about Delivery Models.
Delivery Model* (Available when selecting "With Model" as Modifier Type)A Delivery Model can be used in place of Modifier Terms. See more here.
Fallback Weight* (Available when selecting "With Model" as Modifier Type)

For every Delivery Modifier, a Fallback Weight value is required, which will be the weight that is associated with any auctions that matched targeting but do not necessarily match a row in the model or delivery modifier terms (similar to a Default Bid for Bid Models and Modifiers). It is recommended to set the default to 1 in order to fulfill the budget. The Fallback Weight Value can be set as "0" to ensure auctions outside of the model/modifier terms will not be bid on, but doing this may increase the likelihood of under-delivery.

NotesAny desired notes about this modifier.
Alternative IDSeparately created ID for use of external reporting purposes.
Add Delivery Modifier Terms

Here is where multiple targeting fields may be selected and applied to the Modifiermodifier.

...

...

Creative Association

...

Bid Modifiers:

  • Bid Modifier
  • Max bid
  • Min bid

Delivery Modifiers:

  • Delivery Modifier
  • Fallback weight

Apply changes by clicking "Save and close" for the creatives to update.

Creative Association

Here is where the association of a creative to a line item occurs. See, Creatives to learn more.

Column NameDescription
Creative Name & IDDisplays the name and ID applied to the creative.
Association IDID of this specific association used for reporting
Creative ThumbnailThumbnail uploaded representing the creative.
Creative StatusEither Active or Inactive status for the creative association.
Association WeightWeight is used to control the relative likelihood that a given creative is chosen when one or more creatives matches and the Creative Weighting Method is 'Weighted'. Best practice is for the weights of all creatives of a single format/size to add up to 100.
Creative Start DateStarting date for eligibility of this creative to serve.
Creative End DateEnd date for eligibility of this creative to serve.
Association Start DateStart date for when this creative may be associated to the given line item.
Association End DateEnd date for when this creative may be associated to the given line item.

...

The summary tab will show an overview of the selected settings for the created line item. There is an option to save Essential Settings as a Line Item Preset, which will be a selectable grouping of settings able to be applied to a future created line item.

Analytics

The Analytics tab displays two charts, Real Time Stats and Bid Decision Flow graphs. These charts display information about the line item to better help understand its performance.

Real Time Stats

The stats here are represented in both a "Bids and Wins" chart, which shows a real time numerical count of both bids and wins on the given line item, and a "Spend" chart that displays Budget, Total Spend, and Incremental Spend. For a historical view on these numbers, there is a "Lookback Range" dropdown that will adjust the charts to anywhere from the last 1-72 hours. Be sure to click Refresh to view the most recent and relevant data.

Bid Decision Flow

A number of factors can contribute to why a line item may not be bidding. Given the multitude of permutations for setting up and optimizing line items in Beeswax, it can be difficult to narrow down the cause of delivery issues. Bid Decision Flow is a diagnostic tool for troubleshooting line item performance that provides a graph of the auction data being sent to the customer’s bidder and visualizes how the bidding system chose to respond to auctions within a given lookback window. This lookback range may be adjust between 1-72 hours, similarly to Real Time Stats. To learn more, see Bid Decision Flow.


...

Activity Log

This log is a view of different changes an or activity that has been done to this selected Line Itemline item. See the table below for the viewable fields:

...