🛠 This article provides the information you need to integrate your Adobe Analytics data with your Botify project.
Overview
Adobe Analytics brings a new dimension to Botify reports. When you integrate your Adobe Analytics data with Botify, we import your visit and conversion data from search engines. These performance indicators are mapped to SEO indicators from the Botify crawl analysis. Botify reports will identify areas that can be improved, such as the pages that generated organic visits but have duplicate HTML tags or those that did not generate visits because they are deep in the website structure.
❗️This documentation refers to Adobe's OAuth authentication method, which will replace the JWT method on 27 January 2025. Clients integrating with Adobe Analytics for the first time and those with an existing Adobe integration in Botify must complete this process to preserve analytics data.
Adobe Analytics Data in Botify Reports
When you integrate your Adobe Analytics data, Botify retrieves your visit and conversion data. Adobe Analytics data is available in the following locations in Botify:
The Analytics Overview Page: The funnel on the Overview page uses Adobe Analytics data to show a full-funnel view of organic search performances.
EngagementAnalytics: EngagementAnalytics shows your daily analytics data with trend charts for all channels to capture the evolution. You can also build these trend charts in RealKeywords and send them to CustomReports.
SiteCrawler: Adobe Analytics data is aggregated by default for 30-day periods in SiteCrawler's Visits section, which provides indicators for all search engines and the most popular sources. The Visits section also combines visit data with SEO indicators, such as: pages that generate visits vs. those that do not, pages by depth, HTML tags uniqueness, and internal links. You can browse data imported from Adobe Analytics through the URL Explorer, use criteria based on visits as filters in reports, and export results. You can also retrieve visit data in the RealKeywords Keywords Explorer on a selected period.
Visit and conversion dimensions and metrics: Use the dimensions and metrics shown below as filters and report columns for your visit and conversion data:
| 
|
Refer to the Revenue and Conversion Data in Botify article to learn more about the ROI use case with Adobe Analytics and Botify.
Historical Data Retrieved
We retrieve 16 months of historical data from Adobe Analytics. At the start of the integration, we retrieve 30 days of historical data, then additional data daily until we have 16 months of data.
Benefits of the New Integration
There are several advantages to the new integration method, including:
You will benefit from daily updated data.
Access trends in EngagementAnalytics and create your trend charts in RealKeywords that you can use to build custom reports.
Get the full benefit from new reports like the Content Performance dashboard.
The following summarizes the differences between Botify's original integration with Adobe Analytics and the latest integration:
| New Integration | Legacy Integration |
How data is pulled | Adobe API 2.0 | Adobe data feed |
How SEO traffic is calculated | by the entries metric | by the visits metric |
Data obtained | Visit & conversion data | Visit data only |
Required Information
This section provides the information you need from your Adobe Analytics account. You must have an Admin role and permissions in your organization's Adobe Admin Console to gain access to the following information that is required to set up the integration:
Report Suite and Global Company IDs
In your Adobe Analytics account, navigate to Admin > All admin.
Click the Report suite access link in the "User management" section.
Locate your site's Report Suite ID in the table.
Navigate to Admin > All admin and click the Company settings home link in the "Company settings" section.
Locate the Global Company ID at the end of the first paragraph on the API Access tab.
Visits Entry Page Dimension and Conversion Fields
Locate your entry page dimension and conversion fields in your Adobe Analytics workspace when you create a new project.
Botify finds your URLs using the default "Entry Page" dimension. If your URLs are stored in a custom dimension instead of the default, add permission to the custom dimension and provide the name when integrating visit data in Botify.
Configuring the Integration
This section describes how to set up the integration in Botify. You configure the Adobe Analytics integration within your Botify project settings.
Integrating Visit Data
Navigate to Settings > Data Sources.
Click the (Analytics Provider) Adobe Visits tile.
Click the Add an account link. Follow the prompts to log into your Adobe Analytics account. This link is not displayed if an Adobe Analytics account is already connected.
Identify the Report Suite and Global Company IDs you obtained from your Adobe Analytics account.
In the “Entry Page” field, provide the Adobe Analytics dimension that identifies the first page of a user session.
Click Save. A banner identifies the synchronization status, which can take up to 36 hours. After synchronization, we will pull 10 days of historical data daily until 16 months of historical data are integrated.
Integrating Conversion Data
Navigate to Settings > Data Sources.
Click the (Analytics Provider) Adobe Conversion tile.
Click the Add an account link. Follow the prompts to log into your Adobe Analytics account. This link is not displayed if an Adobe Analytics account is already connected.
Identify the Report Suite and Global Company IDs you obtained from your Adobe Analytics account.
Recommended fields are included with default IDs. To keep these recommendations, click the edit icon to update the ID to align with those in your Adobe account. Click the delete icon to remove a recommended field.
Click the Add a new conversion field link to add a new conversion field.
Identify the following information, then click Add:
ID: The unique Adobe Analytics field ID you obtained in the Required Information section.
Name: The name that will identify the field in your Botify reports.
Type: Select “dimension” or “metric” based on the field’s designation in Adobe Analytics.
If you have revenue segments defined in Adobe Analytics, optionally add the Segment Filter ID to integrate this revenue with your reports.
Click Save. A banner identifies the synchronization status, which can take up to 36 hours. After synchronization, we will pull 10 days of historical data daily until 16 months of historical data are integrated.
Updating the Adobe Analytics Configuration
After your Adobe Analytics integration is set up, you can make the following changes:
Changing the Connected Adobe Analytics Account
To change the Adobe Analytics account connected to your project:
Navigate to Settings > Data Sources > Adobe Analytics.
Click either the Adobe visits or Adobe conversion link.
Click the trash can icon next to the connected account.
Click Unlink in the confirmation popup.
Click the Add an account link. Follow the prompts to log into your Adobe Analytics account.
Click Save at the bottom of the page.
Changing Connected Data Sources
❗️Since changes to integrated data sources will restart your data retrieval and replace existing data, we recommend avoiding incremental changes and making the necessary changes simultaneously to maintain your data integrity.
To change integrated data sources:
Navigate to Settings > Data Sources > Adobe Analytics.
Make the desired updates to each field in the “Set up metrics and dimensions” section.
For Conversion fields:
Click the trash can icon next to a field to remove it from the integration.
Click the pencil icon to update field details. Make the necessary changes, then click Update.
Click Save at the bottom of the page.
Click Confirm in the confirmation message.
Contact Support
If you need assistance setting up the Adobe Analytics integration, please contact Support.