Ads

{{ COMPANY_NAME }} provides these reports for analyzing ad performance: Ad Delivery, Errors Summary, and Error Details.

Ad Delivery

The Ad Delivery report provides the following analytics related to ad delivery: OVERVIEW, AD IMPRESSIONS BY ENVIRONMENT, ADD IMPRESSIONS BY OTT DEVICE GROUP, OVERVIEW BY DEMAND PARTNER.

OVERVIEW

Analyze core ad-related analytics.

Analytic	Details
AD BREAKS	The number of ad breaks that was triggered as a result of playback. `vod` or `live` indicates the current Playback Type selected.
OPPORTUNITIES	`live` Playback Type only. The total number of ad opportunities that was requested. The calculation of this statistic is based on the assumption that each ad has a duration of 30 seconds.
AD COUNT	`vod` Playback Type only. The total number of ads served across all ad breaks.
IMPRESSIONS	The total number of ads that was served.
REQUESTED BREAK DUR	The total number of hours of ad break duration requested from ad decision servers. As part of an ad request, Uplynk indicates the duration of the ad break to the ad decision server. The ad decision server uses this information to determine how much time needs to be filled with ads.
RESPONSE BREAK DUR	The total number of hours for the ad creatives that our service prepared for stream insertion. This metric omits response durations associated with ad break requests whose duration is 0.
FILL RATE	`live` Playback Type only. The percentage of ads that was served. This statistic is calculated using the following formula: `Fill Rate = (Ad Impressions / Opportunities ) * 100`
AVG AD COUNT	`vod` Playback Type only. The average number of ads served per ad break.
100% VIEW RATE	The percentage of ads that was viewed to completion.
COMPLETION RATE	The percentage of ad breaks that was viewed to completion.
AD SERVER FILL RATE	The percentage of ad break duration that was filled. This statistic is calculated using the following formula: `Ad Server Fill Rate = (Response Break Dur / Requested Break Dur) * 100`
AD HOURS	The total number of hours of ad content delivered. This metric helps quantify the cumulative duration of all advertisements shown across your content.

AD IMPRESSIONS BY ENVIRONMENT

Breaks down the number of ads that were served by environment (e.g., CTV, Mobile App, or Desktop).

AD IMPRESSIONS BY OTT DEVICE GROUP

Breaks down the number of ads that were served by OTT device category (e.g., OTT & Streaming Media Player, Smart TV, Smartphone & Tablet, or Desktop).

OVERVIEW BY DEMAND PARTNER

Breaks down ad requests and responses for each of your ad demand partners.

Errors Summary

The Errors Summary report provides the following analytics for ad breaks that did not contain ads due to errors and timeouts:

OVERVIEW

Analyze analytics on ad errors and timeouts.

Analytic	Details
AD BREAK SUCCESS	The total number of ad breaks that successfully served at least one ad.
AD BREAK ERRORS	The number of ad breaks that did not contain ads due to an error.
AD BREAK TIMEOUTS	The number of ad breaks that did not contain ads due to the amount of time it took to receive a response from the ad decision server.
AD BREAK TOTAL	The number of ad breaks.
AD REQUEST ERROR RATE	The percentage of ad requests that did not return an ad due to an error.
AD BREAK TIMEOUT RATE	The percentage of ad breaks that did not contain ads due to the amount of time it took to receive a response from the ad decision server.

AD BREAK ERRORS & TIMEOUTS BY ENVIRONMENT

Breaks down ad breaks that did not contain ads due to an error or timeout by the type of device (e.g., CTV, Mobile App, and Desktop).

AD BREAK ERRORS & TIMEOUTS TREND

This line chart contains color-coded lines that track over time the number of ad breaks that did not contain ads due to an error or timeout.

Error Details

The Errors Details report provides the following analytics for ad errors:

AD REQUEST TRANSACTION SUMMARY

Breaks down ad errors by third-party ad provider (i.e., demand partner).

Analytic	Details
Demand Partner	A third-party ad provider by name.
Requests	The total number of ad requests submitted to a third-party ad provider.
Errors	The total number of ad requests that resulted in an error.
Time Outs	The total number of ad requests that failed due to a connection timeout. This means that the ad decision server took too long to provide a response.
Fail % of Requests	The percentage of ad requests that failed.
Fail % of Total Requests	The percentage of total ad requests that failed.

DEMAND PARTNER BREAKDOWN

Hover over the slices in this pie graph to view the number and contributing percentage of requests by demand partner.

ERROR TRANSACTION BREAKDOWN

Analytic	Details
Account Name	An Uplynk account by name.
Request Type	Indicates whether the error occurred with the initial request to the ad decision server or a wrapper request spawned from it. Main Provider: Initial request. Wrapper: Wrapper request.
Demand Partner	A third-party ad provider by name.
Error Message	A brief description for the error.
Error Category	The type of error that occurred.
Count	The number of ad requests that resulted in a specific type of error for the current third-party ad provider.
Total Errors	The percentage of ad requests that resulted in a specific type of error for the current third-party ad provider.
Fail % of Total Errors	The percentage of ad requests that resulted in a specific type of error for the current third-party ad provider.
Fail % of Total Requests	The percentage of total ad requests that failed.

ERROR TREND

This line graph plots ad error categories over time.

Ad Error Categories

Each error type is briefly described below.

Error	Details
Connection	An issue occurred when establishing a connection to the ad decision server. For example, an error occurred during the TLS handshake error or the ad decision server returned a non-`200` response.
Encode Decode	An encoding or decoding issue occurred with the response provided by the ad decision server. For example, an incomplete ad response may cause this type of error.
Invalid Url	The ad decision server provided an invalid URL for the ad wrapper.
Large Content	The response from the ad decision server exceeded our file size requirements.
No Ads	An ad creative was not included in the response provided by the ad decision server.
No Media File	The response provided by the ad decision server did not contain a media file.
Time Out	The third-party ad server took too long to provide a response.
Undefined	An error that does not match any of the above categories occurred.