Keys And Filters Glossary

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?

  1. Navigate to Analytics > Reports > [+ New Report] to open the New Report window.
  2. In the Report Builder tab > Filter section set the time range to Today.
  3. 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


 

 

 

Have more questions? Submit a request