Use * syntax for faster search

Versions Compared

Key

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

...

Column
width50%


Panel
borderColor#c8c8c8
borderWidth1
borderStylesolid

Table of Contents

Table of Contents
maxLevel2
indent20px
stylenone

Section

Overview

A Line Item is the workhorse of the Buzz system. It corresponds to a given buying activity, usually defined by a set of targeting criteria.

Create Line Item

To create a new line item:

...



...

Overview

Multiexcerpt
MultiExcerptNamelineitem

After creating a Campaign and assigning an advertiser, the next step in the trafficking workflow is to create line items to associate with a campaign. A line item serves the specific purpose of controlling buying activity and targeting criteria. The performance of a line item can also be tracked using the Reporting tool by selecting the "Line Item ID" dimension in the report scope.

The line item is important for successful campaign delivery and requires efficient setup. To learn how to correctly set up a line item, please refer to Create a Line Item.


...

Accessing Line Items Page

To access the Line Items page, navigate to Trafficking > Line Items at the top of the screen in Beeswax. Alternatively, line items can be accessed by clicking the pill next to the campaign or advertiser name on their respective list views.


...

Line Items List View

To view features available while in list view, see List View Features.

Info

The list view fields are default columns. To manage and edit these columns, click the kebob on the top right of the list view and click Manage Columns.

Image Added

List View Fields

Column NameDescription
Name & IDName and associated ID for the created line item.
CreativesDisplays the number of associated creatives with the given line item. Clicking this field will navigate users to the Creative Association tab under line item settings.
StatusEither "Active" or "Inactive".
Delivery Status

Current status of line item performance. Options include:

  • Winning
  • Not Winning
  • Not Bidding
Type

Displays how the line item was set up to deliver the creative. Options include:

  • Banner
  • Video
  • Native
  • Audio 
Budget

Total budget and remaining budget for the line item.

Info

The bottom number displayed in green is the remaining budget.


Start/End DateStart and end dates for the line item flight.

OSI (On Schedule Indicator)

(Scroll right to view in UI)

Displays what percentage of spend has been used throughout the line item's flight. Also included is a percentage of spend and amount of days left on the flight.

Today Spend

(Scroll right to view in UI)

Amount spent for the line item on the day of viewing.

Lifetime Spend

(Scroll right to view in UI)

Amount spent over the course of the line item's flight.


Quick Filters

While in the line item list view, quick filters are available to apply on the left side of the screen. These filters will control which line items are displayed on the list view. Available filters are found below:

Filter NameDescription
ActiveFilters to display active line items only.
WinningFilters to display line items with a delivery status of "Winning", meaning the line item is winning bids.
Not WinningFilters to display line items with a delivery status of "Not Winning", meaning the line item is not winning bids.
Not BiddingFilters to display line items with a delivery status of "Not Bidding".
Spent TodayFilters to display line items that have spent on day of viewing.

Under Pacing

Filters to display line items that are performing under pacing, relative to the OSI.
Associated CreativesFilters to display line items with at least one creative associated to it.
Edited TodayFilters to display line items that were edited today.
Ending Within 7 DaysFilters to display line items that will no longer run within 7 days.
Out of BudgetFilters to display line items with no remaining budget.
Favorites OnlyFilters to display line items that have been favorited. This is done by clicking the star to the left of the line item name.
BudgetFilter line items by budget amount. This is done by inputing a minimum and maximum integer in this field.


Section



...

Line Item Features

Below are the features relative to line items that are usable during creation or while in the list view.

Analytics

The Analytics tab displays

...

Line Item Name and Type; Banner, Video, or Native.

Note

This cannot be changed once chosen. 

...

Line Item: General Tab

After finishing the requirements in the Create Line Item modal, you will see the Line Item > General tab page. This will show as Inactive.

Image Removed

  • The name of the line item shows in the header along with its ID number. Additionally, you can see the line item type and its status.
  • To edit the name of the line item, click on the name. Select the check once you are ready to save it. 
  • To favorite the line item, click the star next to the line item name.

Image Removed

Essential Settings

Start with filling out all the required fields in the Essential Settings section:  

  • Fill in the intended line item Start Date and End Date
  • Select the Budget Type by choosing either Spend, Impression or Spend with Vendor Fees.  
  • Enter the budget for the Line Item. Note: The budget of an individual Line Item cannot exceed the Campaign budget. 
  • Select Bidding Strategy from the dropdown.You have the option of out-of-the box bidding strategies or custom bidding strategy. For more information on bidding, refer to Bidding Strategies.
  • Once you complete the above, click Create & Continue to proceed to the Flights section.

