Skip to main content
Feedback

YouTube walkthrough

Currently Supported:
  • YouTube API Version 1
  • YouTube Analytics Version 2
  • Dimensions API version 3

This integration lets you maximize the potential of YouTube analytics within Data Integration.

Connection

To connect the YouTube API with your destination, refer to YouTube documentation. Choose a Source connection after creating a connection.

Predefined reports

Data Integration provides a convenient entry point and recommended approach for accessing a range of predefined reports. Each report includes a concise data description, a list of customizable fields (if applicable), and the schema mapping.

Since these reports follow a standardized format, specific fields are restricted and can only be accessed through Custom Reports.

Custom reports

There are three primary types of reports available within Data Integration for YouTube integration:

  • Static Report
  • Dimensions
  • Analytics Report

Static reports

These reports provide mappings of IDs from analytics reports to their corresponding names. You can select the required sub-report to facilitate data interpretation and analysis.

Dimensions

Dimensions expand on the data obtained from analytics reports, letting you select specific dimensions required and specific parts to retrieve, enhancing data granularity and analysis capabilities.

Analytics reports

The Analytics Report serves as the primary data source from YouTube, providing insights into various metrics, including annotations and user activity. YouTube generates sub-reports, with each report containing data for a unique 24-hour period, spanning from 12:00 a.m. to 11:59 p.m. Pacific time.

Business Date type

The "Pull changes only" feature enables the River to retrieve only reports created after the last run, enhancing efficiency in data extraction. Select this checkbox to ensure that the River fetches only new reports generated after the date of the previous run. When left unchecked, all reports within the chosen time frame will be retrieved, regardless of whether they were previously downloaded.

Time period selection

You can select either a custom date range or predefined time periods (Yesterday, Last week) for report extraction. When opting for a custom date range, the start date automatically updates with the end date after each run, facilitating seamless data retrieval.

Time zone consideration

The timezone offset selection ensures accurate date representation when the end date is empty, enabling precise determination of the river's runtime.

note
  • Start Date is mandatory.
  • Data can be retrieved for the date range specified between the start and end dates.
  • If you leave the end date blank, the data will be pulled at the current time of the river's run.
  • Date timezone: UTC.
  • The Start Date does not advance if a River run is unsuccessful. If you want to turn off this default setting, click More Options and select the checkbox to advance the start date even if the River run is unsuccessful (Not recommended).
  • Use the Last Days Back For Each Run option to gather data from a specified number of days before the selected start date.
info

Reports in Data Integration does not generate until a corresponding job is created on YouTube. After executing the River, Data Integration automatically initiates jobs for all reports. It may take up to 24 hours for YouTube to start generating the report data. You may encounter a "No Data Return" warning during this period.

Limitations

There are certain limitations associated with YouTube integration:

  • YouTube does not generate reports for the current open day in Pacific time (UTC -7).
  • Reports for the previous day are typically generated at the end of the current day in Pacific time, leading to potential delays depending on the user's timezone.
  • Daily API reports and backfill reports are available for 60 days from their generation, while historical data reports are accessible for 30 days.
On this Page