Skip to end of metadata
Go to start of metadata

Video Events Feed

The Video Events Feed provides you with a listing of all video-specific events that occur on your video impressions. The feed contains one row per video event.

The AppNexus internal name for this feed is video_events_feed.

On This Page

Sequence

The columns below are listed in the same order in which they appear in the log-level feed file (top to bottom here, left to right in the file).

Integer Key

  • tinyint = 1 byte (8 bit)
  • smallint = 2 byte (16 bit)
  • int = 4 byte (32 bit)
  • bigint = 8 byte (64 bit)

Columns

Column Index

Column Name

Type

Description

Visibility
01
date_time
UNIX Epoch time

The time and date of the video event (e.g., 1526057561 which would need to be translated to Friday, May 11, 2018 4:52:41 PM (UTC) ).

Timestamps:  If your log-level data is provided in text format, timestamp field values will be supplied as a string (e.g., YYYY:MM:DD HH:mm:ss). If your log-level data is provided in protobuf format, the timestamp field values will be supplied in UNIX Epoch time.

Both
02
auction_id_64
bigintThe AppNexus unique auction identifier.Both
03
buyer_member_id
int

The member ID of the buyer.

  • For imp_type = 1 (Blank), the buyer_member_id and creative_id is 0.
  • For imp_type = 2 (PSA), the AppNexus PSA member_id displays.
  • For imp_type = 3 or 4 (Default Error or Default), the seller_member_id displays.
Both
04
seller_member_id
intThe member ID of the seller.Both
05
advertiser_id
intThe ID of the advertiser.Buyer
06
publisher_id
intThe ID for the publisher of the placement. Buyer member may map the Publisher ID to a name using the Inventory Resold Service if the seller has chosen to expose the publisher. Exposure to buyer depends on the seller's visibility profile.Both
07
site_id
intThe ID for site associated with placement. Cannot be associated with a name, except by the seller member who owns the site. Exposure to buyer depends on the seller's visibility profile.Seller
08
tag_id
intThe ID of placement tag of the impression. Cannot be associated with a name, except by the seller member who owns the tag. Exposure to buyer depends on the seller's visibility profile.Both
09
insertion_order_id
intThe ID for insertion order if used.Buyer
10
line_item_id
intThe identifier of line item.Buyer
11
campaign_id
intThe ID of the campaign.Buyer
12
creative_id
intThe ID of the creative served.Both
13
creative_freq
intThe creative-level frequency (times the user has seen this creative by this advertiser).Buyer
14
creative_rec
intThe creative-level recency in minutes (how long it has been since the user has seen this creative ad).Buyer
15
brand_id
intThe ID for brand of the creative.Both
16
country
string(2)The geographic country of the impression passed in on the ad call. Uses ISO 3166 country codes.Both
17
creative_width
smallintThe width of the creative.Both
18
creative_height
smallintThe height of the creative.Both
19
deal_id
intThe Deal ID associated with this impression.Both
20video_auctionboolean

Whether or not the video was served this hour

Both
21video_startedbooleanWhether or not the video was started this hourBoth
22video_was_skippedbooleanWhether or not the video was skipped this hourBoth
23video_had_errorbooleanWhether or not the video had an error this hourBoth
24video_hit_25_pctbooleanWhether or not the video hit 25 pct this hourBoth
25video_hit_50_pctbooleanWhether or not the video hit 50 pct this hourBoth
26video_hit_75_pctbooleanWhether or not the video hit 75 pct this hourBoth
27video_completedbooleanWhether or not the video completed this hourBoth
28
imp_type
tinyint

The type of impression. Possible values:
0 = Video event error
1 = Blank: "200 OK" response (blank) served.
2 = PSA: A public service announcement served because no other creative was eligible.
3 = Default Error: A default creative served due to timeout issue.
4 = Default: A default creative served because no campaigns bid or no other creative was eligible.
5 = Kept: One of your managed advertisers served a creative.
6 = Resold: The impression was sold to a third-party buyer.
7 = RTB: Your creative served on third-party inventory.
8 = PSA Error: A public service announcement served due to timeout issue.
9 = External Impression: An impression from an impression tracker.
10 = External Click: A click from a click tracker.

Both
29
advertiser_currency
string(3)The currency used by advertiser.Buyer
30
publisher_currency 
string(3)The currency in which publisher is paid.Seller
31site_domainstring(100)The most granular identifier of the site that we can offer (This may be the domain of a supply partner, ex: doubleclick.com ; network who owns resold inventory; or it may just say resold inventory). Exposure to buyer depends on the seller's visibility profile.Both
32application_idstringThe ID of the mobile application (if applicable). Exposure to buyer depends on the seller's visibility profile.Both
33

