A list of Keys that are available in the system are listed below. A given organization (Buyer, Seller, Ad Network, etc.) can only access a subset of these. Most keys also function as Filters, which limits what is displayed in your report.
Ad name. Selecting this key will display metrics data grouped by Ad Name.
Ad Click URL
The click through URL defined for the Ad Creative.
Ad End Date
The end date defined for the Ad.
Ad Error Code
The VAST 3.0 error code. See a complete list of VAST 3.0 error codes.
Ad Error Description
The description of the Ad Error code.
Ad Format Type
Selecting this key provides reporting by inventory format type(linear, non-linear, out-stream and in-banner.)
The amount of the ad's goal.
Ad Goal Type
The goal-type specified within the Ad. (Impressions, Total Spend, 100% Completed Views, Revenue, etc.)
Displays data by Ad Group Name.
Ad Group End Date
The end date assigned to the Ad Group.
Ad Group Goal
The Ad Group goal amount.
Ad Group Goal Type
The Ad Group goal type. (Impressions, Total Spend, 100% Completed Views, Gross Spend, etc.)
Ad Group ID
The Ad Group ID number.
Ad Group Pricing Type
The pricing method specified for the Ad Group. Values: CPC, CPM, CPCV.
Ad Group Start Date
The start date assigned to the Ad Group.
The Ad ID number.
The ad initiation type. Values include AI/UI/Unknown.
Ad Player Size
The ad player size used to display the creative.
The Ad Policy name.
Note: Available only to publishers using the Video SSP Ad Player, leveraging Ad Policies.
Ad Pricing Type
The pricing method specified for the Ad when it was setup. Values: CPC, CPM, CPCV.
The priority assigned to the Ad, which pulls in the priority of all ads - 1-11, 11= optimized.
Ad Opportunity Filter Reason
Filters reports at inventory source or Marketplace connection level, to find out the number of ad opportunities that are weeded out by the Ad server and why.
Ad Sequence ID
The numeric position of the ad within an ad pod sequence. (This metric can be used to generate performance and delivery reports that drill down to the position of the ad within an ad pod.) If an ad was not rendered inside of an ad pod, the Ad Sequence value will be "0".
Ad Spot Type
Pre-Roll or Mid-roll.
Ad Start Date
The start date defined for the Ad.
Ad Tag URL
The ad serving tag URL applied for the Creative. Applicable for 3rd party served Ads only.
The type of Ad specified in the Video SSP system. There are several Ad types, including: Ad for O&O, which runs on a publisher's owned inventory, Ad for Partner and Ad for Network, which run on the inventory of a partner site or network inventory source, Ad for ATM runs on Marketplace inventory.
The name of the Advertiser associated with a particular Campaign. To report on Campaign activity by Advertiser, you must assign an Advertiser to the Campaign.
The vertical assigned to the Advertiser. Verticals reflect the Advertiser's industry.
Advertising ID Status
Indicates the status for the supplied Advertising ID:
In order to be considered valid, advertising ID must be well formed and be of the specified length for the Advertising ID type.
Advertising ID Type
The advertising ID type passed for a mobile impression. Values can be:
- IDFA (Android)
- AID (Apple)
- WAID (Windows)
- Not Applicable
The mobile App Bundle ID. Example: Google Play: com.rovio.angrybirds / Apple App Store: com.foo.mygame.
App Storeurl Available
Whether the ad opportunity contained an App Storeurl. Values are “Yes” and “No”.
Differentiates data for First and Second auction. Trust but Verify Double Auction in reporting.
The Advertiser Brand selected for a particular Campaign.
Buyer Deal ID
The Deal ID identifier used for a Deal.
Buyer Deal Name
The buyer's deal name.
The buyer organization's name. This is the org that acts as a buyer in either a public or private marketplace run on the Video SSP platform.
The Campaign name.
The Campaign goal amount defined in Campaign settings.
Campaign Goal Type
The Campaign goal type defined in Campaign settings. Values include Impression, Spend, Completion_100, Gross Revenue, Revenue. If no Campaign Goal was applied, appears as 'Not Applicable'.
The Campaign ID number.
Campaign IO Number
The Campaign IO number.
Conversion Event name. Selecting this key will display conversions metrics data grouped by Conversion Event.
The Creative name.
Returns analytics that provide insights into how Advertiser/Brand/Category are performing/bidding on your inventory.
Example: You can run a report level on the Advertiser names that were assigned to all creative IDs sent by RTB buyers.
Returns analytics that provide insights into how Advertiser/Brand/Category are performing/bidding on your inventory.
The Creative ID number.
The duration of the video ad defined for the Creative.
Select 'Date' to display data broken down by individual dates within your date range.
Day of Week
Select 'day of week' to display data broken down by the day of the week (Monday, Tuesday, etc.) within your date range.
Part of day when ad runs, for example 6AM-12PM, 12PM-5PM.
The type of device displaying the ad.
Displays data organized by Digital Ad Name.
Double Auction Reason
Tracks down, why your ad was double requested.
External Creative ID
The external creative ID, received as part of the bid response.
First Party ID
The ID of the First Party.
The country where the event occurred.
The region where the event occurred.
The state or province where the event occurred.
The hour when the event occurred. Timezone is PST unless a different report, campaign, or organization time zone is set. "0" is midnight (12 AM) to 12:59 AM, "23" is 11 PM to 11:59 PM.
Note: A combination of Hour and Recent Hour keys to get a continuous time series of hourly data, is currently NOT supported.
The name of the market placement, which is unique to each publisher.
The Marketplace where the event occurred. This can be the Video SSP marketplace, a 3rd party exchange, or a private marketplace. Displays data by Marketplace name.
The ID of the Marketplace.
Marketplace Reporting Type
The Marketplace type. Values include Private Marketplace, Video SSP Marketplace, and External Exchange.
The Marketplace SSP. Values include Video SSP Marketplace, ADX, BRX, SPOTX, LIVERAIL, etc.
The site where the event occurred. Lists the domain (test.com), not the full URL (test.com/video-type).
The exchange site ID number assigned to the domain.
The site Video SSP detected using our Automatic Site Verification technology.
Media Detection Method
The method Video SSP used to detect the site. Values are "Seller reported" and/or "Video SSP detected."
Media: Seller Reported
The site the seller reported to Video SSP as the Page URL.
Media: Targeting Method
This is the method Video SSP utilized when targeting the ad, i.e., when Video SSP matched the ad request with an appropriate ad.
Reports all language(s) attached to a media.
Reports all IAB topics attached to a media in the decreasing order of relevance.
Reports on the type of media in the inventory source/marketplace connection. Values include Site, App, etc.
The month when the event occurred. Select 'month' to see data broken down by month (January, February, etc.) within your date range.
Operating System (OS)
Values which map to "targetable" operating systems, including:
- Windows 8
- Windows 7
- Windows Vista
- Windows XP
- Mac OS X
- Other Operating Systems.
The name of the organization. (For example, if your organization is called 'Spade & Archer' this column will display 'Spade & Archer'.)
Every impression is assigned a placement type. This is a description of the type of placement where ad serving events occurred.
Reports by player type:
- VPAID Flash
- VPAID JS
Note: Unknown - Refers to VAST only or VPAID Lite cases.
Priority Type is used by Ad for Network to indicate whether the ad will be served to direct inventories with competition from ads from Video SSP Marketplace (ATM) or not.
When an opportunity from direct inventory comes in, if there is a match from Ad for Networks with Priority Type = Committed, then we'll serve the winning ad directly. Otherwise, if all the eligible Ad for Networks have Priority Type = Optimized, then we'll get a bid from ATM, and then decides which one is the winning bid.
Displays performance data by audience data segment provider regardless of whether the data provider was included in your Ad's targeting selection.
For example, your Ad did not target any BlueKai segments; however the user you reached belonged to one or more BlueKai segments cookie population, so the impression performance can be presented as corresponding to BlueKai when using the Provider Name key.
All clients using Video SSP reporting can run all keys/metrics on real time data by using the key called
While the key called Hour only provides data up to 2 hours ago (2 hour lag), the new key provides most recent data within the past 1-2 hours (with only a 5 min lag).
Properties and limitations
- Recent Hour key shows the real time traffic for the actual day, the report date range in the filters must be set to Today.
- Recent Hour displays data based on Report time zone settings, which defaults to the org's currency, but can be changed by the user.
- A combination of Hour and Recent Hour keys to get a continuous time series of hourly data, is currently NOT supported.
- The time span of data shown in Recent Hour can fluctuate between showing almost 1 hour of data and almost 2 hours of data, depending on when throughout the hour the user runs the report. Due to server settings, data will always have a 5 min lag.
- If you run the report just before the end of the hour (9:59), you will have almost 2 recent hours of data showing.
- If you run the report just after the new hour starts (10:01), you will only have data for the full prior hour and some data for the duration of the current hour (on 5 min lag).
How to create a report with Recent Hour key?
- Navigate to Analytics > Reports > [+ New Report] to open the New Report window.
- In the Report Builder tab > Filter section set the time range to Today.
- In the Key sub-tab select Recent Hour.
By creating reports using the new Secure Flag key in combination with the Ad key, you can view ad metrics such as impressions, attempts, opportunities, and others, specifically for ad serving to secure inventory. This can give you insight into what percentage of inventory can participate in secure auctions.
Displays performance data by audience data segment regardless of whether the data segment was included in your Ad's targeting selection.
For example, your Ad did not target any BlueKai segments; however the user you reached belonged to one or more BlueKai segments, so the impression performance can be presented as corresponding to particular BlueKai segments when using the Segment key.
Seller Deal ID
Enables publishers to transact programmatically via a unique identifier against a pre negotiated relationship.
Seller Deal Name
The Deal name that allows publishers to transact programmatically.
The name of the publisher. The key only shows the names of publishers if they use the Video SSP ad server or list inventory in the Video SSP marketplace.
Displays the name of the Sessions Restriction within a Publisher Setting.
Displays the ID of the Sessions Restriction within a Publisher Setting.
Shows ad statistics by Publisher Settings, so that sellers can see the effectiveness of Repeat Ad Behavior and adjust accordingly.
Targeted Audience Provider
Displays performance by targeted audience data segment provider for dates/impressions that this provider was part of the Ad's targeting selection.
When using 'Targeted Audience Provider,' you will view data for impressions mapped only to those providers that were actually included in your audience targeting criteria.
Targeted Audience Segment
Displays performance by targeted audience data segment for dates/impressions that this segment was part of the Ad's targeting selection.
When using 'Targeted Audience Segment,' you will view data for impressions mapped only to those segments that were actually included in your audience targeting criteria.
Transaction Cleared by AOL Advertiser
Denotes whether transactions are cleared by AOL Advertiser.
Vendor App Name
The vendor name of the app to report on. With the Vendor App Name filter, the user can choose from the following operators:
- In, not in - these operators will include/exclude entries based on the exact text inserted in the text field (it’s not case sensitive). To filter for more than one vendor app name, insert each name as a separate parameter. (The vendor app name is set up when a new app is added to the platform.)
- Contains, Does not contain - these operators filter using a part of the name (in case the exact name is unknown or you want to filter based on a part of the name shared by more than one app (e.g., use only ‘Integral Ad Science’ to match against ‘Integral Ad Science Bid Expert - Brand Safety, ‘Integral Ad Science Bid Expert - Suspicious Activity’, and ‘Integral Ad Science Bid Expert - Viewability’).
Note: You can also use the following wildcards in the match strings:
- % matches one or more characters
- _ matches only one character
The type of device used to display the ad, such as online video, mobile phone, tablet, TV or game consoles.
The local time when the ad was served. The time zone is based on the user's browser setting.
Note: Use this key to reference when you're reporting on a campaign that uses day parting.
Captures whether a Market Opportunity is viewable at the time of pre-bid detection. To be viewable, at least 50% of the ad player must be in the viewable area of an active browser window.
Helps to find out how many times the player loaded Video SSP VPAID for filling the opportunity.