YouTube Analytics is the one connection with nothing to configure on your side. There is no host, port, database or password — you authorize climpt through OAuth 2.0 with a read-only scope, and that is the whole setup.
What you need
- Google account
- One with access to the channel you want to analyse.
- Channel role
- Owner or manager. Viewer access is not enough to read analytics.
- OAuth scope
yt-analytics.readonly, requested automatically. It permits reading analytics reports and nothing else — no change to your channel is possible through it.
Connecting
- Name the connection in climpt.
- Click Connect with YouTube. A Google sign-in window opens.
- Review the permission request. It should read View YouTube Analytics reports for your YouTube content — read-only.
- Click Allow. The window closes and the connection is created.
- The data is queryable straight away.
Brand accounts
If the channel sits under a Brand Account, make sure you pick that account rather than your personal one during sign-in. Choosing the wrong one produces a connection that authorizes cleanly and returns no channel data.
What you can query
- Views and impressions — views, impressions, click-through rate.
- Watch time — total watch time, average view duration, audience retention.
- Subscribers — count, and gains and losses over time.
- Revenue — estimated revenue, RPM and CPM, if monetization is on.
- Demographics — age, gender and geography.
- Traffic sources — search, suggested, external and the rest.
- Engagement — likes, dislikes, comments and shares per video.
Worth knowing
- YouTube’s own data lags by 24 to 72 hours. Yesterday’s numbers are not final numbers.
- The API exposes up to 18 months of history.
- Tokens refresh automatically. You never need to re-authorize unless you revoke access.
- You can revoke it at any time at
myaccount.google.com/permissions. - Add one connection per channel you want to analyse.