To connect Supermetrics to Adobe Analytics reporting API v2.0, you will need to set up a Service Account integration to your Adobe Analytics instance. This is currently the only type of access Adobe supports that does not require constant user re-authorization for Supermetrics.
Quick links to the sections below:
- Before You Begin
- Step #1 - Getting Your Public Key Certificate
- Step #2 - Setting Up Your Service Account Integration
- Step #3 - Connecting Supermetrics to Adobe Analytics
- Further Assistance
Before You Begin
What is a Service Account?
It's a special kind of user account for applications, that in this case, is limited to only access the Adobe Analytics product. There's other benefits too:
- The Service Account can be configured to have access more than one organization
- You can manage and monitor access from Adobe I/O Console
The following conditions must be met to set up a Service Account with Adobe:
- You must have have access to an Adobe Analytics product
- You must have the System Administrator user role in your organization
- You will also need to get the Public key certificate file from us - more details in the Getting Your Public Key Certificate section below
Step #1 - Getting Your Public Key Certificate
You can download your unique Public key certificate from the login page for the connector:
To get to this page, please attempt to log into the Adobe Analytics 2.0 data source in the Supermetrics product. Click the "Click here to download your public key certificate" link to download the file and have it ready to use in Step #2 below (you can also give the link to your Adobe administrator to download the file for you).
Please note that each file is unique to each user for that product and will only work for the Supermetrics license account attempting to log in. If you need Adobe access for multiple accounts or for multiple licenses/different products, each user will need to generate the file (or get the link) from this location and have each key certificate added to the service account integration by the Adobe administrator.
Step #2 - Setting Up Your Service Account Integration
This section guides you through setting up the Service Account for Adobe.
- Go to Adobe I/O Console (https://console.adobe.io/integrations) to start the integrations process.
Make sure you log into the site as an account that has administrator rights to your Adobe Analytics product, else you may not be able to complete the steps.
- Click New Integration.
- Select the option "Access an API" and click Continue.
- Under the Experience Cloud section, select the option "Adobe Analytics" and then the option for the "Service Account integration".
Please note that if the Adobe Analytics product is greyed out, it means the organization you have logged into does not have the Adobe Analytics product. Please contact your local Adobe support for more details.
- Click Continue to proceed.
- Fill in the form for your new integration.
- Fill in a suitable integration Name and Description. This information will not be available to Supermetrics.
- Upload you Public key certificate to the integration. If you don't have this file yet, see Step #1 - Getting Your Public Key Certificate above for how to obtain this. If you have multiple user accounts that need access or multiple licenses/products, you will need to add one key certificate per user/license.
- Under the Adobe Analytics Configuration section, click on at least one organization/product you would like this Service Account to have access to.
- Click Create Integration and then Continue to integration details to proceed to the next part of the setup.
- In Integration details you will see the client credentials. You will need the Client ID, Technical account ID, Organization ID and client secret to allow Supermetrics to use this Service Account. Keep these values handy and proceed to the next section to connect Supermetrics.
Step #3 - Connecting Supermetrics to Adobe Analytics
Once you have completed setting up your Service Account integration you can now connect Supermetrics to your Adobe data with it.
- Open your Supermetrics product and click on the Adobe Analytics 2.0 data source.
- A new window should open asking you for the four parts for authentication that you obtained at the end of setting up your service integration: Client ID, Technical account ID, Organization ID and client secret. Fill those and click START to continue with the authentication process.
- Once the credentials are validated, click Create to finalize the connection.
- You are now ready to create queries with the new Adobe Analytics 2.0 connector!
If you have issues with the Supermetrics connection part of the process, please create a new support request with the details of the issue and we will assist you.