Beeswax (Buzz): Most-used fields

The table below gives information about most-used fields that you can import from Beeswax (Buzz). Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Account ID	Account ID	The unique identifier for an account.	metric
Account Name	Account Name	The name of the account.	dimension
Advertiser Category	Advertiser Category	The category to which the advertiser belongs.	dimension
Advertiser Domain	Advertiser Domain	The website domain of the advertiser.	dimension
Advertiser ID	Advertiser ID	The unique identifier for an advertiser.	metric
Advertiser Name	Advertiser Name	The name of the advertiser.	dimension
Audio Complete Percent	Audio Complete Percent	Represents the percentage of audio creatives that were played through to completion by a user. This is derived from the ‘AUDIO_COMPLETE’ event in Beeswax’s ad logs.	dimension
Audio Completes	Audio Completes	The number of times an audio advertisement was played to completion (AUDIO_COMPLETE).	metric
Audio Delivery	Audio Delivery	Indicates the successful delivery and initiation of audio ad playback. This metric is based on ‘AUDIO_PLAYS’ events recorded in Beeswax ad logs, signifying when an audio creative starts playing.	dimension
Audio Midpoints	Audio Midpoints	The number of times an audio advertisement reached its 50% midpoint during playback (AUDIO_MIDPOINT).	metric
Audio Plays	Audio Plays	The number of times an audio advertisement began playing (AUDIO_PLAYS).	metric
Audio Skips	Audio Skips	The number of times an audio advertisement was skipped by a user (AUDIO_SKIPS).	metric
Bid Modifier ID	Bid Modifier ID	A unique identifier for a Bid Modifier object, which adjusts bid prices in real-time based on defined rules.	metric
Bid Shading Fee	Bid Shading Fee	The fee associated with bid shading optimization.	metric
Bid Shading Fee USD	Bid Shading Fee USD	The fee associated with bid shading optimization, expressed in US Dollars.	metric
Bidding Strategy	Bidding Strategy	The strategy or algorithm used to determine bid prices for impressions, which can be standard or custom.	dimension
CPC	CPC	Cost Per Click, a metric representing the average cost incurred for each click on an ad.	metric
CPC USD	CPC USD	Cost Per Click, expressed in US Dollars.	metric
CPM	CPM	Cost Per Mille (or Cost Per Thousand Impressions), a metric representing the cost for one thousand ad impressions.	metric
CPM USD	CPM USD	Cost Per Mille (or Cost Per Thousand Impressions), expressed in US Dollars.	metric
CTR	CTR	Click-Through Rate, the percentage of impressions that resulted in a click.	metric
Campaign Budget	Campaign Budget	The total budget allocated for a specific campaign.	metric
Campaign Budget Type	Campaign Budget Type	The type of budget set for a campaign (e.g., daily, total).	dimension
Campaign Daily Budget	Campaign Daily Budget	The daily budget allocated for a specific campaign.	dimension
Campaign End Date	Campaign End Date	The end date of the campaign.	dimension
Campaign ID	Campaign ID	The unique identifier for a campaign.	metric
Campaign Impressions	Campaign Impressions	The total number of times ads from a campaign were displayed.	metric
Campaign Name	Campaign Name	The name of the campaign.	dimension
Campaign Revenue Type	Campaign Revenue Type	The type of revenue model used for a campaign, such as Cost Per Mille (CPM), Cost Per Click (CPC), Cost Per Completed View (CPCV), Cost Per Install (CPI), or Cost Per Acquisition (CPA).	dimension
Campaign Spend	Campaign Spend	The total amount of money spent on a specific campaign.	metric
Campaign Start Date	Campaign Start Date	The start date of the campaign.	dimension
Clicks	Clicks	The total number of clicks recorded on ads.	metric
Companion CTR	Companion CTR	The Click-Through Rate for companion creatives.	metric
Companion Clicks	Companion Clicks	The total number of clicks on companion creatives.	metric
Companion Views	Companion Views	The total number of views for companion creatives.	metric
Conversion Hour	Conversion Hour	The hour of the day when a conversion occurred.	dimension
Conversion Order	Conversion Order	A single instance of a conversion event recorded as an order.	metric
Conversion Orders	Conversion Orders	The number of conversion events recorded as orders.	metric
Conversion Value	Conversion Value	The monetary value attributed to a single conversion event.	metric
Conversions	Conversions	The total number of conversion events.	metric
Conversions’ Value	Conversions’ Value	The total monetary value attributed to conversions.	metric
Creative ID	Creative ID	The unique identifier for an ad creative.	metric
Creative Name	Creative Name	The name of the ad creative.	dimension
Creative Size	Creative Size	The dimensions (e.g., width x height) of the ad creative.	dimension
Currency	Currency	The currency used for financial metrics.	dimension
Day	Day	The day of the month for which data is reported.	dimension
Deal ID	Deal ID	The unique identifier for a private marketplace (PMP) deal or guaranteed deal.	dimension
Event Alternative ID	Event Alternative ID	An identifier used to tie a Beeswax event to an external system’s ID for reconciliation or querying.	dimension
Event ID	Event ID	The unique identifier for a specific event.	metric
Event Name	Event Name	The name of a specific event tracked (e.g., a conversion event).	dimension
Flight Budget	Flight Budget	The total budget allocated for a specific ad flight.	metric
Flight End Date	Flight End Date	The end date of the ad flight.	dimension
Flight ID	Flight ID	The unique identifier for an ad flight.	metric
Flight Impressions	Flight Impressions	The total number of times ads within a specific flight were displayed.	metric
Flight Name	Flight Name	The name of the ad flight.	dimension
Flight Spend	Flight Spend	The total amount of money spent on a specific flight.	metric
Flight Start Date	Flight Start Date	The start date of the ad flight.	dimension
FreeWheel Household ID Conversion Order	FreeWheel Household ID Conversion Order	The number of items or quantity associated with conversions attributed to a FreeWheel Household ID (gog_household_conversion_order).	metric
FreeWheel Household ID Conversion Value	FreeWheel Household ID Conversion Value	The monetary value associated with conversions attributed to a FreeWheel Household ID (gog_household_conversion_value).	metric
FreeWheel Household ID Conversions	FreeWheel Household ID Conversions	The number of conversions attributed to a FreeWheel Household ID (gog_household_conversion_count).	metric
FreeWheel Person ID Conversion Order	FreeWheel Person ID Conversion Order	The number of items or quantity associated with conversions attributed to a FreeWheel Person ID (gog_person_conversion_order).	metric
FreeWheel Person ID Conversion Value	FreeWheel Person ID Conversion Value	The monetary value associated with conversions attributed to a FreeWheel Person ID (gog_person_conversion_value).	metric
FreeWheel Person ID Conversions	FreeWheel Person ID Conversions	The number of conversions attributed to a FreeWheel Person ID (gog_person_conversion_count).	metric
FreeWheel Person ID Conversions Value	FreeWheel Person ID Conversions Value	The monetary value associated with conversions attributed to a FreeWheel Person ID (gog_person_conversion_value).	metric
Frequency	Frequency	The average number of times a unique user saw an ad within a given period.	metric
Frequency (Standard with Fallback)	Frequency (Standard with Fallback)	The average number of times a unique user saw an ad within a given period, with a fallback mechanism if standard calculation is not possible.	metric
Geo City	Geo City	The geographical city where an ad impression occurred, typically determined by the user’s IP address and mapped using databases like MaxMind or Geonames. This field is available for both targeting and reporting.	metric
Hour	Hour	The hour for which data is reported.	dimension
Hour of Day	Hour of Day	The hour within a 24-hour day for which data is reported.	metric
IP Conversion Order	IP Conversion Order	The number of items or quantity associated with an IP-based conversion.	metric
IP Conversion Orders	IP Conversion Orders	The total number of orders recorded via IP-based conversions.	metric
IP Conversion Value	IP Conversion Value	The monetary value attributed to an IP-based conversion (ip_conversion_value).	metric
IP Conversions	IP Conversions	The number of conversions attributed based on IP address (ip_conversion_count).	metric
IP Conversions Value	IP Conversions Value	The monetary value attributed to an IP-based conversion (ip_conversion_value).	metric
Impressions	Impressions	The total number of times an ad was displayed.	metric
Invalid Impressions	Invalid Impressions	The number of impressions that were deemed invalid (e.g., fraudulent, non-human).	metric
Inventory Cost	Inventory Cost	The cost of ad inventory.	metric
Inventory Cost USD	Inventory Cost USD	The cost of ad inventory, expressed in US Dollars.	metric
Line Item Budget	Line Item Budget	The total budget allocated for a specific line item.	metric
Line Item Budget Type	Line Item Budget Type	The type of budget set for a line item (e.g., daily, total).	dimension
Line Item Daily Budget	Line Item Daily Budget	The daily budget allocated for a specific line item.	metric
Line Item End Date	Line Item End Date	The end date of the line item.	dimension
Line Item ID	Line Item ID	The unique identifier for a line item.	metric
Line Item Impressions	Line Item Impressions	The total number of times ads from a line item were displayed.	metric
Line Item Name	Line Item Name	The name of the line item.	dimension
Line Item Spend	Line Item Spend	The total amount of money spent on a specific line item.	metric
Line Item Start Date	Line Item Start Date	The start date of the line item.	dimension
Measurable Impression %	Measurable Impression %	The percentage of impressions that were measurable, indicating successful tracking and data collection.	metric
Measurable Impressions	Measurable Impressions	The count of ad impressions that meet specific criteria for viewability, meaning they had the potential to be seen by a user. This is derived from the ‘is_measurable’ field in Beeswax’s win logs.	metric
Measurable Invalid Impressions	Measurable Invalid Impressions	The number of impressions that were measurable but identified as invalid.	metric
Media Spend	Media Spend	The cost of buying ad media.	metric
Media Spend USD	Media Spend USD	The cost of buying ad media, expressed in US Dollars.	metric
Month	Month	The month of the year for which data is reported.	dimension
Platform Device Make	Platform Device Make	The manufacturer of the device on which the ad was served.	dimension
Platform Device Model	Platform Device Model	The specific model of the device on which the ad was served.	dimension
Platform Device Type	Platform Device Type	The type of device on which the ad was served (e.g., mobile, desktop, tablet).	dimension
Platform OS	Platform OS	The operating system of the device on which the ad was served.	dimension
Postback Conversions	Postback Conversions	The total number of conversions reported via postback mechanisms.	metric
Reach	Reach	The total number of unique users who saw an ad.	metric
Reach (Standard with Fallback)	Reach (Standard with Fallback)	The total number of unique users who saw an ad, with a fallback mechanism if standard calculation is not possible.	metric
Revenue	Revenue	The total revenue generated.	metric
Spend	Spend	The total amount of money spent on advertising.	metric
Spend USD	Spend USD	The total amount of money spent on advertising, expressed in US Dollars.	metric
Unique Conversion Orders	Unique Conversion Orders	The number of unique conversion orders attributed to ad impressions. This metric is reported by advertisers and signifies distinct purchase or order events. It corresponds to the ‘conversion_order’ field in Beeswax’s win logs.	metric
Unique Conversions	Unique Conversions	The total number of unique conversion events associated with ad impressions. This can include various types of conversions, such as user ID-based or IP-based conversions, as captured in Beeswax reporting.	metric
Unique Conversions Value	Unique Conversions Value	The total monetary value generated from unique conversion events. This value is specified by the advertiser in the Beeswax UI or API and is associated with recorded conversions.	metric
User ID & Postback Conversions	User ID & Postback Conversions	The number of conversions attributed via User ID and postback mechanisms (conversion_count).	metric
User ID & Postback Conversions Value	User ID & Postback Conversions Value	The monetary value associated with conversions attributed via User ID and postback mechanisms.	metric
Vendor Fee Currency Code	Vendor Fee Currency Code	The currency code used for vendor fees.	dimension
Vendor Fees	Vendor Fees	The total amount of fees charged by vendors.	metric
Vendor Fees USD	Vendor Fees USD	The total amount of vendor fees, expressed in US Dollars.	metric
Video Companion CTR	Video Companion CTR	The Click-Through Rate for companion banners displayed alongside video ads.	metric
Video Companion Clicks	Video Companion Clicks	The total number of clicks on companion banners displayed alongside video ads.	metric
Video Companion Views	Video Companion Views	The total number of views for companion banners displayed alongside video ads.	metric
Video Complete Percent	Video Complete Percent	The percentage of video ads that were played to completion.	metric
Video Completes	Video Completes	The total number of times a video ad was played to completion.	metric
Video Duration	Video Duration	The total duration of the video creative.	metric
Video Midpoints	Video Midpoints	The number of times a video ad was played to its midpoint (50% completion).	metric
Video Placement Type	Video Placement Type	The type or category of video ad placement, such as pre-roll, mid-roll, or post-roll.	dimension
Video Plays	Video Plays	The total number of times a video ad began playing.	metric
Video Q1s	Video Q1s	The number of times a video ad was played to its first quartile (25% completion).	metric
Video Q3s	Video Q3s	The number of times a video ad was played to its third quartile (75% completion).	metric
Video Skips	Video Skips	The number of times a video ad was skipped by users.	metric
Viewability %	Viewability %	The percentage of impressions that were considered viewable according to industry standards.	dimension
Viewable Impressions	Viewable Impressions	The total number of ad impressions that were considered viewable.	metric
Week	Week	The week number for which data is reported.	dimension
Win Rate	Win Rate	The percentage of bid requests that result in a won impression.	metric
Year	Year	The year for which data is reported.	metric