After signing up for Data Streams, you need to link your YouTube credentials to set YouTube as a data source.
Here’s how you do that:
Read more about linking your YouTube credentials here.
YouTube’s v2 API is very immature and there are many basic combinations of metrics and dimensions that don't work.
Check below for valid reports, and please refer to YouTube’s documentation for more reports available
Note: Keep in mind that many reports listed in their documentation are not valid and will not be supported by their API, like most reports involving the ‘Country’ dimension.
If you run into an error message when submitting a query, feel free to contact us on our website through our chat box, in the lower right corner. We'll get back to you in one business day.
Send us your error message, along with the specifics of your issue (screenshot of the complete query that generated the error) so we can replicate the error and troubleshoot it.
Report fields in these reports are characterized as either dimensions or metrics:
Basic user activity statistics
This report provides statistics related to users' actions on a channel. You can filter the report to only return data for a specific video or country.
This report provides user activity metrics for subscribed and unsubscribed viewers.
The ‘Live Or On Demand’ dimension cannot be used in conjunction with the ‘Average View Percentage’ metric.
As such, each of the following subsections lists two reports. One report supports the ‘Live Or On Demand’ dimension while the other supports the ‘Average View Percentage’ metric.
Playback details with ‘Live Or On Demand’ statistics
Playback details with ‘Average View Percentage’ metric
Video Playback Location Report
This report aggregates viewing statistics based on the manner in which viewers reached your playlist content. For example, it identifies the number of views that stemmed from a Google search.
This report aggregates viewing statistics based on the manner in which viewers reached your playlist content. For example, it identifies the number of views that occurred on mobile devices or game consoles.
This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of playlist views that occurred on Android devices or on PlayStations.
Operating system and device type
This report aggregates viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of playlist views that occurred on Android tablets or on Windows desktop devices.
This report lists the channel's top playlists based on the specified filtering and sorting criteria.
Ad performance reports provide impression-based metrics for ads that ran during video playbacks. These metrics account for each ad impression, and each video playback can yield multiple impressions.
The impression-based ad performance metrics are:
In addition, some video reports support the following playback-based ad performance metrics. However, these metrics are not included in ad performance reports.
Ad performance by ad type