Use * syntax for faster search

Starting September 30, 2024, all Oracle products, including BlueKai, MOAT, and Grapeshot segments, as well as MOAT post bid measurement, will no longer be available on the Beeswax platform. If this impacts you, Beeswax account teams are available to assist in finding alternative options. For questions, please contact your Beeswax account representative.



Table of Contents



Overview

Deals are an advanced agreement on purchased inventory between a buyer and seller. Deals present opportunities for publishers to charge premiums on their inventory or pre-negotiate terms that create the best opportunity on both sides of a transaction.

Beeswax offers four different deal type options:

  • Guaranteed
  • Open Auction
  • Preferred
  • Private Auction

See Create a Deal for more information on deal types.

After creating a deal, line items can target that deal under the App/Site targeting section, and reportable data for the deal's performance will be available in the Deal Report. Although deals can be created within the UI, buyers also have the option of using an external deal. For this scenario, a publisher may create a deal in their system and then share that external deal ID with a buyer using Beeswax. That deal ID is then able to be targeted by a line item, which streamlines operations significantly. 

If using an external deal from an outside system, reportable data will not be available for that external deal ID in the Deal Report.



Accessing Deals

To access the Deals page, navigate to Trafficking > Deals at the top of the screen in Beeswax.



Deals List View

List View Fields

Column NameDescription
Name & IDName and associated ID for the created deal.
Deal IDString of numbers used as an identifier for the deal that is shared between the buyer and the seller. 
AdvertiserAdvertiser associated with the deal.
Inventory SourceThe location or inventory where the ad will be played.
Deal Type

The deal type selected, which is one of the following:

  • Guaranteed Deal (guaranteed impressions at fixed CPM)
  • Open Auction Deal (any buyer)
  • Preferred Deal (price or other preferred priority)
  • Private Auction Deal (only specific buyers)
PublisherThe publisher that the deal will is created with.
CPM OverrideA deal's "CPM Override" value will take precedence over line items' CPM bid when applied; represented numerically.
Floor PriceA deal's "Floor Price" is for reference only and will not affect line items' bidding behavior; represented numerically.

Start/End Date

(Scroll right to view in UI)

The start and end of the deal being active. Choosing no dates will make this deal eligible to use at any time.

Currency

(Scroll right to view in UI)

The currency format of the deal, represented as one of the chosen currencies set up within the account.

Supported Formats

(Scroll right to view in UI)

Where this ad is eligible to run. Options shown below:

  • Banner
  • Video
  • Native
  • All

Archived

(Scroll right to view in UI)

Either "Yes" or "No".



Create a Deal

  1. To create a Deal, navigate to TraffickingDeals.

  2. Click New Deal > First Party Deal on the upper right hand of the deals list view.

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

    Field NameDescription
    Deal Name*Type a desired name for the deal.
    AdvertiserChoose either a specific advertiser, or make this an account-level deal. An account level deal will be usable for any advertisers on the account.
    Deal Type

    The deal type is an optional selection in the deal creation screen. If "None" is selected, it will apply as an account-level deal.

    • Guaranteed Deal (guaranteed impressions at fixed CPM)
    • Open Auction Deal (any buyer)
    • Preferred Deal (price or other preferred priority)
    • Private Auction Deal (only specific buyers)
    Currency

    The currency type that this deal will be using. This currency options listed are populated based on the selected currencies on the account level. Here are some currency types for example:

    • EUR
    • GBP
    • UAH
    • USD
    CPM OverrideA deal's "CPM Override" value will take precedence over a line items' CPM bid when applied. Learn more about CPM override here.
    Start Date/End DateThe start and end of the deal being active. Choosing no dates will make this deal eligible to use at any time.
    Alternative IDCreate an ID to use for reporting in an outside system.
    Inventory Source*The source of inventory that will be bid into.
    Deal ID*Create a deal ID that will connect to the publishers system.
    PublisherThe publisher that the deal will is created with.
    Supported Formats*

    Choose a creative format that matches the creative type of the line item to which this deal will apply. Deals of a specific format can only be assigned to line items of the same type. For instance, a "Video" deal can only be assigned to a video line item. Once chosen, this selection cannot be changed.

    Floor PriceA deal's "Floor Price" is for reference only, and will not affect line items' bidding behavior.


  4. Click Save on the lower right corner when finished.



Target a Deal on a Line Item

Once a deal is created, it is eligible for targeting on a pre-created or new line item. To target a deal, follow these steps:

  1. From the App/Site tab on the line item targeting screen, scroll down to Deal.

    On the App/Site tab on the line item targeting page, there are two format options to toggle between when selecting a deal; represented by this image in the UI:  

    1. List view: This view will source deals that have been created for the account. To find and select the desired deal, scroll or search by the deal name.

    2. Comma separated text field for manual input of deal ID's without creating a deal object.
  2. View a list of created deals, or type in the navigation bar to find a created deal. Each viewable deal will be accompanied by a deal ID.

    Deal IDs are only unique per exchange, so users must prepend the exchange abbreviation before the Deal ID. For example, to target Deal ID "deal12345" on Google’s AdX, users should input "adx/deal12345".

  3. To include or exclude a deal for targeting, click the green check mark or red strikethrough circle to the left of the deal name.

  4. Click Save & Continue to save the changes.

Deals CPM Override

This feature is only available for line items using bidding strategies where a flat CPM (CPM or VCR) is in use. Different CPM override prices can be applied on different deal IDs. 

The UI will not allow saving a CPM Override that is lower than the Floor Price set on the Deal.

Deal CPM Override is a manually input number added during the creation of a deal that will take precedence over the deal's CPM when activated. This override will not be applied when a deal is targeted via Deal ID List. To enable the override, the line item has to target the deal directly while deal ID lists are still available for use in targeting. Once a deal has been selected from either targeting method, an option to override the CPM bid will be shown. For the deals where an override CPM is defined on the object, the price will automatically be applied. If left blank, the line item is going to fall back to the line item’s CPM specified on the overview screen.



Add Deals to a List

When uploading a deal list file, Upload csv, txt, or excel files only. Any existing list items included in the upload will be updated.

When wanting to target a group of deals at once, a deal list can be created. Targeting a deal list could be beneficial because it introduces a wider range of targeting options and creates a more diverse advertising strategy. When creating a deal list, a file must be uploaded with each line of the file containing deal information. For instance, the line should contain the exchange prefix followed by a forward slash and the deal ID. Below is an example:

abc/DEAL-ID-1

Line items can target any deal list during editing or creation from Targeting screen > App/Site tab > Deal List menu. For more information on targeting a list, see Lists.

  • No labels
Provide feedback on this article