YouTube Integration
YouTube gives businesses a powerful way to reach their audience and hit marketing goals through video content. With the AgencyAnalytics YouTube integration, you can analyze video campaigns, track performance metrics, and see how viewers engage with your content.
Track video performance metrics in one place
Analyze campaign results alongside your other data sources
Monitor viewer engagement over time
Keep in mind:
There's a 2 to 3-day delay in data from the YouTube API
Subscriber history isn't available from YouTube
View all available YouTube metrics to see what's possible with the YouTube integration.
Before You Start
To avoid a failed connection or error when connecting YouTube to a client, the person connecting must have one of the following:
Owner permissions for the YouTube channel itself
Access via a YouTube brand account with a manager role
Note that being added as a manager from youtube.com/studio is not the same as having manager access to the brand account. The account owner must invite the user directly through myaccount.google.com/brandaccounts.
Connect YouTube
If the permission requirements above are met, follow these steps to connect YouTube to a client:
Step 1: Open the client where you'd like to connect YouTube, then click the Data tab at the top.
Step 2: Click the blue Connect Data Source button in the upper right corner of the page.
Step 3: Search for YouTube in the search bar at the top, then click the YouTube card.
Step 4: Click Connect New Account to launch the authorization window. If you've previously connected an account, click the gray Plus (+) sign at the bottom instead.
Step 5: Follow the prompts in the OAuth window to verify and finalize the connection.
Step 6: Once connected, select the specific customer account from the connections list by checking the box to the left of the account name.
Step 7: Click Connect in the bottom left corner to finish the integration process.
YouTube FAQ
How can I verify that my brand account is correctly set up?
Step 1: Sign in to the Google account you're using for the connection.
Step 2: Visit your Google Brand Accounts page (search for "Google Brand Accounts" in your browser).
Step 3: Confirm the channel is a brand account and that your user is listed and linked.
Step 4: If not, request Owner access or have the Owner add your account to the brand account.
How do I connect YouTube with an Owner or Manager role, and how do I add users?
Once an account is set up as a brand account, it can be automatically connected in AgencyAnalytics by the owner or by a user with manager access.
To connect as an owner, your client can share their YouTube login details with you, which grants you ownership access to the account. However, this isn't ideal from an account security standpoint.
To connect with manager access instead, create a manager role under myaccount.google.com/brandaccounts.
This is different from managing channel permissions inside YouTube Studio. If a user is invited to a brand account as a manager under YouTube Studio channel permissions, that channel won't be available via the YouTube API or in the YouTube integration. To connect the integration with a manager role, use channel permissions to manage user access to your channel instead.
If you're using a brand account role to add users instead of channel permissions and you're having trouble, you may need to opt out of channel permissions and opt back in later. Using a brand account role to add users isn't recommended.
To use your brand account instead of channel permissions to add users, you must invite all users to the brand account again. To opt out of channel permissions, go to YouTube Studio and open Settings > Permissions. See more about how to opt out of channel permissions.
How do I add roles to my brand account?
Step 1: Go to the Brand Accounts section of your Google Account.
Step 2: Under Your Brand Accounts, select the account you want to view.
Step 3: Select Manage permissions. You'll see a list of people who can manage the account, including owners.
How do I invite new people to a brand account?
Step 1: Choose Invite new users.
Step 2: Enter their email addresses.
Step 3: Below their names, choose their role:
Owners can take the most actions and control who manages the account. An account must have one primary owner
Managers can use Google services that support brand accounts, such as sharing photos on Google Photos or posting videos on YouTube
Step 4: Tap Invite, then Done.
How do I check if a Google account is linked to a brand account?
Login credentials for an Owner account aren't always available when connecting the YouTube integration. Customers usually connect with a Google account linked to a brand account instead.
Step 1: Log in to the Google account you're attempting to connect to the YouTube integration.
Step 2: Go to https://myaccount.google.com/brandaccounts.
Step 3: Check whether the account is already linked to a brand account. If it is, it will show up under "Your Brand Accounts."
If you only see "Pending Invitations," "Email Preferences," and "Deleted Accounts" options and don't see "Brand Accounts" listed, your current account hasn't been linked to a brand account yet.
Why isn't my client's account available in the connection list?
This is usually due to incorrect permissions or a brand account linkage issue. Double-check that the Google account you selected during authorization is the one with access to your client's account. If needed, you can reauthorize the integration connection.
Also, confirm the channel is a brand account and that your user is listed and linked. If not, request Owner access or have the Owner add your account to the brand account.
Why can't I see historical views from YouTube?
This usually happens when the AgencyAnalytics client start date doesn't match the YouTube channel's join date. Open the client, click the cog icon in the sidebar to open settings, then under Client details, change the start date to match your client's YouTube join date.
Why doesn't my YouTube Views widget change when I update the reporting period?
The YouTube Views table widget displays all-time totals and isn't affected by the selected report date range. If you need view counts for a specific reporting period, use the Channel-Analytics version of the widget instead, which follows the selected date range.
Why aren't some YouTube videos appearing in my AgencyAnalytics account?
Videos that aren't included in a playlist on the YouTube channel aren't fetched by the YouTube API. Create a playlist and add the videos to it to fix this.
Why can't I see impressions data in YouTube?
YouTube's API doesn't provide impressions data, so this metric isn't available in the YouTube integration.
Are YouTube Shorts supported?
YouTube Shorts aren't currently supported in the YouTube integration. As a workaround, create a playlist that includes your Shorts. Once that playlist is added to AgencyAnalytics, the Shorts will display.
Why doesn't the Total Subscribers metric change when I update the date range?
Total Subscribers reflects all-time data and isn't affected by the selected reporting period.
What to Check Out Next
Reauthorize or reconnect a data source by reading this guide on reauthorizing or reconnecting a data source
Explore all available YouTube metrics by visiting the YouTube metrics explorer
đŹ Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help đ


