Open navigation

Hotjar connection guide

Follow these steps to connect your Hotjar data to Supermetrics and use your data in Google Sheets, Looker Studio, Excel, and Power BI, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.


You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.


Before you begin

Before using the Hotjar connector, make sure that your Hotjar plan includes access to their API. See this Hotjar support article for information on how to subscribe to API access. 


To connect Supermetrics to your Hotjar account, you need to generate API credentials (client ID and client secret) as well as the site ID for the site you want to fetch data for.


Step 1: Generate API credentials
  1. Log in to the Hotjar platform
  2. Open the Organization Settings page
  3. Click API from the left menu bar.
  4. Select your organization.
  5. Enter a name for the credential, for example “Supermetrics”.
  6. For scopes, select “Survey responses”.
  7. Click Generate credentials.
  8. Copy the Client ID and Client secret to a safe place for later reference.
Step 2: Retrieve your site ID
  1. Log in to the Hotjar platform.
  2. Open the Sites & Organizations page.
  3. The site ID is in the left-most column in the table, next to the site name.


Query types

  • Surveys: Behavior analytics and feedback data to help users empathize and understand their customers through surveys tool.


Instructions

Google Sheets

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open a new Google Sheets file.
  2. Navigate to ExtensionsSupermetricsLaunch sidebar to open Supermetrics.
  3. Click Create new query.
  4. Under Data source, select Hotjar.
  5. Enter your Client ID, Client Secret, and Site ID.
  6. Enter a name for your site so you can identify it later.
  7. Choose to make this connection shared or private.
  8. Click Start.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.

Looker Studio

Make sure you've connected Supermetrics to Looker Studio before following the steps below.

  1. Open the Supermetrics Looker Studio data source gallery.
  2. Navigate to Hotjar and click Start free trial.
  3. You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
  4. Once that's done, or if you've done it before, click the right-hand Authorize button (under "Hotjar requires authorization to connect to data").
  5. Select a team that has access to the account you want to connect.
  6. Enter your Client ID, Client Secret, and Site ID.
  7. Enter a name for your site so you can identify it later.
  8. Choose to make this connection shared or private.
  9. Click Start.
  10. 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.
  11. In the pane's top right, click Connect.
  12. Click Create report.
  13. Click Add to report.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.

Excel

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open an Excel file.
  2. Click DataShow Supermetrics.
  3. Under Data source, select Hotjar.
  4. Enter your Client ID, Client Secret, and Site ID.
  5. Enter a name for your site so you can identify it later.
  6. Choose to make this connection shared or private.
  7. Click Start.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.

Power BI
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, go to DestinationsPower BI.
  3. Click Create or edit queries.
  4. Click Select data source.
  5. Select the Hotjar data source.
  6. Enter your Client ID, Client Secret, and Site ID.
  7. Enter a name for your site so you can identify it later.
  8. Click Start.
  9. Fill in the query details.
  10. Click Run query to test your query.
The Supermetrics API
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, click API.
  3. Select for Supermetrics API from the dropdown menu next to the page title.
  4. Click Select data source.
  5. Select the Hotjar data source.
  6. Enter your Client ID, Client Secret, and Site ID.
  7. Enter a name for your site so you can identify it later.
  8. Click Start.
  9. Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
  10. Click Run to test your query.
Supermetrics Hub
  1. Log in to the Supermetrics Hub.
  2. In the left-side menu, select ConnectData sources.
  3. Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
  4. Hover over the Hotjar data source, and click Connect.
  5. Enter your Client ID, Client Secret, and Site ID.
  6. Enter a name for your site so you can identify it later.
  7. Click Start.


More resources

Did you find it helpful? Yes No

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