Image Removed

Flights

Line-item flights allow for granular control over the timing of line-item delivery. Flights can strictly control delivery time frames, and each can have their own budget. Read more about how to set up line item flights here .

Image Removed

Frequency Caps

When trafficking a Campaign and/or Line Item, you 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 bid request which corresponds to the Beeswax cookie ID on web traffic, and the Device ID on mobile in-app traffic. We also have additional ID types you can frequency cap on. Read more on how to set up frequency caps here.

Image Removed

Vendor Fees

Vendor Fees in the Beeswax platform are a way to optionally include serving costs associated with third-party vendors into Beeswax media spend and reporting. You can also create custom Vendor Fees to withhold your own fee (read here). Vendor Fees can be applied at the campaign or line item level and allow clients to set a budget at the respective level that includes both media spend and vendor fees. Read more on how to set up vendor fees here.

Image Removed

Custom Event Association

Events are used to track conversions, installs, or other key activities. Read more on how to set up events here.

Image Removed

Revenue

You can set a Revenue value on a campaign or line item, which can be used to report on the revenue you have made from running a given campaign. You can in turn calculate the profit margin by subtracting Spend from Revenue. Read more about revenue here. Note: Adding this field does not impact bidding.

Image Removed

SKAdNetwork

SKAdNetwork is an attribution framework designed for mobile app install attribution on iOS 14 and future versions.

Image Removed

Ghost Bidding

Ghost Bidding is an implementation of a testing framework that allows customers to calculate the incremental impact of their media buys by creating a “ghost bid” that is not sent to the exchange. On the line item level, you can choose a Ghost Bidding User ID Type to bucket users for ghost bidding. Two types are available: Standard or IP address.

Image Removed

Targeting

The targeting tab allows you to define your target audience so that your ad gets displayed to the right audience.

Image Removed

Modifiers

Buzz allows you to create lists of criteria for Bid Modifiers and Delivery Modifiers according to various targeting modules and keys. Bid Modifier terms use targeting keys to adjust the bid price. Delivery Modifier allocates delivery weight to specific inventory in real time based on the set rules. Learn more about Bid Modifiers and Delivery Modifiers.

To see how to bulk edit modifiers, please see Bulk Edit Modifiers

Image Removed

Creative Association

Creative association allows you to associate creatives to your line item.

To add a creative:

  1. Click Add Creative Associations.
  2. The Add Creative Associations page lists creatives associated with your campaign.
  3. Choose creatives you would like to associate with the line item and click Add Selected.

To view how to bulk edit creatives, please see Bulk Edit Creatives.

Image Removed

Summary 

The Summary tab displays the essential settings, associated creatives, and status of the line item. If you wish to change a setting, creative or enable the line item, you can click that element and be directed back to its page.

Image Removed

Analytics

The analytics tab shows two charts, Real Time Stats and Bid Decision Flow graphs. These charts display information about your the line item so that you can to better help understand its performance. Note: You will see a new chart called Spend.

Real Time Stats

...

Learn more about Real Time Bidding Stats and Spend.

Image Removed

Spend Chart

Image Removed

This chart provides users with key line item details for better analysis and decision making. The chart includes three new data points called incremental spend (spend in that unit of time), budget (total budget cap on the line item), and total spend (the accumulated spend until that point of time). Additionally, we have enhanced our tooltip to display these elements data at a specific date/time. The chart will show dollar spend if the budget type is Spend with vendor fee or Spend, and it will show impressions if the budget type is Impression.

Forecasting

The forecasting tool provides customers with a projected number of available auctions for purchase based on matching targeting and creative parameters. Learn more about Availability Forecasting.

Image Removed

Bid Decision Flow

Learn more about Bid Decision Flow

Image Removed

Activity Log

The activity log tab allows users to see every change that has been added and/or removed. Each action is given a log ID and categorized by its category, field and date of the change.

Image Removed

Duplicate

You can duplicate a line item while in edit mode. To duplicate, click the three-dots button on the right side of the screen.

Image Removed

Bulk Edit Line Items

...

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.

Line Item Preset

Presets are created once a group of settings for a line item are saved as a preset after creation. This is done from the Summary tab on the upper right hand corner. Once that preset is created, it may be used on other line items as a seamless way to apply the same settings. To use a preset on a line item, see below:

  1. From the line Item General tab > click Select Line Item Preset on the top right of the screen.

  2. Search by name or select from a list on the left hand of the screen.

  3. Once a preset has been clicked on, the settings that will carry over will be displayed in a preview on the right side of the screen.

  4. One the desired preset is selected, click Apply Preset on the lower right hand corner. 
  • General
  • Targeting
  • Creative Association
  • Modifiers

