This document defines the metrics that you can retrieve using the YouTube Analytics API. The metrics below are grouped in the following categories:
- View metrics
- Watch time metrics
- Engagement metrics
- Annotations metrics
- Earnings metrics
- Ad Performance metrics
View metrics
- views
- The number of times that a video was viewed. The YouTube Help Center provides additional information about how views are reported.
- 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
- The percentage of viewers who were logged in when watching your video.
Watch time metrics
- estimatedMinutesWatched
- The number of minutes that users watched videos for the specified channel, content owner, or video.
- averageViewDuration
- The average length, in seconds, of video playbacks.
- averageViewPercentage
- The average percentage of a video watched during a video playback.
Engagement metrics
- comments
- The number of times that users commented on a video. See the YouTube Help Center for more information.
- favoritesAdded
- The number of times that users marked a video as a favorite video. See the YouTube Help Center for more information.
- favoritesRemoved
- The number of times that users removed a video from their favorite video lists. See the YouTube Help Center for more information.
- likes
- The number of times that users indicated that they liked a video by giving it a positive rating.
- dislikes
- The number of times that users indicated that they disliked a video by giving it a negative rating.
- The number of times that users shared a video through the
Sharebutton. See the YouTube Help Center for more information. - subscribersGained
- The number of times that users subscribed to a channel. 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
videodimension or thefilterparameter to restrict the response to only include data for a particular video, thesubscribersGainedmetric will only include statistics from the specified video's watch page. - subscribersLost
- The number of times that users unsubscribed from a channel. Data for this metric is reported similarly to the
subscribersGainedmetric. 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 thevideodimension or thefilterparameter 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
- The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations.
- annotationCloseRate
- The ratio of annotations that viewers closed to the total number of annotation impressions.
Earnings metrics
- earnings
- The total estimated earnings (net revenue) from all Google-sold advertising sources for the selected date range and region. 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
grossRevenuemetric, this metric should not be confused with earnings, or net revenue, which factors in your share of ownership and revenue-sharing agreements.