YouTube

Metrics

This document defines the metrics that you can retrieve using the YouTube Analytics API. The metrics below are grouped in the following categories:

  1. View metrics
  2. Watch time metrics
  3. Engagement metrics
  4. Annotations metrics
  5. Earnings metrics
  6. Ad Performance metrics

Core metrics

While the YouTube Analytics API is subject to the Deprecation Policy defined in the Terms of Service, non-core metrics (and non-core dimensions) are not subject to the policy. In the definitions on this page, any metric that is a core metric is explicitly identified as such. The following list also identifies the API's core metric:

See the list of YouTube APIs subject to the Deprecation Policy for more information.

View metrics

views (core metric)
The number of times that a video was viewed. The YouTube Help Center provides additional information about how views are reported. This is a core metric and is subject to the Deprecation Policy.

uniques
The number of unique viewers that watched a video. This calculation is based on the number of unique cookies and, therefore, will overcount users who are using multiple devices or browsers.

viewerPercentage (core metric)
The percentage of viewers who were logged in when watching your video. This is a core metric and is subject to the Deprecation Policy.

Watch time metrics

estimatedMinutesWatched (core metric)
The number of minutes that users watched videos for the specified channel, content owner, or video. This is a core metric and is subject to the Deprecation Policy.

averageViewDuration (core metric)
The average length, in seconds, of video playbacks. This is a core metric and is subject to the Deprecation Policy.

averageViewPercentage
The average percentage of a video watched during a video playback.

Engagement metrics

comments (core metric)
The number of times that users commented on a video. See the YouTube Help Center for more information. This is a core metric and is subject to the Deprecation Policy.

favoritesAdded (core metric)
The number of times that users marked a video as a favorite video. See the YouTube Help Center for more information. This is a core metric and is subject to the Deprecation Policy.

favoritesRemoved (core metric)
The number of times that users removed a video from their favorite video lists. See the YouTube Help Center for more information. This is a core metric and is subject to the Deprecation Policy.

likes (core metric)
The number of times that users indicated that they liked a video by giving it a positive rating. This is a core metric and is subject to the Deprecation Policy.

dislikes (core metric)
The number of times that users indicated that they disliked a video by giving it a negative rating. This is a core metric and is subject to the Deprecation Policy.

shares (core metric)
The number of times that users shared a video through the Share button. See the YouTube Help Center for more information. This is a core metric and is subject to the Deprecation Policy.

subscribersGained (core metric)
The number of times that users subscribed to a channel. This is a core metric and is subject to the Deprecation Policy.

A channel can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, the subscribersGained metric will only include statistics from the specified video's watch page.

subscribersLost (core metric)
The number of times that users unsubscribed from a channel. This is a core metric and is subject to the Deprecation Policy.

Data for this metric is reported similarly to the subscribersGained metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubcribe from a channel. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page.

Annotations metrics

annotationClickThroughRate (core metric)
The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. This is a core metric and is subject to the Deprecation Policy. The YouTube Help Center has more information about creating annotations and using link annotations.

annotationCloseRate (core metric)
The ratio of annotations that viewers closed to the total number of annotation impressions. This is a core metric and is subject to the Deprecation Policy.

Earnings metrics

earnings (core metric)
The total estimated earnings (net revenue) from all Google-sold advertising sources for the selected date range and region. This is a core metric and is subject to the Deprecation Policy.

Estimated earnings are subject to month-end adjustment and do not include partner-sold and partner-served advertising. All earnings figures are reported in USD.

Ad performance metrics

monetizedPlaybacks
The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%.

playbackBasedCpm
The estimated gross revenue per thousand playbacks.

impressions
The number of verified ad impressions served.

impressionBasedCpm
The estimated gross revenue per thousand ad impressions.

grossRevenue
The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range and region. Gross revenue is subject to month-end adjustment and does not include partner-served advertising. Gross revenue should not be confused with earnings, or net revenue, which factors in your share of ownership and revenue-sharing agreements.

primaryAdGrossRevenue
During many video playbacks, more than one ad will be shown. This metric sums all of the gross ad revenue, in USD, for the playback and classifies it under the playback's primary ad type. (Again, gross revenue refers to revenue from all Google-sold or DoubleClick-partner-sold advertising.) Typically, the primary ad type is the type of the most expensive ad shown during the playback. Like the grossRevenue metric, this metric should not be confused with earnings, or net revenue, which factors in your share of ownership and revenue-sharing agreements.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.