Network Publisher Video Analytics Report
Metrics in this report are affected by the the Partner Fees Breaking Change Notice.. For a summary of the changes, see the
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:
report_interval field in the JSON request can be set to one of the following:
end_datefields 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.
The hour of the auction.
Note: For impressions older than 100 days, the day will be returned rather than the hour.
The day of the auction.
The month of the auction.
|member_id||int||Yes||Yes||767||The ID of the member.|
The ID of the buying member.
The name of the buying member.
The ID of the advertiser.
The name of the advertiser.
The ID of the brand associated with a creative. For
The name of the brand associated with a creative. For
The number to identify the publisher.
The currency of the publisher.
The ID of the site.
Note: For impressions older than 100 days, the
The name of the site.
"Private deal for buyer 1085 with floor of $2.50"
The name of the deal.
The geographic country code.
The name of the country.
The ID of the placement.
Note: For impressions older than 100 days, placements will be aggregated into one row with -1 as the
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
"300x250 Business Code"
The custom code for the placement.
The site domain of an impression.
'343200656' (iOS) or
A targetable Apple App Store ID, Google Play package name, or Windows application ID.
|supply_type||string||Yes||Yes||mobile_web||The 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'.|
The playback method for the creative. See Playback Method below for possible values.
|video_context||string||Yes||Yes||"3"||When and where the video creative plays. See Video Context below for possible values.|
|video_player_size_id||string||Yes||Yes||"2"||The ID of the video player width. See Player Size below for possible values.|
The total number of impressions.
The total number of clicks across all impressions.
post_click_convs + post_view_convs
The total number of post-view and post-click conversions.
clicks / imps * 100
The rate of clicks to impressions.
total_convs / imps * 100
The rate of conversions to impressions.
Network revenue booked through direct advertisers and resold to real time buyers
(network_revenue / imps) x 1000
The network revenue per 1000 impressions.
The revenue paid out to the publisher (based on revshare or cpm).
During the breaking change period: network_revenue - publisher_revenue
During the breaking change period: The total net profit for the network.
(network_revenue / media_cost) - 1
To be deprecated. Network return on investment. Returned as a percentage, e.g., 0.94 = 94%
(revenue / imps) x 1000 ----- no errors
The revenue per 1000 impressions that were not errors.
(cost / imps) x 1000
The cost per 1000 impressions paid to direct and third-party publishers, including errors.
(cost / imps) x 1000 ----- no errors
The cost per 1000 impressions paid to direct and third-party publishers, not including errors.
(profit / imps) x 1000
To be deprecated. The profit per 1000 impressions.
The number of impressions you sold to other members.
|video_errors||int||23||errors||The total number of errors serving video impressions|
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.
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.
The total number of impressions that were measured for viewability.
The percentage of impressions that were viewable out of the total number of impressions measured for viewability. (Viewed Imps / View Measured Imps)
The percentage of impressions measured for viewability out of the total number of impressions. (View Measured Imps / Imps)
total_cost = media_cost + data_costs + partner_fees + commissions + serving_fees + publisher_revenue
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.
Note: We have added logic to prevent double counting third-party fees during the breaking change period.
|total_cost_ecpm||money||123.45||(total_cost/imps) * 1,000||The total cost per 1,000 imps.|
|total_cost_ecpc||money||123.45||total_cost/clicks||The total cost per click.|
|total_cost_ecpa||money||123.45||total_cost/conversions||The total cost per conversion.|
|network_profit_ecpm||money||123.45||((booked_revenue + reseller_revenue - total_cost)/imps) * 1,000|
Network profit per 1,000 imps.
|network_profit_ecpc||money||123.45||(booked_revenue + reseller_revenue - total_cost)/clicks|
Network profit per click.
|network_profit_ecpa||money||123.45||(booked_revenue + reseller_revenue - total_cost)/conversions|
Network profit per conversion.
|network_profit_margin||money||123.45||(booked_revenue + reseller_revenue - total_cost)/(booked_revenue + reseller_revenue)|
Network profit margin.
Video Playback Method
|1||Auto-play, sound on|
Auto-play, sound off
Auto-play, sound unknown
1. Create the JSON-formatted report request
2. POST the request to the Reporting Service
3. GET the report status from the Report Service
Make a GET call with the Report ID to retrieve the status of the report. Continue making this GET call until the
execution_status is "ready". Then use the report-download service to save the report data to a file, as described in the next step.
4. GET the report data from the Report Download Service
To download the report data to a file, make another GET call with the Report ID, but this time to the report-download service. You can find the service and Report ID in the
url field of the previous GET response. When identifying the file that you want to save to, be sure to use the file extension of the "format" that you specified in your initial POST.
If an error occurs during download, the response header will include an HTTP error code and message. Use -i or -v in your call to expose the response header.