YouTube API Report

How to link your YouTube credentials, reports, and parameter blacklist/restrictions in Data Streams.

How to Link Your YouTube Credentials in Data Streams

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:

  1. Click ‘SET DATA EXTRACT SOURCE.’
  2. Choose ‘YouTube’ from the drop-down menu.
  3. After choosing your platform, click ‘Link.’
  4. Insert your Google credentials that have access to the YouTube account you want to set as a Data Source.
  5. Grant the app permission to access your Google data by clicking ‘Allow.’

*For more info regarding security and the information the connector collects, please refer to our Privacy Policy.

Read more about linking your YouTube credentials here.

Limitations & errors

YouTube API limitations

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.

Reach out if you need help

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.

Reports

Report fields in these reports are characterized as either dimensions or metrics:

  • Dimensions are common criteria that are used to aggregate data, such as the date on which an action occurred or the country where the users were located. In a report, each row of data has a unique combination of dimension values.
  • Metrics are individual measurements related to user activity, ad performance, or estimated revenue. User activity metrics include things like video view counts and ratings (likes and dislikes).

Video reports

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.

2019-03-29_1815

User activity by subscribed status

This report provides user activity metrics for subscribed and unsubscribed viewers.

2019-03-29_1817-1

Playback details

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

2019-03-29_1819

Playback details with ‘Average View Percentage’ metric

2019-03-29_1819_001

Video Playback Location Report

2019-03-29_1821

Traffic source

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.

2019-03-29_1822

Device type and operating system

Device type

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.

2019-03-29_1825

Operating system

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.

2019-03-29_1826

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.

2019-03-29_1827

Viewer demographics

2019-03-29_1828

Top playlists

This report lists the channel's top playlists based on the specified filtering and sorting criteria.

2019-03-29_1829

Ad performance reports

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

2019-03-29_1829_001