Table of Contents






Overview

The Vendor object is created to define a fee that should be applied to a specific vendor when serving ads or bidding. The fee is set as a custom CPM or percentage and gets associated to another object, typically a line item or campaign. If applying a vendor fee at a campaign level, the fee will be taken from a portion of the campaign's total revenue, instead of an individual line item. When creating a line item or campaign, this fee can be selected and applied in the General screen under Vendor Fees. Vendors belong to an account and are not advertiser specific, while global vendors are created by the system administrator and are available to all accounts.


Accessing Vendors

To access the Vendors page, navigate to Trafficking > Vendors at the top of the screen.

Vendors List View

List View Fields

Column NameDescription
Name & IDName & ID of created Vendor.
Alt IDAny number or string used to map this object to an object in an outside system.
Fee AmountThe fee amount that will be associated with this vendor when being used; represented as currency. 
Fee Type

Fee type is represented by:

  • None
  • CPM
  • Percent

Click here to see more about fee types.

CurrencyType of currency this fee is represented as. The currency options are configurable in Account Settings.
Vendor Buzz KeyUnique buzz key for the vendor created.
StatusActive or inactive.




Create a New Vendor

  1. Navigate to Trafficking > Vendors > New Vendor. Additionally, vendors may be created by clicking the button, then clicking Vendor at the top right of the UI.

  2. A screen will appear with the following fields to complete:
    *Required

    Field NameDescription
    Vendor Name*Choose a desired name for this vendor fee.
    Fee Type*

    Select a fee type:

    Currency type and Fee Amount are required fields when selecting either CPM or Percent.

    • None
    • CPM
    • Percent
    Alternative IDAlternative ID used for reporting in a third-party system.
    Add NotesAdd any desired notes for this vendor.
    StatusActive or Inactive.




  3. Click Save on the lower right corner of the screen.


Apply a Vendor Fee

Once a vendor has been created and there is an associated fee, the vendor fee may be applied to a line item or campaign.

  • If Spend with Vendor Fees is selected, any third-party data with fees already in Beeswax including Beeswax ad serving fees and any custom vendor fees applied to the line item/campaign will be included in the budget.

  • If just Spend is selected, the campaign or line item will spend without including fees, however, vendor fees additional to spend will be available in reporting.


  1. To apply this fee, open a campaign or line item to edit.

  2. Navigate to the General tab > Vendor Fees.

  3. Complete the following fields found below:


  4. Click Save.

  5. Switch back to the overview tab and select a budget type: 
    1. If Spend with Vendor Fees is selected, any third-party data provider in Beeswax, Beeswax ad serving fees, and any custom Vendor Fees applied to the line item/campaign will be included in the budget.

    2. If just Spend is selected, the campaign or line item will spend without including fees, however, vendor fees additional to spend will be available in reporting.

Vendor Fees in Reporting

In order to view Vendor Fees in reporting:

  1. Select Vendor Report from Analytics module at the top of the screen.

  2. Select Spend and Vendor Fees as metrics.

Spend will be media spend plus vendor fees if selecting Spend with Vendor Fees as the Budget Type.

Further details on the fields/metrics included in the Vendor Report can be found here.


Withholding Fees with Different Budget Types

If looking to apply a default account-level percentage fee in the form of a bid reduction to either all or some accounts within the network, please contact your Beeswax representative. 

Below are the optional methods of using fees with different types of budget on a line item or campaign. Since fees may be applied with different budget types, behavior for these fees varies. Review this table for an understanding of how certain fee types interact with budget types.

Fee Type with BudgetDescription of Behavior
CPM Custom Vendor Fee with a budget type of Spend with Vendor Fees

For every impression, Beeswax withholds the additional Vendor Fee CPM from the budget spent. For example, if a line item has a $0.10 vendor fee and spends $1 on media, Beeswax will automatically withhold an additional $0.10 from the budget. As a result, $1.10 will be withheld from the total budget. This will not impact the CPM bid; it will only impact the amount of budget that goes towards media spend.

CPM Custom Vendor Fee with a budget type of Spend

For every impression, Beeswax applies the additional Vendor Fee CPM on top of the total budget. For example, if a line item has a $0.10 Vendor Fee and spends $1 on media, Beeswax will automatically record an additional $0.10 on top of the budget. As a result, only $1 will be withheld from the budget. This will not impact the CPM bid or the amount of budget that goes toward media spend; it is only for reporting purposes.

Percent Custom Vendor Fee with a budget type of Spend with Vendor Fees

For every impression, Beeswax will apply an additional percent of that CPM to the budget spent. For example, if a line item has a 10% Vendor Fee and spends $1 on media, Beeswax will automatically withhold an additional $0.10 from the budget. As a result, $1.10 will be withheld from the total budget. This will not impact the CPM bid; it will only impact the amount of budget that goes toward media spend.

Custom Vendor Fee only applies to media spend; as a result, this is not a true margin since it does not take into account third-party vendors or Beeswax ad serving costs.


Percent Custom Vendor Fee with a budget type of Spend

For every impression, Beeswax will apply an additional percent of that CPM on top of the total budget. For example, if a line item has a 10% Vendor Fee and spend $1 on media, Beeswax will automatically record an additional $0.10 on top of the budget. As a result, Beeswax will only withhold $1 from the budget. This will not impact the CPM bid or the budget; it will be applied on top of the budget for reporting purposes.