media_cost_cpm

numericFor buyers, the dollar amount * 1000 that a network is paying for the video impression associated to this video event. For sellers, the dollar amount * 1000 paid to publisher for the impression associated to this video event.Both
34booked_revenuenumericThe dollar amount earned by network on the impression associated with this video eventBuyer
35seller_revenue_cpmnumeric

The amount the seller is paid for the impression associated with this video event.

The impression_seller_revenue_cpm is also calculated for imp_type = 5 (managed impressions). If you wish to calculate total revenue from resold impressions, sum seller_revenue_cpm only for imp_type = 6.

Seller
36playback_methodenum

The type of initiation method. Possible values:
0 = Unknown
1 = Auto-play, sound on
2 = Auto-play, sound off
3 = Click-to-play
4 = Mouse-over
5 = Auto-play, sound unknown

 
37

video_context

enum

The type of context. Possible values:
0 = Unknown
1 = Pre-Roll
2 = Mid-Roll
3 = Post-Roll
4 = Outstream
5 = Bannerstream

 
38

player_size_id

tinyint

The size of the video player. Possible values:
0 = Unknown
1 = Small
2 = Medium
3 = Large

 
39supply_typeenum

The type of supply. Possible values:

  • 0 = Web
  • 1 = Mobile_Web
  • 2 = Mobile_App
 
40
view_result
enum

The AppNexus viewability measurement result of the impression. Possible values:
0 = VIEW_UNKNOWN
1 = VIEW_DETECTED
2 = VIEW_NOT_DETECTED
3 = VIEW_NON_MEASURABLE
-1 = UNKNOWN

For non-impression events, this will be NULL.

For more details about viewability, see Introduction to Viewability (Customer login required).

Both
41
view_non_measurable_reason
enum

The reason an impression could not be measured for viewability. Possible values:
0 = N/A. The impression was measured for viewability
1 = SCRIPT_NOT_SERVED. The viewability script was not served with the creative. For example, on mobile-app inventory.
2 = NO_SCRIPT_CALLBACK. The viewability script was served with the creative, but no callback/event was received. For example, the user left the page before the creative was served.
3 = TECHNICAL_LIMITATION. The viewability script was served and loaded, but was unable to measure for a technical reason. For example, a cross-domain iFrame with Flash disabled.
-1 = UNKNOWN

For more information regarding viewability, see Introduction to Viewability (Customer login required).

Both
42 error_code intFor a detailed description of error codes and their meanings, see the IAB's VAST 3.0 documentation or view the list of error codes below. 

Error Codes 

The table below shows a complete listing of error codes and their meanings. 

You may receive error codes in the feed that are not present in the list below. If you do, those error codes are generally non-VAST-compliant custom codes sent from the video player.

Error CodesDefinition
100XML parsing error.
101VAST schema validation error.
102VAST version of response not supported.
200Trafficking error. Video player received an ad type that it was not expecting and/or cannot display.
201Video player expecting different linearity.
202Video player expecting different duration.
203Video player expecting different size.
300General Wrapper error.
301Timeout of VAST URI provided in Wrapper element, or of VAST URI provided in a subsequent Wrapper element. Includes request errors such as invalid URI, unreachable or request timeout for URI, and security or other exceptions related to requesting a VAST URI.
302Wrapper limit reached, as defined by the video player. Too many Wrapper responses have been received with no InLine response.
303No ads VAST response after one or more Wrappers. Also includes number of empty VAST responses from fallback.
400General linear error. Video player is unable to display the linear ad.
401File not found. Unable to find Linear/MediaFile from URI.
402Timeout of MediaFile URI.
403Could not find MediaFile that is supported by this video player, based on the attributes of the MediaFile element.
405Problem displaying MediaFile.
500General NonLinearAds error.
501Unable to display NonLinear Ad because creative dimensions do not align with creative display area (i.e., creative dimension too large).
502Unable to fetch NonLinearAds/NonLinear resource.
503Could not find NonLinearresource with supported type.
600General CompanionAds error.
601Unable to display companion because creative dimensions do not fit within Companion display area (i.e., no available space).
602Unable to display Required Companion.
603Unable to fetch CompanionAds/Companion resource.
604Could not find Companion resource with supported type.
900Undefined error.
901General VPAID error.