Supermetrics Support Forum

Adding and authorizing Supermetrics connectors in Google Data Studio

This guide will show the first steps to using a Supermetrics connector for Data Studio, which is to add and then authorize the connector. This will then create what is called a data source file that can be added to your Data Studio reports.

For these steps we will be showing Facebook Ads as the example, but these same basic steps work for almost all the Supermetrics connectors.

  1. Go to and log into your Google account, if needed.
  2. Click Start a new report->Blank.

    Orange arrow pointing to blank "new report" image in Data Studio dashboard

    • If you already have a Data Studio report you want to use, you can open that instead and continue the steps.
  3. Click on CREATE NEW DATA SOURCE at the bottom of the right-hand "Select Data Source" pane.

    Orange arrow pointing to option to "Create new data source" when appears when opening a new report

    • If using an existing report, click Resource->Manage added data sources->ADD A DATA SOURCE instead.
  4. Scroll down to the "Partner Connectors" section and look for the Supermetrics connector you want to enable. Alternatively, you can use the search bar at the top. For example, searching for Facebook Ads:

    Example search for Facebook ads in the partner connector list

  5. Hover over connector card and click SELECT to start the process of using that connector.

    Orange arrow pointing to blue "SELECT" button that appears when hovering over the connector

  6. Click the AUTHORIZE button to give permission to the connector to access your Data Studio account.

    Orange arrow pointing to first "AUTHORIZE" button to give Data Studio permissions

  7. A pop-up will ask you to log in with your Google account - select the same account you intent do use Data Studio with and then click Allow to accept the access request.

    Orange arrow pointing to blue "Allow" button to accept the access permissions Supermetrics needs to access DS

  8. Click the second AUTHORIZE button that appears to log into the data source itself (in this example, into Facebook).

    Orange arrow pointing to second blue "AUTHORIZE" button to authenticate to the data source itself (Facebook Ads in this case)

  9. A pop-up may ask you to select a team, if you belong to multiple. Pick a team with your license to continue. If you do not belong to multiple teams, it will skip to the next step.
  10. Follow the prompts to log into 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).
    • Note that for some data sources, it will use your browser cookies for that source to log the user in automatically.
  11. Once the login is completed, it will return to the data source setup page. This is what Facebook Ads looks like, other data sources may look different:

    Example data source configuration settings for Facebook Ads

  12. Select the account(s) you want to use from the drop-down (best practice to select at least one account) and enable any other required settings.
  13. (OPTIONAL) Update the data source name to something memorable or informative about what you are connecting to (by default, it will be the name of the data source, so in this example it would be saved as "Facebook Ads" if you did not change the name).

    Orange arrow pointing to optional field to update the name of the data source - it is called "Facebook Ads ALL ACCOUNTS"

  14. Click CONNECT in the upper-right to save your configuration as a new data source file.

    Orange arrow pointing to blue "CONNECT" button to save the data source configuration

  15. It will then take you to the field list. By default, you don't need to do anything here. Click ADD TO REPORT to proceed.

    Orange arrow pointing to blue "ADD TO REPORT" button to confirm the data source is added to the report

  16. The data source is now added to the report to use as a resource! You can now select it for your report objects.

For more instructions how to to add different chart types or edit fields see Getting Started.

Common Issues

  • If you find yourself in an authentication loop in steps 6-10, 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 this 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 permissions to access.
  • 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:

Did you find it helpful? Yes No

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