You can access your Adobe Analytics account in Oncrawl. This allows you to add cross-analysis between crawl data and analytics data in the SEO Impact Report. This ties crawl data to real-word data on user behavior.
How to add Adobe Analytics as a data source
From the project home page, click on Add data sources under Tasks.
Navigate to the Adobe Analytics tab and click Add a new data source.
This opens the Set up an Adobe data source window. First, create a connection with your Adobe account by clicking on Add a connected app.
💡 A connected app refers to a connexion (such as by OAuth authentication or with a token) between any Oncrawl user account and a third party service such as Adobe Analytics, Google Analytics, Google Search Console, or others.
Choosing your method of connection
Oncrawl offers different ways of authenticating the connection between Oncrawl and Adobe:
Using a JWT token: Adobe has ended support for this method: it is no longer available. See the section below on how to switch it to a server-to-server OAuth connection, as advised by Adobe.
Server-to-Server OAuth connection: set up in the Adobe account, this allows a service (Oncrawl) to access the data in your Adobe account project that you give it access to.
User OAuth connection: uses a personal access to view data, but expires after 14 days.
1. Connection with a JWT token
This method has been phased out by Adobe over the course of 2024. No new JWT tokens can be created in Adobe, and existing JWT tokens will stop working at the end of 2024.
If you currently have connected apps using a JWT token, you will need to migrate them to server-to-server OAuth connections before the end of 2024.
Migrating a connected app using a JWT token to a server-to-server OAuth connection
Do not create a separate, new connected app. This will break the connection to any Adobe data sources you currently have.
Follow the instructions in Adobe's help: In Adobe Developer Console, go to the project settings. In the menu on the left, choose Service Account (JWT) DEPRECATED. Then, in the 1. Add an equivalent OAuth Sever-to-Server credential to your project section, click the Add new credential button.
This will add an option to the menu on the left: OAuth Server-to-Server. This is where you can generate and consult an API Key (Client ID) and a Client Secret that will be used in Oncrawl.
In Oncrawl, in your User account, choose Connected apps in the left-hand sidebar.
Check the Type column to find the connected apps using JWT. (You can migrate both JWT and User OAuth methods to the new Server-to-Server OAuth method.)
Then, start the migration by clicking on the Switch to OAuth button on the corresponding row:
Provide the API Key (Client ID) and the Client Secret from Adobe, and click Authenticate.
Return to Adobe's JWT settings for your project. In the 2. Update your application and delete your old Service Account (JWT) credential), click Review and delete.
The information under Last used should reflect the connection you just made with Oncrawl.
2. Server-to-Server OAuth connection
This method allows a service (Oncrawl) to access the data in your Adobe account project that you give it access to.
You'll need to prepare the Access token and Client secret in Adobe Developer Console. You'll find this in your project settings, in the left-hand menu, under Credentials: OAuth Server-to-Server. If you don't already have one, you can generate it now.
In Oncrawl, create a new Adobe connected app and choose the Server-to-Server OAuth option.
You'll need to provide:
The access token
The client secret
The account label: we recommend you use the Adobe project name.
Click Authenticate.
Oncrawl will display a confirmation message:
This confirms the success of the authentication if Adobe accepted the connection.
Or, it lets you know something went wrong if Adobe refused the connection. This is often because your Adobe Analytics settings do not allow a service to access data using the credentials you provided.
3. User OAuth Connection
This method uses a person's (your) user credentials to temporarily access data you have permission to view. It expires after 14 days and will then need to be renewed.
Choosing the User OAuth method will ask you to provide a Label for your connected app. We recommend using the name of your Adobe Analytics project.
When you click Authenticate, a pop-up will ask you to log in to your Adobe account, outside of Oncrawl.
Because this occurs outside of Oncrawl, you must authorize pop-ups in the Oncrawl app in order to connect your Adobe Analytics account.
Indicate that you agree to share your Adobe Analytics data with Oncrawl.
The only information Oncrawl receives is the data you authorize your account to share with us.
How to activate the SEO Impact Report with Adobe Analytics to add analytics data to a crawl
When setting up a crawl, in the crawl settings:
Scroll down to the Analysis section.
Click on the SEO impact report tab to expand it.
Switch to the Adobe Analytics tab and tick the Enable Adobe Analytics cross-data analysis box.
Now you will need to choose your Adobe Analytics data source:
If you have already created it using the method above, click on the Data source field to view a drop-down list of the known Adobe data sources. Select yours.
If your data source is not already listed in this menu, click the Add data source button. This opens a window that allows you to connect to your account outside of Oncrawl.
The only information we receive is the data your account shares with us after you've provided your login credentials. This means that to create an OAuth authentication, you must authorize pop-ups in the Oncrawl app in order to connect your Adobe Analytics account.
Indicate the analytics data to be used by selecting your Report suite.
A message at the bottom of this section will confirm that our crawler has access to your data. If there's a problem, Oncrawl will let you know here.
Now you can go ahead and launch your crawl.
Keeping your Adobe Analytics connection up to date
The User OAuth connection method works via a token provided by Adobe Analytics. This token will auto-expire at the end of a two-week period. If this occurs, a scheduled crawl might not run, and you will see an error in the SEO Impact Report settings in your crawl profile.
To be able to continue to run crawls with a User OAuth connection to Adobe Analytics connector in the crawl profile, you will need to refresh the token before its two-week expiration date.
To refresh an OAuth token:
In the crawl profile that uses the Adobe token, go to the SEO Impact Report > Adobe Analytics settings and reselect the Adobe account and report suite.
Save the crawl profile.
Repeat these last two steps for any other profiles that use this token.
Advantages of Adobe Analytics + SEO Impact Report
What types of analytics data does Oncrawl use?
Analytics data is data concerning the type and volume of user visits, as well as user behavior on a website.
When interfacing with Adobe Analytics, Oncrawl principally draws from information concerning:
Number of SEO (organic) visits
Pages receiving SEO (organic) visits
Bounce rates
This data is available by page and by search engine in Adobe Analytics and in Oncrawl.
By default, Oncrawl analyzes the data for the last 45 days.
What type of analysis does Oncrawl show?
Oncrawl provides you with the metrics to examine the relationship between various aspects of organic activity and technical SEO metrics:
The breakdown of pages by page groups
Page depth
Internal page popularity
Internal links
Title, description, and h1 tags
Word count
Distribution of duplicate content
Load time
Status code
And more
This cross-analysis allow you to determine the metrics that have the most impact on your site, and the optimizations that can make the most difference for SEO traffic on your site.