Adding and authorizing Supermetrics connectors in Google Data Studio

This guide will show you the first steps to using Supermetrics for Data Studio – adding and authorizing a connector. This will create what is called a data source file that can be added to your Data Studio reports. 


This guide will show you how to authenticate Facebook Ads as an example. For specific instructions on authenticating a different data source, please see this list


1. Go to datastudio.google.com and log in with your Google account, if needed.


2. In the top left corner, go to Create → Data source.


3. Scroll down to the Partner Connectors section and look for the Supermetrics connector you want to use. Alternatively, you can use the search bar at the top. Click on the connector you want to use.


4. Click on the AUTHORISE button to give permission to the connector to access your Google account.

  • A pop-up will ask you to log in with your Google account – select the same account you use Data Studio with and click on Allow to accept the access request.

5. Click on the second AUTHORISE button to log in to the data source itself – in this example, Facebook Ads.

  • If you belong to multiple Supermetrics teams, a pop-up will ask you to select a team. Pick the team with your license to continue.

6. Follow the prompts to log in to the data source with the appropriate platform user account – in this example, it would be a Facebook user with access to the ad accounts you need for the report.

  • Some data sources may use your browser cookies to log you in automatically. If you don't want to automatically use that account, make sure to log out first in the browser version of the data source platform before proceeding.

7. Once the data source login is completed, return to the data source setup page. This is what Facebook Ads looks like, other data sources may look different:

Depending on your selected data source, select the accounts, views or pages you want to use. Enable any other required settings, and select whether to use a template with this data source, or start reports from scratch.


8. You can also update the name of the data source file to something informative, for example based on the selected account(s).

  • By default, the data source file will be the named based on the connector – in this example it would be saved as 'Facebook Ads' unless the name is edited.

9. In the top right corner, click on CONNECT to save the configuration as a new data source file.

10. You will be taken to the field list, where you can see all available dimensions and metrics of your data source file.

  • By default, you don't need to do anything here. If you want to make custom edits to your data source's field, see the article Editing data source fields.

Your data source file has now been created!

You can directly start using the data source in a new report by clicking on CREATE REPORT in the top right corner of the field list.


You can now also select it as a data source in your existing reports:


Continue to the next Getting Started guide:

Creating a report and charts with Google Data Studio »


Common Issues

  • If you find yourself in an authentication loop in steps 4-6, you may be affected by a known Google account management bug. See this guide for how to work around it: Authentication-, HTTP- or Script errors.
  • If you see the error "This action is not supported when you are signed in to multiple accounts..." (may be localized to your language), see this guide: This Action is Not Supported When You Are Logged in to Multiple Accounts.
  • If you get errors for no accounts or lack of access, you may need to check with your data source administrator, as the user account you are logging in with may not have required access permissions.
  • There may be specific login errors or missing account issues unique to certain data sources - check their section in the support portal to see if there's already a specific guide to help you: General Issues and Instructions Per Data Source

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.