This guide contains all permissions and requirements for connecting your YouTube data to Supermetrics.
You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.
After you connect to the data source on the Hub, you can use the data source connection in all available destinations.
If you're missing an account, skip to the Missing accounts section at the bottom of this page.
Required permissions
To connect YouTube to Supermetrics, you need these permissions:
Private accounts: Owner
Brand accounts: Manager
Learn how to find out which type of account you're using in Google's documentation.
For most types of accounts and channels, the account logging in needs to be the channel's owner.
Note that to pull monetization data, you need to be the owner of the Content Manager account or your YouTube channel must have monetization enabled.
Query types
Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data:
Videos performance: Fetches engagement data per video, for up to 1000 of the most recently published videos on the selected channel. Splittable by date.
Single video performance: Fetches engagement data per specific video, defined with a video ID. Splittable by date.
Channel overview: Performance data for the channel, such as subscribers, likes, and average view duration.
Geographies: Breakdown of viewer engagement by country and state
Demographic: Breakdown of viewer percentage by age and gender
Device: Breakdown of viewer engagement by device type and operating system
Traffic sources: Breakdown of viewer engagement by traffic source
Ad performance: Gross revenue and ad impressions for your channel, broken down by ad type
Connection instructions
When connecting to YouTube, you need to log in to YouTube and select the channels to use when prompted.
Select the YouTube data source on the Supermetrics Hub or in the data destination.
If prompted, choose to make this connection shared or private.
Click Sign in with Google.
Log in with the Google Account you use with YouTube and select an account or brand account to use.
Click Continue, and click Allow.
Select all access scopes and click Allow. Failure to select all may result in the data source not functioning correctly.
In your data destination, select the query type to use and add the channel ID or video ID to include in your query.
See detailed instructions on how to connect to a data source from the Supermetrics Hub.
You can also connect to YouTube from these destinations:
Data Studio: How to connect data sources to Data Studio
The Supermetrics API: How to use the Query Manager
Data warehouse and cloud storage (Hub): How to create a transfer
BigQuery (marketplace): How to create a BigQuery (marketplace) transfer
Missing accounts
If an account is missing from your available accounts in Supermetrics (including channels and videos), follow these steps:
Log in to YouTube Creator Studio with your original Google Account.
Navigate to Settings and then Permissions in the left-side menu.
Click Invite in the top right.
Add the new Google Account as the new user.
Create the new user as a Manager (if you're using a brand channel, Owner would also work). Click Invite.
Open the invitation email while logged in as the new user. Click Visit the sign-up page to accept the invitation.
Select Use existing Google Account.
Go back to the Supermetrics sidebar, and click Add connection.
Disconnecting YouTube and Supermetrics
If you want to disconnect your Google account used to access the Supermetrics YouTube data source connectors, follow these steps:
In the list of apps, click the Supermetrics app with the round icon (there may be several different Supermetrics apps linked).
Under Supermetrics has some access to your Google Account, click See details.
Click Remove all access.
Warning
Other Google data sources (such as Google Ads and Google Analytics) use this same app, so removing access will disconnect more than just your YouTube connection. If you wish to continue to use other Google data sources Supermetrics provides, you will need to reconnect each of those data sources again to continue service.