This guide will walk you through how to authenticate or reauthenticate Adobe Analytics and Adobe Analytics 2.0 with Google Sheets, Data Studio, and Microsoft Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and API.
- Please note that Adobe Analytics 2.0 is in early access and not fully deployed, but available for testing.
Before you begin
There are two ways to authenticate Adobe Analytics and Adobe Analytics 2.0:
- Connect with a service account — we recommend this method
- Connect with OAuth
Please note that Adobe's OAuth logins are only valid for 2 weeks. If you use this option, you'll need to renew your authentication every 2 weeks to keep it active. We recommend using the service account option instead, as the login (token) stays active for longer.
Prerequisites: Connect with a service account
To connect Supermetrics to Adobe Analytics/2.0 with a service account, you need:
- A System Administrator or Developer user role in your Adobe account organization. To set up your Service account, follow these instructions.
- It also requires explicit access granted to see the report suites, reports, segments, and custom fields. Visit Adobe’s help center to learn how to change user roles. (Legacy help article)
To complete the connection, you'll:
- Create new Project
- Click Add API
- Select Adobe Analytics
- Select Service Account (JWT)
- Download the public key from the Supermetrics login window
- Upload public key to the new Adobe Project
- Select the Adobe Analytics profiles you want to use in Supermetrics
- Copy all the necessary information from the Adobe project credentials - Client ID, Client Secret, Technical Account ID, Organization ID
*Please note that Project Management and User Management are in different places in Adobe.
Prerequisites: Connect with OAuth
To connect Supermetrics Adobe Analytics/2.0 with OAuth, you need:
- Adobe ID linked to Experience Cloud with a Web Service Access enabled. It also requires explicit access granted to see the report suites, reports, segments, and custom fields. Visit Adobe’s help center to learn how to change user roles. (Legacy help article)
- To connect your Adobe account to Supermetrics, follow these steps.
Data protection agreement
If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.
Instructions
- Open a new Google Sheets file.
- Click Add-ons → Supermetrics → Launch to open the sidebar.
- Under Data source, select Adobe Analytics / Adobe Analytics 2.0.
- Choose between these two authentication flows:
- Connect with a service account or;
- Connect with OAuth
If you choose service account:
Enter your client ID, technical account ID, organization ID, client secret, and click Start.
If you choose OAuth:
Enter your email address and password and click Log in.- Under Select accounts, select the accounts.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Google Sheets.
- Open the Supermetrics data source gallery.
- Navigate to Adobe Analytics / Adobe Analytics 2.0 and click Try.
- Click Authorize.
If you're authenticating the data source for the first time, log in with the Google account you use with Supermetrics. Click Allow. - Click Authorize to log in to your data source.
- Choose between these two authentication flows:
- Connect with a Service Account or;
- Connect with oAuth
If you choose Service Account:
Enter your client ID, technical account ID, organization ID, client secret, and click Start.
If you choose OAuth:
Enter your email address and password and click Log in.- Under Select accounts, select your accounts.
- 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.
- Click Connect on the top right-hand side. This will open a full list of fields available in this connector. You can skip this list.
- Click Create report.
- Click Add to report to complete the authentication steps.
Add or remove a user account
- To add or remove a user account go back to the data source settings. Click on the link at the end of the sentence that starts with “To add more/manage user accounts…”
- Click +Add new account to add a new user account.
- Click the Trash icon to remove that specific user account.
- Click Continue to proceed with that user account.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Data Studio.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Adobe Analytics / Adobe Analytics 2.0.
- Choose between these two authentication flows:
- Connect with a Service Account or;
- Connect with oAuth
If you choose Service Account:
Enter your client ID, technical account ID, organization ID, client secret, and click Start.
If you choose OAuth:
Enter your email address and password and click Log in.- Under Select accounts, select the accounts.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Excel.
Explore our guides to set up data transfers to various destinations.
- Set up BigQuery
- Set up data warehouse and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- Set up Supermetrics API
Reauthenticate the data source
Troubleshooting
- If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.