Image Removed

The bulk edit General tab will allow users to edit the following fields for line items:

  • Essential settings
  • Flights
  • Frequency Caps
  • Vendor Fees
  • Custom Event Association
  • Revenue
  • SKAd Network
  • Ghost Bidding

Additionally, users can leverage a new operation dropdown that allows the following:

  • Add to existing
  • Remove all values
  • Replace all values

Image Removed

This feature is supported across flights, frequency cap, vendor fees and custom event association.

To save your edited line items, elect ‘Save & Continue’. If you’d like to cancel your edits, press cancel to be redirected back to the list view screen.

...

Bulk Edit Creatives

To bulk edit creatives, select the checkbox next to the desired line items for creative 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 select the following operations:

  • Add to existing
  • Remove all values
  • Replace all values

After selecting the operation(s), click "add selected" to apply the operations. The creatives selected will appear on the screen, and users will be able to edit the association weight and start/end date. 

...

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 your creatives to update.

In-Line Edit

You can edit a line item while on the Line Items list view page. To begin editing, toggle the Edit Mode button on the right side of the screen next to Manage Columns.

Edit mode provides the ability to quickly edit a single or multiple line items on the list view page. Once the toggle is enabled, you can edit the name, status, budget, start/end dates. Select which field you would like to edit and enter the new value in the field.

Image Removed

...

Quick Stats

The Quick Stats panel appears on the right-side of the General, Targeting, Analytics, and Summary pages . It shows key information for your Line Item and Campaign.Image Removedduring Line Item creation. This table below displays the information found in Quick Stats.

Field NameDefinition
Bids & Wins

...

This graph pulls data of the past

...

six hours of the line item performance.

...

On Schedule Index

...

This chart displays the following information:

  • Time %

...

  • - Hours

...

  • past / Total hours 
  • Budget % (Progress bar calculation / Number on the bottom left) - (Flight Spend / Total

...

  • Flight

...

  • Budget)  
  • Index calculation -  Budget % / Time %
Start Date - End DateStart and End

...

date of Line Item.
Total Budget/Daily Budget

...

Displays two numbers of both the budget for the total line item, and current daily budget.
Total Spend/Remaining BudgetDisplays two numbers of both the total Spend and remaining budget of the line item.
Total ImpressionsTotal number of impressions received for this this line item so far.
Performance Report

This is a clickable link that curates a report from the last seven days with the following information

...

:

  • Day
  • Creative ID
  • Impressions
  • Spend
  • Clicks
  • CTR
  • Video Complete Percent

...

Creatives AssociatedThe total number of Creatives associated with the Line Item. This displays the specific creatives along with links that navigate directly to them.

...

Line Item Health Check

We enhanced our Line Item “Health Check” feature to provide users with better Line item health check provides notifications upfront when their a line item might may not be serving. These notifications are displayed in the summary, targeting, creative association and summary tabs under the header. 

...

Each notification on the summary page is a redirect link that redirects

...

to the page where the issue is occurring.

There are two main types of notifications:

  • Critical Notifications are displayed in red and should be fixed immediately
  • Severe Notifications display in yellow and identify line-item criteria that may prevent your a line item from serving. Severe notifications are dismissible.

For additional information on this feature, visit Line Item Doctor

In-Line

...

Image Removed

Edit

In-Line Edit allows the editing of line items right from the list view screen. To begin editing, toggle the Edit Mode button on the right side of the screen next to Manage Columns. Once the toggle is enabled, the following fields are able to be edited:

  • Name
  • Status
  • Budget
  • Start/End dates

Click Save Change to save your updates or Cancel to disregard any edits that were madeThe bidding and winning columns have been consolidated into a new column called “Delivery Status”. The new column will display three main statuses that will show whether your line item is either: Winning, Not bidding, or not winning.

Warning Opt-Out

The  "Warning Opt out" allows users to opt-out of warnings presented to them when configuring line items. Users can click the  "Click the Don't ask me again" checkbox which will to remove the warning from their a workflow for faster line item enablement. 

...

After

...

"Don't ask me again" has been clicked, the notification will re-appear on the following page for five seconds.

...

In order to subscribe, click the desired checkbox and select

...

save anyway

...

The bidding and winning columns have been consolidated into a new column called “Delivery Status”. The new column will display three main statuses that will show whether your line item is either: Winning, Not bidding, or not winning.