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.
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
A
Ad
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.)
Ad Goal
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.)
Ad Group
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.
Ad ID
The Ad ID number.
Ad Initiation
The ad initiation type. Values include AI/UI/Unknown.
Ad Player Size
The ad player size used to display the creative.
Ad Policy
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.
Ad Priority
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.
Ad Type
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.
Advertiser
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.
Advertiser Vertical
The vertical assigned to the Advertiser. Verticals reflect the Advertiser's industry.
Advertising ID Status
Indicates the status for the supplied Advertising ID:
- Valid
- Invalid
- Unknown
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)
- OpenRTB
- Not Applicable
App Bundle
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”.
Auction Type
Differentiates data for First and Second auction. Trust but Verify Double Auction in reporting.
B
Brand
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.
Buyer Organization
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.
C
Campaign
The Campaign name.
Campaign Goal
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'.
Campaign ID
The Campaign ID number.
Campaign IO Number
The Campaign IO number.
Carrier
Need definition.
Category
Need definition.
Conversion Event
Conversion Event name. Selecting this key will display conversions metrics data grouped by Conversion Event.
Creative
The Creative name.
Creative Advertiser
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.
Creative Category
Returns analytics that provide insights into how Advertiser/Brand/Category are performing/bidding on your inventory.
Creative ID
The Creative ID number.
Creative Duration
The duration of the video ad defined for the Creative.
D
Date
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.
Daypart
Part of day when ad runs, for example 6AM-12PM, 12PM-5PM.
Device Type
The type of device displaying the ad.
Digital Ad
Displays data organized by Digital Ad Name.
Double Auction Reason
Tracks down, why your ad was double requested.
E
External Creative ID
The external creative ID, received as part of the bid response.
F
First Party ID
The ID of the First Party.
G
Geo: Country
The country where the event occurred.
Geo: Region/DMA
The region where the event occurred.
Geo: State/Province
The state or province where the event occurred.
H
Hour
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.
I
J
K
L
M
Market Placement
The name of the market placement, which is unique to each publisher.
Marketplace
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.
Marketplace ID
The ID of the Marketplace.
Marketplace Reporting Type
The Marketplace type. Values include Private Marketplace, Video SSP Marketplace, and External Exchange.
Marketplace Type
The Marketplace SSP. Values include Video SSP Marketplace, ADX, BRX, SPOTX, LIVERAIL, etc.
Media
The site where the event occurred. Lists the domain (test.com), not the full URL (test.com/video-type).
Media ID
The exchange site ID number assigned to the domain.
Media Detected
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.
Media Language
Reports all language(s) attached to a media.
Media Topic
Reports all IAB topics attached to a media in the decreasing order of relevance.
Media Type
Reports on the type of media in the inventory source/marketplace connection. Values include Site, App, etc.
Month
The month when the event occurred. Select 'month' to see data broken down by month (January, February, etc.) within your date range.
N
O
Operating System (OS)
Values which map to "targetable" operating systems, including:
- Windows 8
- Windows 7
- Windows Vista
- Windows XP
- Mac OS X
- IOS
- Linux
- Android
- Other Operating Systems.
Organization
The name of the organization. (For example, if your organization is called 'Spade & Archer' this column will display 'Spade & Archer'.)
P
Placement Type
Every impression is assigned a placement type. This is a description of the type of placement where ad serving events occurred.
Player Type
Reports by player type:
- ADAPTV
- O2
- VPAID Flash
- VPAID JS
Note: Unknown - Refers to VAST only or VPAID Lite cases.
Priority Type
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.
Provider Name
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.
Publisher
Need definition.
Q
R
Recent Hour
All clients using Video SSP reporting can run all keys/metrics on real time data by using the key called
Recent Hour.
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.
- Example:
- 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.
S
Secure Flag
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.
Segment
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.
Seller Organization
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.
Setting Name
Displays the name of the Sessions Restriction within a Publisher Setting.
Setting ID
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.
T
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
U
V
Video Platform
The type of device used to display the ad, such as online video, mobile phone, tablet, TV or game consoles.
View Hour
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.
Viewability Opportunity
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.
VPAID Loads
Helps to find out how many times the player loaded Video SSP VPAID for filling the opportunity.
W
X
Y
Z