Fides Documentation – Ethyca

Consent Management: Configuring Adobe Experience Platform

This tutorial requires Fides Cloud or Fides Enterprise. For more information, talk to our solutions team.

Overview

The Adobe Experience Platform integration automatically syncs Fides consent to Adobe products. It supports both modern and legacy Adobe consent mechanisms:

SDK stands for Software Development Kit, API stands for Application Programming Interface, and ECID stands for Experience Cloud ID.

The integration provides out-of-the-box default mappings for common consent categories and allows full customization to meet your specific requirements.

Prerequisites

For this tutorial you'll need:

Basic Usage

The simplest way to integrate Adobe Experience Platform is to use the default mappings:

// Load Fides.js
<script src="path/to/fides.js"></script>

<script>
  // Initialize Adobe Experience Platform integration
  Fides.aep();
</script>

This will automatically sync Fides consent to Adobe using the following default mappings:

Default Adobe Web SDK Mappings

Fides Consent Key Adobe Purposes
analytics collect, measure
functional personalize
advertising share, personalize

Default ECID Opt-In Mappings

Fides Consent Key Adobe ECID Categories
analytics aa (Analytics)
functional target (Target)
advertising aam (Audience Manager)

Custom Mappings

You can customize the consent mappings to match your specific Adobe configuration and privacy notice structure:

const aep = Fides.aep({
  // Custom Adobe Web SDK purpose mappings
  purposeMapping: {
    analytics: ['collect', 'measure'],
    marketing: ['personalize', 'share'],
    essential: []
  },

// Custom ECID Opt-In Service category mappings
  ecidMapping: {
    analytics: ['aa'],
    marketing: ['target', 'aam'],
    essential: []
  }
});

Adobe Web SDK Purposes

The Adobe Web SDK Consent API v2.0 supports the following standard purposes:

ECID Opt-In Categories

The legacy Adobe ECID Opt-In Service supports these standard categories:

The integration dynamically handles all Adobe categories. You only need to map the categories you're actually using in your Adobe configuration.

Checking Consent State

You can check the current Adobe consent state at any time using the consent() method:

const aep = Fides.aep();

// Get current Adobe consent state
const state = aep.consent();

console.log(state);
// Output:
// {
//   timestamp: "2025-12-08T12:00:00.000Z",
//   alloy: {
//     configured: true,
//     purposes: undefined  // Adobe Web SDK doesn't expose this
//   },
//   ecidOptIn: {
//     configured: true,
//     categories: {
//       aa: true,
//       target: false,
//       aam: true
//     }
//   }
// }

The Adobe Web SDK (Alloy) does not expose consent state for reading. The integration can only show whether Alloy is configured, not what consent values were set. Use the ECID Opt-In state for verification.

Complete Example

Here's a complete example showing how to install Fides.js and configure the Adobe Experience Platform integration:

<!DOCTYPE html>
<html>
<head>
  <!-- Load Fides.js -->
  <script src="https://privacy.example.com/fides.js"></script>

<script>
    // Initialize Adobe Experience Platform integration
    const aep = Fides.aep({
      // Map Fides consent to Adobe Web SDK purposes
      purposeMapping: {
        analytics: ['collect', 'measure'],
        functional: ['personalize'],
        advertising: ['share', 'personalize']
      },

// Map Fides consent to legacy ECID categories
      ecidMapping: {
        analytics: ['aa', 'mediaaa'],
        functional: ['target'],
        advertising: ['aam', 'adcloud']
      }
    });

// Optional: Check consent state when needed
    console.log('Adobe consent state:', aep.consent());
  </script>
</head>
<body>
  <!-- Your website content -->
</body>
</html>

Integration Behavior

The Adobe Experience Platform integration:

  1. Listens to Fides events
  2. Syncs consent immediately
  3. Supports both Adobe SDKs
  4. Graceful degradation
  5. Dynamic category support

Debugging

To debug the integration, listen to Fides events to see when consent changes are applied:

window.addEventListener("FidesUpdated", (event) => {
  console.log("Fides consent updated:", event.detail);
});

Troubleshooting

Adobe SDK not detected

If you see the message "Adobe not detected. Ensure Adobe Web SDK or ECID is loaded", verify:

  1. Adobe Web SDK (Alloy) is loaded before the integration
  2. Or, Adobe ECID Opt-In Service is loaded
  3. Fides.js is loaded after the Adobe SDK

Consent not applying

If consent doesn't seem to be applying to Adobe:

  1. Check the browser console for error messages
  2. Listen to Fides events (see Debugging section above) to verify consent is being updated
  3. Verify your purposeMapping and ecidMapping match your Adobe configuration
  4. Confirm your Fides privacy notice cookie keys match what you're using in the mappings

Mixed SDK environments

If you have both Adobe Web SDK and ECID Opt-In Service on the same page:

What's next?

Now that you have Adobe Experience Platform integration configured, you might want to: