YouTube Analytics Migration Guide

Upgrading to 1.0.0

Version 1.0.0 updates the connector to use the latest versions of YouTube's Bulk Reports API in response to YouTube's Shorts view-counting change. YouTube announced the change on March 26, 2025, Shorts view counting changed on March 31, 2025, and the Bulk Reports API was updated on June 30, 2025. See the YouTube API revision history for details.

What changed

YouTube updated how views are counted for Shorts:

• For Shorts: Views now count the number of times a Short starts to play or replay, with no minimum watch time requirement.
• For videos: No change to how views are counted.
• New metric: A new engaged_views column has been added to reports, which reflects the previous view-counting methodology.

As a result of this change, each affected report's version has incremented by one (for example, version a2 to version a3 for channel reports, and a1 to a2 for playlist reports). See the YouTube API revision history for complete details.

Important: previous report versions were deprecated on October 31, 2025. You must upgrade to version 1.0.0 to continue syncing YouTube Analytics data.

New stream names

Old Stream	New Stream
channel_basic_a2	channel_basic_a3
channel_combined_a2	channel_combined_a3
channel_device_os_a2	channel_device_os_a3
channel_playback_location_a2	channel_playback_location_a3
channel_province_a2	channel_province_a3
channel_subtitles_a2	channel_subtitles_a3
channel_traffic_source_a2	channel_traffic_source_a3
playlist_basic_a1	playlist_basic_a2
playlist_combined_a1	playlist_combined_a2
playlist_device_os_a1	playlist_device_os_a2
playlist_playback_location_a1	playlist_playback_location_a2
playlist_province_a1	playlist_province_a2
playlist_traffic_source_a1	playlist_traffic_source_a2

Migration Steps

Refresh source schemas and clear data

Clearing your data is required for the affected streams to continue syncing successfully. To clear your data for the affected streams, follow the steps below:

1. Select Connections in the main navbar and select the connection(s) affected by the update.
2. Select the Schema tab.
   1. Select Refresh source schema to bring in any schema changes. Any detected schema changes will be listed for your review.
   2. Select OK to approve changes.
3. Select Save changes at the bottom of the page.
   1. Ensure the Clear affected streams option is checked to ensure your streams continue syncing successfully with the new schema.
4. Select Save connection.

This will clear the data in your destination for the subset of streams with schema changes. After the clear succeeds, trigger a sync by clicking Sync Now. For more information on clearing your data in Airbyte, see this page.