CData Python Connector for YouTube Analytics

Build 25.0.9440

AudienceRetention

This report measures a video's ability to retain its audience.

Columns

Name Type Dimension DefaultMetric DefaultDimension Description
ElapsedVideoTimeRatio String True True This dimension specifies the ratio of the elapsed portion of the video to the video's length.
CreatorContentType String True This dimension identifies the type of content associated with the user activity metrics in the data row. The allowed values are LIVE_STREAM, SHORTS, STORY, VIDEO_ON_DEMAND, UNSPECIFIED.
AudienceWatchRatio Double True The absolute ratio of viewers watching the video at the given point in the video.
RelativeRetentionPerformance Double True A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length.
StartedWatching Int64 The number of times a particular segment of the video was the first segment seen during a video playback.
StoppedWatching Int64 The number of times a particular segment of the video was the last segment seen during a video playback.
TotalSegmentImpressions Int64 The number of times a particular segment of a video was viewed.
Video String The Id of a YouTube video.
AudienceType String The dimension value identifies the type of traffic associated with the report data. Supported values are ORGANIC, AD_INSTREAM, and AD_INDISPLAY.
SubscribedStatus String This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video or playlist channel. Possible values are SUBSCRIBED and UNSUBSCRIBED. Note that the dimension value is accurate as of the time that the user activity occurs.
YoutubeProduct String This dimension identifies the YouTube service on which the user activity occurred. Data for this dimension is available as of July 18, 2015. The allowed values are CORE, GAMING, KIDS, UNKNOWN.
StartDate Date Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate Date End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9440