Skip to end of metadata
Go to start of metadata

Network Publisher Video Analytics Report

Metrics in this report are affected by the the release of partner fees from August 6-October 6, 2019. For a summary of the changes, see the Partner Fees Breaking Change Notice.

 

The Network Publisher Video Analytics report can be used to view video event metrics for specific publisher within your network that is more granular than the data provided in the Network Video Analytics report. This report is available to network users only. 

Video metrics are recorded for VAST creatives only.

For usage instructions, see the Example below. Note that this report requires that a publisher ID be specified as part of the URL, for example:

On This Page

Time Frame

The report_interval field in the JSON request can be set to one of the following:

  • today
  • yesterday
  • last_24_hours
  • last_48_hours
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • month_to_yesterday
  • last_available_day
  • last_7_available_days
  • last_14_available_days
  • last_30_available_days
  • last_month

To run a report for a custom time frame, set the start_date and end_date fields in your report request. For more details about these fields, see Report Service.

Data Retention Period

Data in this report is retained for 14 months.

Dimensions

Column

Type

Group?

Filter?

Example

Description

hour

date 

yes

no

"2010-02-01 06:00:00"

The hour of the auction.

Note: For impressions older than 100 days, the day will be returned rather than the hour.  

day

date 

Yes

no

"2010-02-01"

The day of the auction.

month

date 

yes

no

"2010-02"

The month of the auction.

member_idintYesYes767The ID of the member.

buyer_member_id

int

yes

yes

567

The ID of the buying member.

buyer_member_name

string

no

no

"Network"

The name of the buying member.

advertiser_id

int

yes

yes

728

The ID of the advertiser.

advertiser_name

string

no

no

"Test"

The name of the advertiser.

brand_id

int

yes

yes

3

The ID of the brand associated with a creative. For imp_type_id  = 6, no information is available in the  brand_id  field for this report. See the Seller Brand Review Report  instead.

brand_name

string

no

no

"Ace Hardware"

The name of the brand associated with a creative. For imp_type_id  = 6, no information is available in the  brand_name  field for this report. See the Seller Brand Review Report  instead.

publisher_id

int

yes

yes

6787

The number to identify the publisher.

publisher_currency

string

yes

yes

"USD"

The currency of the publisher. 

site_id

int

yes

yes

194

The ID of the site.  

Note: For impressions older than 100 days, the site_id will be 0 .

site_name

string

no

no

"Site Name"

The name of the site.

deal_id

int

Yes

Yes

2345

The ID of the deal. For more information about negotiated deals between buyers and sellers, see Deal Service and Deal Buyer Access Service.

deal_name

string

No

No

"Private deal for buyer 1085 with floor of $2.50"

The name of the deal.

geo_country

string

yes

yes

"US"

The geographic country code.

geo_country_name

string

no

no

"United States"

The name of the country.

placement_id

int

yes

yes

546

The ID of the placement.  

Note:  For impressions older than 100 days, placements will be aggregated into one row with -1 as the placement_id.

placement_name

string

no

no

"300x250 Business"

The name of the placement.  

Note:  For impressions older than 100 days, placements will be aggregated into one row with "All placement data older than 100 days" as the placement_name.

placement_code

string

no

no

"300x250 Business Code"

The custom code for the placement.

site_domain

string

yes

no

bestsiteever.com

The site domain of an impression.

application_idstringYesYes

'343200656' (iOS) or

'com.rovio.angrybirds'

(Android)

A targetable Apple App Store ID, Google Play package name, or Windows application ID.

supply_typestringYesYesmobile_webThe seller-classified channel to denominate supply in terms of web, mobile-optimized web, and mobile app impressions. Possible values are 'web', 'mobile_app', and 'mobile_web'.
video_playback_methodstringYesYes"1"

The playback method for the creative. See Playback Method below for possible values.

video_contextstringYesYes"3"When and where the video creative plays. See Video Context below for possible values.
video_player_size_idstringYesYes"2"The ID of the video player width. See Player Size below for possible values.

Metrics

Column

Type

Example

Formula

Description

imps

int

2340

imps

The total number of impressions.

clicks

int

545

clicks

The total number of clicks across all impressions.

total_convs

int

90

post_click_convs + post_view_convs

The total number of post-view and post-click conversions.

ctr

double

0.2327836

clicks / imps * 100

The rate of clicks to impressions.

convs_rate

double

0.0384413

total_convs / imps * 100

The rate of conversions to impressions.

network_revenue

money

1201.13

network_revenue

Network revenue booked through direct advertisers and resold to real time buyers

total_network_rpm

