Supermetrics Support Forum

How to Authenticate/Re-authenticate Searchmetrics in Google Sheets, Google Data Studio & Microsoft Excel

This guide gives instructions on how to successfully authenticate Searchmetrics.


Quick links to specific sections: 

Google Sheets

Data Studio

Excel

"If everything fails..." 

Data Source Access Requirements:

Before authenticating the connector, please make sure you have gone through the rights and permissions required for this data source, meaning you are assigned as an "ad manager/admin" or as a similar role. To learn more, please refer to this guide:

Access requirements for user account:

  • To connect Supermetrics to Searchmetrics, you will need to set up API credentials for your Searchmetrics account. This will create an API Key and API Secret you will use to log in. To create API credentials, please see this guide
  • A valid administrator user role. An administrator has the right to create sublicenses and new users and has full access to all projects, while this can be restricted for users.


Authenticating with Google Sheets

To authenticate Searchmetrics in Google Sheets, please do the following steps:

1. Open up the Supermetrics sidebar in your Google Sheets. 

2. Select Searchmetrics in the sidebar, under data source.

3. An automatic popup will open, insert your API Key and API secret and click on start

To create API credentials, please see this guide.

4. You have completed all the steps. You can now go back to the sidebar and select your Google Search Console Ad account under data source.

Re-authenticating with Google Sheets:

To re-authenticate the connector in Google Sheets, please go to this guide.


Authenticating with Data Studio:

To authenticate Searchmetrics in Google Data Studio, please do the following steps:

1. Click on add data.

2. Search for Searchmetrics by Supermetrics and click on it.

3. Click on authorise. If you wish to learn more about data security and data privacy, please see this page

4. An automatic popup will open, insert your API Key and API secret and click on start

To create API credentials, please see this guide.

5. Click on the link below to authenticate your account.

With this link, you can also add or delete accounts. 

6. Click on OK, let's continue to continue with that account. If you wish to proceed with a different account, click on Add Searchmetrics User Account. If you wish to remove an account click on remove.

- If your Data Studio account belongs to multiple teams, you will see the option to select the team you wish to use. Go to the link below and select the team name with your license to proceed. (If you only belong to one team, skip to the next step).

7. Select query type and click on next


8. Insert type URL and select the Searchmetrics country.

9. Click on add on the bottom right side to continue. 

10. As a final step, click on add to report

Re-authenticating with Data Studio:

To re-authenticate Searchmetrics in Data Studio, please go to this guide.


Authenticating with Excel:

To authenticate Searchmetrics in Excel, please do the following steps:

1. Click on data and open up the Supermetrics sidebar in Excel.

2. Select Searchmetrics in the sidebar under data source.

3. An automatic popup will open, insert your API Key and API secret and click on start

To create API credentials, please see this guide.

4. You have completed all the steps. Now you can go back to the sidebar and select your Searchmetrics account under data source.

Re-authenticating with Excel:

To re-authenticate Searchmetrics in Excel, please go to this guide.

"If everything fails..." 

Common errors:

If you encounter any of the following errors below, please see the guide linked after the error message.

  • Error: "This was a reauthorization request for user X but logged in as user Y", please see this guide
  • Error: "You're not allowed to run queries with this license #12345. This is because you have not been assigned to the license as a valid user." please see this guide.
  • Error: "This action is not supported when you are signed into multiple accounts". please see this guide.
  • If you no longer see a specific account/page/etc. when logging in, please see this guide
  • If you haven't managed to authenticate you might be affected by an issue at Google account management. For more information, please see this guide.

Forcing a refresh per account data & removing a data source:

To force a refresh per data source, please see this guide.

To remove a data source from Google Sheets, please see this guide.

To remove a data source from Data Studio, please see this guide.

To remove a data source from Excel, please see this guide.


Refreshing tokens 

As a final step, if you wish your tokens to be refreshed, please create a support ticket.


Did you find it helpful? Yes No

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