Follow these steps to connect your Branch data to Supermetrics and use your data in Google Sheets, Excel, data warehouses, Power BI, and 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
To connect Supermetrics to your Branch account, you'll need a Branch key and secret. Get the key and key secret from Branch Dashboard → Account Settings → Profile.
To access the Query API, you need to have both Aggregate Data and Export access. Learn more about the Query API in Branch help.
Query types
- Summary (total): Get the raw organic data for app analytics from the Branch summary dashboard.
- Summary (unique): Get the unique data for app analytics from the Branch summary dashboard.
Take a look at this article to learn more about the Branch dashboard and the relevant query types and filters to use with Supermetrics.
Instructions
Make sure you've installed the Supermetrics add-on before you connect.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch sidebar to open Supermetrics.
- Click Create new query.
- Under Data source, select Branch
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Choose to make this connection shared or private.
- Click Start.
- Navigate to Report configuration, and select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.
Make sure you've installed the Supermetrics add-on before you connect.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Branch.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Choose to make this connection shared or private.
- Click Start.
- Navigate to Report configuration, and select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.
Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.
Set up transfer for BigQuery (marketplace)
Make sure you've enrolled the data source before you connect.
- Log in to the Google Cloud Platform.
- Navigate to BigQuery → Data transfers.
- Click + Create transfer.
- Select the Branch data source.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- Under Third-party connection, click Connect source.
- Accept the agreement.
- Click Authorize with Branch.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- Select the accounts you'd like to include in your reporting and define the transfer settings.
- Click Submit.
- Click Save.
Set up data warehouse transfer on the Supermetrics Hub
Make sure you've set up a data warehouse destination before you connect.
- Log in to the Supermetrics Hub.
- In the sidebar, go to Storage → Transfers.
Click New transfer. If you haven't created any transfers yet, click Schedule first transfer.
- Select the Branch data source, and click OK.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- In the Connections section, click Add new connection.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- In the transfer setup view, select the accounts you'd like to include in your reporting.
- Click Create transfer.
- Log in to the Supermetrics Hub.
- In the sidebar, go to Destinations → Power BI.
- Click Create or edit queries.
- Click Select a data source.
- Select the Branch data source.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- Fill in the query details.
- Click Run query to test your query.
- Log in to the Supermetrics Hub.
- In the sidebar, click API.
- Select for Supermetrics API from the dropdown menu next to the page title.
- Click Select data source.
- Select the Branch data source.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
- Click Run to test your query.
- Log in to the Supermetrics Hub.
- In the sidebar, click Data sources.
- 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.
- Hover over the Branch data source, and click Connect.
- Enter your Branch key and secret.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.