Skip to main content

Integration Guide: Adobe Analytics

Learn how to integrate Adobe Analytics with Listrak's marketing automation platform to export email activity metrics and message classifications.

⚠️ Set up requirements:

  • An existing Adobe Analytics account will need to be set up with at least one Report Suite already configured.

  • Only an Adobe user with System Administrator rights will be able to complete the steps within the Adobe platform.

Step 1: Adobe Admin Console Setup

As the Adobe System Administrator, begin by creating and configuring a Product Profile in order to access and manage Listrak in the Adobe Analytics console.

Create the Product Profile

  1. Sign in to the Adobe Admin Console and verify that the correct Adobe Organization (your account) is selected in the upper right corner.

  2. Click the Products tab.

  3. Select an existing profile for the Listrak integration, if created.

  4. Or, click Create New and enter a Profile Name.

  5. Click Done to complete the Product Profile setup.

Configure the Product Profile

  1. After the Product Profile setup is complete, select the profile you just created from, the list.

  2. Navigate to Permissions and click Edit.

  3. Add the five permission groups defined in the table below.

  4. Save the profile.

    ⚠️ It may take a few minutes for the changes to applied by Adobe.

Permission group

Configuration

Purpose

Report Suites

Add every report suite that will be mapped in Listrak.

Makes the report suite available to the Adobe API and Listrak Integrations.

Metrics

Turn on Auto-include.

Allows Listrak to list and use custom success events.

Dimensions

Turn on Auto-include.

Allows Listrak to list and use eVars.

Analytics Tools

Include Web Service Access.

Allows the OAuth credential to call Adobe Analytics APIs.

Report Suite Tools

Include Report Suite Mgmt, Data Sources Manager, and Classifications.

Supports Listrak's automatic provisioning and the required Classification Set setup.

💡 Auto-include grants current and future custom components without requiring a manual search for each one.

Step 2: Create OAuth Server-to-Sever Credentials

  1. Sign in to Adobe Developer Console and select the same Adobe organization from Step 1.

  2. Click Create new project.

  3. Select Add to Project > API.

  4. Then, select Adobe Analytics.

  5. Next, choose Server-to-Server Authentication.

  6. Ensure OAuth Server-to-Server is select and enter a Credential Name.

  7. Select the Product Profile created in Step 1 and Save.

  8. Open the OAuth Server-to-Server credential, select Generate access token, then select Retrieve client secret.

  9. Copy the Client ID and Client Secret.

    ⚠️ You will need these in the following steps. Ensure they are stored securely and easily accessible.

Step 3: Configure the Adobe-Side Settings

In this section you will complete the configuration in Adobe. Adobe does not allow you to adjust these settings via API, so you an admin must complete them in the Adobe UI.

Step 3A: Configure eVars and success events

Now you will configure the Adobe report that will receive the Listrak data.

Create the conversion variables

  1. In Adobe Analytics, go to Admin > Report Suites and select the report suite.

  2. Go to Edit Settings > Conversion > Conversion Variables.

  3. Create or enable two eVars.

    1. Select the Status checkbox and set each eVar to Enabled.

    2. Select the Name checkbox and enter Message ID and Recipient ID.

  4. Save the changes.

Create the success events

  1. In the same report suite, go to Edit Settings > Conversion > Success Events.

  2. Create or enable seven custom events with these display names: Abuse, Bounces, Clicked, Opened, Read, Send, and Unsubscribed.

  3. Set each Listrak activity event to the Numeric type and enable Participation.

  4. Save the changes.

💡 You may choose the eVar and event numbers. Listrak does not require fixed eVar or event numbers; you select the configured components by display name when creating the Listrak mapping.

Step 3B: Create the Classification Set

Classification sets allow you to categorize your data within the Adobe reports.

  1. In Adobe Analytics, go to Components > Classification sets.

  2. Create a Primary Classification Set.

  3. Under Subscriptions, add the selected report suite and its Message ID eVar as the Key Dimension.

  4. Save the Classification Set.

  5. Open the Classification Set, add four columns with the exact spelling and capitalization below, then save the schema.

Campaigns
Message Name
Channel
Delivery Tool

💡 Classification key: The selected Message ID eVar is the classification key. Do not add a separate Message ID classification column. Listrak supplies values for the four columns listed above.

Step 4: Listrak Integration Setup

The next step is to add the Adobe Analytics Integration to Listrak.

  1. Sign in to the Listrak platform and navigate to Integrations> Integrations Management.

  2. Click New Integration.

  3. Select Adobe Analytics under the New Partner Integration section.

  4. Click Integrate.

  5. Go to the Setup tab.

    1. Enter an Integration Name of your choice.

    2. Fill in the Client ID and Client Secret fields with the values generated in Step 2.

    3. Click Verify Integration & Save.

  6. Open List Mappings and add a mapping.

    1. Select the Adobe report suite, Listrak list, time zone, Message ID eVar, Recipient ID eVar, and all seven success events.

    2. Save the mapping.

⚠️ Empty eVar or event lists: If the report suite appears but the eVar or event selections are empty, verify that the technical account's Product Profile includes the report suite and that Auto-include is enabled for both Metrics and Dimensions. Save the changes in Adobe, wait a few minutes, then refresh Integrations.

Step 5: Verification and Troubleshooting

Verification

To confirm the integration is correctly configured, ensure the following items are populated in Listrak and Adobe.

  1. Confirm that report suites, eVars, and success events populate in Integrations within the Listrak platform.

  2. In Adobe Analytics Workspace, confirm that the selected custom events receive email activity data.

  3. Confirm that the Message ID eVar's Classification Set receives Campaigns, Message Name, Channel, and Delivery Tool values after new message data is processed.

Troubleshooting

Symptom

Likely cause

Resolution

Report suites do not appear.

The credential has no eligible report-suite access.

Add the report suite to the Product Profile and verify the Client ID and Client Secret.

eVar or event selections are empty.

The technical account lacks Dimensions or Metrics access.

Enable Auto-include for Metrics and Dimensions, save, wait for Adobe propagation, and refresh Listrak.

The mapping cannot be saved because the classification configuration is invalid.

No compatible Primary Classification Set exists.

Create a Primary set for the selected Message ID eVar with the four required columns.

Metrics are not visible after mapping.

New activity has not been processed yet.

Send new activity, allow time for processing, then confirm the selected custom events in Adobe Analytics Workspace.

Please contact your onboarding or account team with any questions. You can also reach out to Listrak Support in the Support Portal or via Live Chat.

Related Articles
Did this answer your question?