Overview
Line items are the actual workhorse of the Campaign. These are configured with different targeting criteria to help an ad reach the right viewer.
Creating a Line Item
- Start by navigating to Trafficking > Line Items, and selecting "New Line Item".
A window will open asking to define certain criteria for the Line Item. These fields include:
Field Name Definition Advertiser Select an Advertiser to associate this Line Item to. Campaign Select a Campaign for this 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" 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. - Next, the creation screen will appear. Below are the three tabs with their corresponding fields that will help complete the Line Item creation process.
General Tab
Essential Settings
These settings are important in defining the key components of the Line Item activity behavior.
| Field Name | Description |
|---|---|
| Start Date | When this Line Item will begin being eligible to serve. |
| End Date | When this Line Item will no longer be eligible to serve. |
| Budget Type | Budget types at the Line Item level can be of type “Spend” (dollar amount) or “Impressions” (number of impressions). Line Item budget types do not have to be the same as Campaign budget types. |
| Budget | Overall budget of the Line Item. The budget of an individual Line Item can not exceed the Campaign budget. |
| Daily Budget | Daily budget cap of the Line Item. Daily budget must be high enough to allow entire budget to spend over the dates of the Line Item. |
| Bidding Strategy | Bidding strategy to use for this Line Item. A Line Item can only have one Bidding strategy. Either Flat CPM, CPC, Goal, or CPA Goal. Learn more about Bidding Strategies. 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. |
| Custom Bidding Agent | Toggle "Yes" or "No" to activate a custom bidding agent. |
| Alternative ID | A separately created ID that may be used for outside reporting purposes. |
| Notes | Free text field to apply notes relevant to the line item. |
Flights
Line item flights allow for granular control over the timing of line item delivery. Flights can strictly control delivery time frames, and can each have their own budget. The budget type is inherited from the line item and total budget of all flights cannot exceed the line item’s budget.
Creating a Line Item Flight
Start by navigating to Line Items > click line item name > click General tab. From this screen, complete the essential settings section and then select Flights.
From the General tab, there will be an option to choose the pacing for the flight once the bidding strategy has been selected on the line item. Pacing is a required field for the flight.
Once pacing is selected, a view will expand that displays the line item flight information:
To get started, choose a 'budget carry over' setting. See below for an explanation of the selectable options from this dropdown:
For any of the three options, once the flight is over by 12 hours, the un-used budget on the flight will be allocated to future flights based on the carry-over type selected:
None: Selected by default. No budget will carry over to the next flight. Additionally, you will be able to set a planned budget of custom or spend all.
Add To next flight: Add all the remaining budget to the next available flight’s budget.
Distribute evenly: Any remaining budget will be distributed evenly to current and future flights. Each flight will receive the same amount of budget.
Prorated by length: The remaining budget will be distributed prorated to the length of each future flight, meaning the longer flight will receive more carried-over budget than a shorter flight.
- Next, fill out the flight's table information below the Budget Carry Over dropdown.
- Enter a flight name.
- Select a start and end date (Required).
Enter a planned budget amount (Required).
Review the Approximate Post Flight Remaining budget below the 'End Date' field. This number takes the amount of budget from the line item and subtracts what is spent from your flights. Ensure the remaining budget is not negative.
A planned budget can be either: Custom or Spend All. Only a budget carry over of type none will allow you to choose spend all.
- There will be an option to create another flight from this screen. Once done creating flights, select Save and Continue to finish setting up the line item.
Flight Summary
Once flight is completed, select the summary tab and navigate to Essential Settings within the line item to view the flight's settings.
- View the budget carry over selection and flights that have been set up.
- To edit/view a flight, select that flight to be redirected to the general tab.
Flight Quick Stats
Flight quick stats will enhance the data insights offered when working with flights. This includes the following:
Budget Information
- Planned Budget
- Planned budget means the budget planned to spend for that individual flight.
- Planned budget means the budget planned to spend for that individual flight.
Carryover Budget
- Carry over will display the carry over amount from the previous flight(s).
- Carry over will display the carry over amount from the previous flight(s).
Total Flight
- Total Flight Budget will show the sum of planned budget and budget carry over column.
Analytics
- Spend
- The spend column will show the total amount spent for that flight.
- The spend column will show the total amount spent for that flight.
- Impressions
- The impressions will show the total amount of impressions for that flight.
- The impressions will show the total amount of impressions for that flight.
- OSI
- The on schedule indicator for that flight.
Rules for Flights
- Line Item Flights are validated to assure that both the time intervals and budgets make logical sense:
- Two flights within the same Line Item cannot have overlapping date ranges.
- Flights cannot start before the Line Item start_date.
- Flights cannot end after the Line Item end_date.
- The total budget of all flights cannot exceed the budget of the Line Item.
Frequency Cap
When trafficking a Line Item, users have 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 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 Name | Description |
|---|---|
| ID Type | Select the level of ID for which the frequency cap will be applied:
|
| Use Fallback | "Yes" or "No" toggle. |
| Adding the Frequency Cap | Configure 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.Field Name Description Vendor Select the Vendor associated with this fee via dropdown. Vendor Fee Name Associate a free-text field name for this Fee. Fee Type Options include: Default, Custom CPM, Custom Percent. Fee Amount Adjust the fee amount that will be allocated to this Line Item.
To associate an Event, the event must be set to allow only selected Line Items for attribution
If an event has been created on the Account, it will be selectable to apply to this Line Item. To learn more, see Events
Revenue
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. Profit margin is then able to be calculated by subtracting the spend from the Revenue.
Revenue is calculated according to one of four calculations:
- CPM - Cost Per Mille
- CPC - Cost Per Click.
- CPCV - Cost Per Complete View
- CPA/CPI - Cost Per Acquisition/Installation
Learn more about Revenue.
Targeting
The targeting tab helps define certain targeting requirements so that the ad gets displayed to the correct audience.
Modifiers
To learn more about Modifiers, please see Delivery Modifiers and Bid Modifiers.
Bid Modifier
| Field Name | Definition |
|---|---|
| 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 Model | Matching 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 Bid | Final bid prices will be floored at this value. |
| Alternative ID | Separately created ID for use of external reporting purposes. |
| Notes | Any desired notes about this modifier. |
| Add Bid Modifier Terms | Here is where multiple targeting fields may be selected and applied to the Modifier. |
Delivery Modifier
| Field Name | Description |
|---|---|
| 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. |
| Modifier Type | Modify with either Terms or Model. Choosing terms will allow a manual selection of 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. |
| Notes | Any desired notes about this modifier. |
| Alternative ID | Separately 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 Modifier. |
Bulk Edit Modifiers
To bulk edit Modifiers, select the checkbox next to the desired line items for Modifier bulk edit. Next, a button will appear at the bottom of the screen called "Bulk Edit". Select the button and click "Creative Association". The following screen will allow users to edit the following fields below:
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 Name | Description |
|---|---|
| Creative Name & ID | Displays the name and ID applied to the creative. |
| Association ID | ID of this specific association used for reporting |
| Creative Thumbnail | Thumbnail uploaded representing the creative. |
| Creative Status | Either Active or Inactive. |
| Association Weight | Weight 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 Date | Starting date for eligibility of this creative to serve. |
| Creative End Date | End date for eligibility of this creative to serve. |
| Association Start Date | Start date for when this creative may be associated to the given line item. |
| Association End Date | End date for when this creative may be associated to the given line item. |
Summary
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 activity that has been done to this selected Line Item. See the table below for the viewable fields:
| Column Name | Description |
|---|---|
| Log ID | An associated Log ID to the specific activity. |
| Category | The location of the change within the Campaign settings. |
| Field | Which field in the Campaign settings that was altered. |
| Added | Any settings added. |
| Removed | Any settings removed |
| Action | Options include: Update, Create, Delete. |
| Date & Time | Date & Time of the activity. |
| User & ID | The User & ID of the user who made the Change. |
| Review & Restore | Restore a previous version of this activity to be applied to the Campaign. |