To connect Supermetrics to Adobe Analytics reporting API using JWT, 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
Prerequisites
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 or Developer 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 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 Projects and then Create new project.
- Click Edit project and give the project a meaningful name, perhaps referencing this is for the Supermetrics data source integration.
- Click Add API.
- Click the card for "Adobe Analytics" to select it and then click Next.
- Select the "Service Account (JWT)" card and click Next.
- Select "Option 2 Upload your public key". Drag and drop or select the file you created in Step #1 - Getting Your Public Key Certificate. Click Next.
- You will now see the set service account. Click Next to continue with the setup.
- The next page should show you a list of product profiles to enable to use with the API. Please select at least one from the list (this should likely be the profiles who will have reporting access).
- Click Save configuration to complete the setup.
- Go back to the "Projects" page and select the project set up in step 1.
- On the right-hand side, you will see the APIS listed. Click on "Adobe Analytics" to reveal the API keys needed for the next steps.
- 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 data source.
- Select the option to Connect with a Service Account.
- 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 Adobe Analytics connector!
Further Assistance
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.