money

2.60548314606741

(network_revenue / imps) x 1000

The network revenue per 1000 impressions.

publisher_revenue

money

400.05

publisher_revenue

The revenue paid out to the publisher (based on revshare or cpm).

network_profit

money

801.08

Today-October 5, 2019: network_revenue - publisher_revenue
October 5, 2019: (booked_revenue + reseller_revenue) - total_cost

Today-October 5, 2019: The total net profit for the network.
October 6, 2019: Network profit minus total cost.

network_roi

double

2.94

(network_revenue / media_cost) - 1

To be deprecated October 6, 2019. Network return on investment. Returned as a percentage, e.g., 0.94 = 94%

sold_network_rpm

double

231.888

(revenue / imps) x 1000 ----- no errors

The revenue per 1000 impressions that were not errors.

total_publisher_rpm

money

1.6605168
5393258

(cost / imps) x 1000

The cost per 1000 impressions paid to direct and third-party publishers, including errors.

sold_publisher_rpm

double

147.786

(cost / imps) x 1000 ----- no errors

The cost per 1000 impressions paid to direct and third-party publishers, not including errors.

network_ppm

money

9.23

(profit / imps) x 1000

To be deprecated October 6, 2019. The profit per 1000 impressions.

imps_sold

int

42500

imps_sold

The number of impressions you sold to other members.

video_errorsint23errorsThe total number of errors serving video impressions
ad_responsesint2340served

The number of responses delivered to the user's browser (or mediating server). A response can result in an impression, an error in player, or an auction with no impression event.

An imp refers to when the video player loads the video and starts the first frame. Videos Served refers to the VAST document being served in response to a request from the video player.

imps_viewed

int

30,450

imps_viewed

The number of measured impressions that were viewable, per the IAB Viewability definition, which states that an impression is viewable if 50% of the pixels are in-view during 1 consecutive second.

view_measured_imps

int

10,120

view_measured_imps

The total number of impressions that were measured for viewability.

view_rate

double

58%

view_rate

The percentage of impressions that were viewable out of the total number of impressions measured for viewability. (Viewed Imps / View Measured Imps)

view_measurement_rate

double

45%

view_measurement_rate

The percentage of impressions measured for viewability out of the total number of impressions. (View Measured Imps / Imps)

total_costmoney123.45

total_cost = media_cost + data_costs + partner_fees + commissions + serving_fees + publisher_revenue

Note: We have added logic to prevent double counting third-party fees during the breaking change period (August 6 - October 6, 2019).

Forthcoming August 6, 2019. The total amount of costs accrued over the reported period of time. This generally includes two types of costs, budgeted costs (media cost, data cost, partner fees, serving fees, commissions) and publisher revenue if you track publisher payouts on the platform.
total_cost_ecpmmoney123.45(total_cost/imps) * 1,000 Forthcoming August 6, 2019. The total cost per 1,000 imps.
total_cost_ecpcmoney123.45total_cost/clicks Forthcoming August 6, 2019. The total cost per click.
total_cost_ecpamoney123.45total_cost/conversions Forthcoming August 6, 2019. The total cost per conversion.
network_profit_ecpmmoney123.45(network_profit/imps) * 1,000

Forthcoming August 6, 2019. Network profit per 1,000 imps.

Note: This new field defines "network profit" as the sum of booked revenue and reseller revenue minus total cost.

network_profit_ecpcmoney123.45network_profit/clicks

Forthcoming August 6, 2019. Network profit per click.

Note: This new field defines "network profit" as the sum of booked revenue and reseller revenue minus total cost.

network_profit_ecpamoney123.45network_profit/conversions

Forthcoming August 6, 2019. Network profit per conversion.

Note: This new field defines "network profit" as the sum of booked revenue and reseller revenue minus total cost.

network_profit_marginmoney123.45network_profit/(booked_revenue + reseller_revenue)

Forthcoming August 6, 2019. Network profit margin.

Note: This new field defines "network profit" as the sum of booked revenue and reseller revenue minus total cost.

 

 

Video Playback Method

Method ID

Method

0

Unknown

1Auto-play, sound on

2

Auto-play, sound off

3

Click-to-play

4

Mouse-over

5

Auto-play, sound unknown

Video Context 

Method ID

Method

0

Unknown

1

Pre-roll

2

Mid-roll

3

Post-roll

4

Outstream

Player Size

ID

Name

0

small

1

medium

2

large

Example

1. Create the JSON-formatted report request
2. POST the request to the Reporting Service
3. GET the report status from the Report Service
4. GET the report data from the Report Download Service
  • No labels