Skip to content
Book a demo

Connect documentation

All documentation
Documentation

YouTube Analytics: Setup guide

On this page

This guide explains how to collect data from YouTube Analytics.

Introduction

For a list of the fields that you can collect from YouTube Analytics, see YouTube Analytics.

Limitations

Collecting data from YouTube Analytics comes with the following limitations:

  • The data of YouTube Analytics is made available daily, but a delay of a few days may occur. For more information, see the YouTube Analytics documentation.

  • Some data may only be available to specific roles and permissions. For example, users with the viewers role may not retrieve data from certain features of YouTube Studio. For more information, see the YouTube documentation.

  • YouTube Analytics data has a delay of approximately 48-72 hours for updates. This means the most recent data might not be immediately available.

  • For Bulk report types, historical data is only available for up to 30 days in the past, while daily reports can access data for the last 60 days.

  • Some metrics like impressions are not available via the YouTube Analytics API.

  • To collect yesterday’s data accurately, you need to use an offset of -1 day when configuring your date range.

Prerequisites

Before you start collecting data from YouTube Analytics, perform all of the following actions:

  • Ensure your account is assigned at least the role Viewer or has higher permissions. For more information on user permissions, see the YouTube documentation.

Creating a datastream to collect data from YouTube Analytics

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from YouTube Analytics.

Configuration: Choose the data you want to collect from YouTube Analytics

To choose what data to collect and customize the YouTube Analytics datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Data Type, select one of the following options:

    • Select Channel Report to collect data for a channel connected to your account.

    • Select Content Owner to collect data for a channel created by other content owners. When this option is selected, enter the respective ID in the Content owner ID field that appears below.

  3. In Report type, select the type of data to collect from YouTube Analytics. For more information on the report types, see Understanding data types, report types and reports.

  4. In Report, select the specific report to collect from YouTube Analytics.

  5. In Channels, select the channels for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  6. In Dimensions and Metrics, change the list of fields that you want to see in your data extract.

    If you select the User Geography by US Province report, you can also select the day dimension to retrieve data with daily granularity. When the day dimension is selected, the connector fetches data one day at a time, enabling historical backfill beyond the standard 60-day limit for daily reports. If day is not selected, the report aggregates province totals over the selected date range.

  7. In Insight traffic source type, select the traffic type for which you want to collect data. For more information, see the Google documentation.

  8. In Sorting, select how to sort the collected data.

  9. In Filter expression, enter filters to be applied when collecting data. For more information on using filters, see the YouTube Analytics documentation.

  10. In Video IDs, select a value table that contains the video IDs that you want to use in the filter.

Troubleshooting

I see an error message about an expired bulk report when fetching data from YouTube Analytics

The error message “The bulk reporting job has expired” indicates that the selected bulk report is no longer available from YouTube. Bulk reports are only available for a limited time after generation.

To resolve this issue, select a new report in your datastream settings.

Missing Video IDs

Some video IDs may occasionally be missing from fetched data. This is a known YouTube API issue affecting all users. Missing video IDs may appear in subsequent fetches while other IDs become missing. This must be fixed by YouTube.

Subscriber count discrepancies

YouTube changed subscriber count reporting. For channels with more than 1,000 subscribers, counts are rounded down to three significant figures. For example, 123,456 subscribers reports as 123,000.

Negative values for likes and dislikes

Negative values such as -1 for likes or dislikes indicate users removed their previous engagement (un-liked or un-disliked).

Partnership Program status errors

Error “We could not retrieve the selected metrics. Please verify your Youtube Partnership Program status [Forbidden]” means YouTube restricted access to ad-related metrics because no ads were purchased in a certain period. Remove ad-related metrics from your datastream configuration to resolve this issue.

Error fetching Content Owner reports

Error “The CMS user is not allowed to act on behalf of the specified content owner. Please verify the Content Owner ID is correct and that your account still has access to it. If you are unsure of the value, ask your YouTube partner manager.” means the Content owner ID is incorrect, or the account used for authorization does not have the necessary permissions to access Content Owner reports. Verify that the Content owner ID is correct and that the authorized account has the required access.

What’s next?