This guide will walk you through how to authenticate or reauthenticate the Google data sources in Supermetrics for Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and API.
Before you begin
Google Ads
- You'll need a Google Ads or manager account with Read Only access. Learn how to grant access to a Google Ads account or manage your accounts.
Google AdSense
- You'll need a Google AdSense account with at least an Admin user role. Learn how to manage user access to your account.
Google Ad Manager
- You'll need a Google Ad Manager account with at least the Trafficker role. API access must be explicitly enabled by the Administrator.
- Learn about role permissions and how to manage user roles, and how to enable API access.
Google Analytics & Google Analytics 4
- You'll need a Google Analytics account with at least Read & Analyze access to a Property and Views underneath. Learn more about user permissions and how to add users.
Google BigQuery
- You'll need You'll need BigQuery Data Viewer and BigQuery User role levels for the Dataset, and the BigQuery User role for the Project.
Google BigQuery field list types
- Simplified field list: Shows each unique field name just once, if it's present in multiple tables.
- Full-field list: Shows all columns from your tables in BigQuery.
- Simplified list: With join fields only — shows only the fields that are available for multiple data sources.
Google Campaign Manager 360
- You'll need a Google Account with an appropriate user role for the reporting content they need to see (this varies based on what the admin set for the role). Read more about user access in Google’s documentation.
- You might need API access for the account enabled by a Google representative or the Campaign Manager 360 support team. Learn more about API prerequisites.
Google Display & Video 360
- You'll need a Google Display & Video 360 account with at least a Standard or Admin user role. Learn how to manage user access.
Google My Business
- You'll need a Google Account with at least an Owner or Manager user role. Learn how to add and remove owners and managers.
- Please note that you can fetch only limited locations. Learn about usage limits on Google My Business API.
Google Search Ads 360
- You'll need a Google Search Ads 360 account with at least an Agency Manager or Advertiser Manager role. Learn how to add or remove users.
- Following Supermetrics' migration to a new Google Ads API in early 2022, it's no longer possible to pull Google Ads data from Search Ads 360 accounts. Remove any Search Ads 360 accounts from your queries to keep them running.
Google Search Console
- You'll need a Google Search Console account with Verified Owner or Delegated Owner access. Verify your site ownership.
For Excel users
If your team uses Supermetrics for Excel, you’ll see different options for managing and sharing data source connections in that destination. Learn more.
Instructions
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-in.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch to open the Supermetrics sidebar.
- Click Create new query.
- Under Data source, select your Google data source.
- Click Start.
- Choose a Google Account to sign in.
- Click Allow.
- Depending on your Google data source, select your accounts, views, advertisers, locations, ad clients, sites and query types, or dataset and field list type.
Google Analytics uses a different authentication flow in Data Studio than other Google data sources. Scroll down to Google Analytics to learn more.
Most Google data sources
- Open the Supermetrics data source gallery.
- Navigate to your Google data source and click Try.
- Click Authorize.
- If you're authenticating the data source for the first time, you'll be asked to log in to it. Click Allow.
- Click Authorize.
- Choose a Google Ads account to sign in.
- Click Allow.
- Depending on your Google data source, select your accounts, views, advertisers, locaations, ad clients, sites and query types, or dataset and field list type.
- Scroll down to the bottom of the page. To create a report with our template, select Use report template for new reports. To create a blank report, deselect this option.
- Click Connect on the top right-hand side.
- Click Create report.
- Click Add to report.
Google Ads and Google Analytics
- Open the Supermetrics data source gallery.
- Navigate to Google Analytics and click Try.
- Log in with the Google Account you use with Supermetrics. Click Authorize.
- Log in to the data source.
- Select the Google Ads or Google Analytics connections you want to use in your reports, or click Add new connection to connect a new account.
If you create a new connection, you'll be prompted to log in to Google before you continue. - Click Continue to Data Studio.
- Scroll down and adjust settings as you need. At the very bottom, you'll have the option to create a report with our template. Select or deselect Use report template for new reports to change this setting.
- If everything looks good, click Connect in the top-right corner.
- Click Create report.
- Click Add to report.
When you're ready, learn how to create your first Supermetrics query with Google data sources.
Add or remove a user account in Data Studio
- Click the edit icon next to the data source's name in the Data Studio sidebar.
- At the top left of the connection pane, click Edit connection.
- Scroll down to Parameters.
- Browse team, account, and license management options in the section beginning "To add more/manage accounts..."
Before you can authenticate the data source in Excel, you need to install the Supermetrics add-on.
- Open an Excel file.
- Click Data → Show Supermetrics
- Under Data source, select the data source.
- Choose to make this connection shared or private.
- Click Start.
- Choose a Google Ads account to sign in.
- Depending on your Google data source, select your accounts, views, advertisers, locations, ad clients, sites and query types, or dataset and field list type.
Explore our guides to set up data transfers to various destinations.
- BigQuery
- Data warehouses and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- The Supermetrics API
Reauthenticate the data source
Troubleshooting
- If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.