5df41af511
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: Ian Alton <ian.alton@airbyte.io> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
3.2 KiB
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_viewscolumn 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:
- Select Connections in the main navbar and select the connection(s) affected by the update.
- Select the Schema tab.
- Select Refresh source schema to bring in any schema changes. Any detected schema changes will be listed for your review.
- Select OK to approve changes.
- Select Save changes at the bottom of the page.
- Ensure the Clear affected streams option is checked to ensure your streams continue syncing successfully with the new schema.
- 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.