Skip to main content

Integrating with Adobe Analytics 2.0

Updated over 3 weeks ago

📘 This article provides the information you need to understand how Botify manages the latest Adobe Analytics data integration and the detail we need you to provide us to implement it on your web property.

Overview

This section describes the differences between Botify's original integration with Adobe Analytics and the latest integration.

Summary of Differences

The following are the differences between the 2.0 integration and the legacy integration:

2.0 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

visits & conversion data

visits data only

Upgrading to the Adobe Analytics 2.0 Integration

If you are using the legacy Adobe Analytics integration and want to be migrated to the 2.0 integration, please send a request to Support; there is no automated migration. All candidates must complete the user onboarding procedure. If you use the legacy Adobe Analytics integration, you do not have to upgrade to the 2.0 integration. Customers who have never used the Adobe Analytics integration may only request the 2.0 integration.

Adobe Analytics Data Integration 2.0 Details

Visit Data

Metrics: Metrics overview | Adobe Analytics

Dimensions: Dimensions overview | Adobe Analytics

Conversion Data

Metrics: Metrics overview | Adobe Analytics

Dimensions: Dimensions overview | Adobe Analytics

Medium mapping:

  • "Typed/Bookmarked": "direct"

  • "Search Engines": "organic"

  • "Social networks": "social"

  • "Other websites": "referral"

  • "Hard drive": "(none)"

  • "Email": "email"

Adobe Analytics Data Integration 2.0 Technical Details

Impact on Adobe Analytics Instance

The API sends requests at a rate of 8 hits/6 sec by default, and Adobe allows up to 12 hits/6 sec, so there should be a negligible performance impact on your Adobe Analytics instance. Botify can increase the rate upon request, up to the maximum Adobe allows.

Historical Data Retrieval

The Adobe Analytics API v2.0 does not provide a method to retrieve data with multiple dimensions in bulk. To retrieve all dimensions, we break down the calls into multiple dimensions, retrieving 30 days of historical data at the beginning and then retrieving pieces each day until we get 18 months of data.

Onboarding Procedure

This section describes the information you need to provide Botify to implement Adobe Analytics 2.0 on your web property.

Prerequisites

You must have an Admin role and permissions in your organization's Adobe Admin Console to gain access to the information required for the user onboarding procedure.

Steps

The following steps are required to integrate your Adobe Analytics 2.0 data:

Step 1: Collecting Data from Adobe Analytics

Refer to the sections below for guidance on where to locate this information in your organization's Adobe Analytics account, which you will send to Botify in Step 3:

👉 Optionally, activate the Cross-Device Analytics feature to import the Unidentified People metric.

A. Report Suite ID

  1. Log into your Adobe Analytics account.

  2. On the Admin tab, select Report suites.

  3. Locate your site's Report Suite Id in the table.

672

B. Global Company ID

  1. In your Adobe Analytics account, on the Admin tab, select All admin.

  2. Click the Company settings home link.

  3. On the API Access tab, locate the Global Company Id in the paragraph.

665
1161

C. Keypair

  1. In the Adobe Developer Console, click the Projects tab.

  2. Create a new project.

  3. Click the Add to Project button, then select API.

  4. Select the Adobe Analytics option, then select Service Account (JWT) as the authorization type.

  5. Select Option 1: Generate a key pair, then click the Generate keypair button. A zip file will be automatically downloaded to your computer.

  6. Select your analytics product profile and save.

1586
1758
2594
2642

D. Client, Technical, and Organization IDs

  1. In the Adobe Developer Console, click on the Service Account JWT.

  2. Locate the following information:

    • Client ID

    • Client Secret

    • Technical Account ID

    • Technical Account Email

    • Organization ID

1617

Step 2: Authorize Botify Access to Metrics and Dimensions

  1. In the Adobe Admin Console, click the Products tab.

  2. Select Adobe Analytics.

  3. Select the relevant product profile to manage permissions.

  4. On the Permissions tab, edit the Report Suites and add permissions for the report suite to be shared with Botify.

  5. Select the following metrics and dimensions to be shared with Botify:

    • Metrics:

      • Bounces

      • Average Time Spent On Site (Seconds)

      • Entries

      • Page Views

      • Orders

      • Revenue

      • Custom metrics

    • Dimensions:

      • Page

      • Entry Page Original

      • Referring Domain

      • Mobile Device Type

      • Referrer Type

      • Paid Search

      • Custom dimensions: Botify uses the default "entry page" dimension to find your URLs. If your URLs are stored in a custom dimension instead of the default "entry page" dimension, add permission to the custom dimension (eVar or prop) and provide the custom dimension name to Botify.

Step 3: Sending Required Information to Botify

  1. Send an email to Botify Support.

  2. Use “Adobe settings [company name]” for the email subject, replacing the placeholder with your company's name.

  3. Include the following in the email body:

    • The link of the Botify web property where you want to integrate your Adobe Analytics data.

    • The information you collected from Adobe:

      • Report Suite ID

      • Global Company ID

      • Keypair

      • Client ID

      • Client Secret

      • Technical Account ID

      • Technical Account email

      • Organization ID

      • The custom dimension name, if used in Step 2.

👉 To secure the data transfer, we may offer to use an SFTP account (using a public SSH key from you), PGP, or GPG encryption.

Contact Support

If you need any assistance with setting up the Adobe Analytics integration, please contact Support using the email address for your region:

Did this answer your question?