Kevel connection kevel

Kevel provides the AI-enabled technology and expert guidance that help innovative commerce leaders launch, scale, and succeed in retail media. Kevel’s Retail Media Cloud powers targeted, attributable, customizable ad formats for on-site and off-site advertising.

Use the Kevel streaming destination to activate Adobe audiences directly into Kevel’s UserDB and Segment Management APIs and support real-time targeting at ad decision time. You can also export profile attributes, such as a user’s incrementality testing group assignment, for Kevel to act on at decision time.

IMPORTANT
If you have questions or would like to request an update regarding the Kevel destination or its documentation, please email the Kevel team at support@kevel.com.

Use cases use-cases

Target retail media audiences in real time. You can activate rich first-party behavioral audiences across your retail media experiences to deliver more relevant ads and stronger performance. In Experience Platform, you build high-value, intent-based audiences, such as frequent category shoppers or users with recent product interest, and sync those memberships to Kevel in real time. Kevel immediately makes these segments available for ad decisioning, enabling precise targeting for sponsored products and other formats across search, browse, and app experiences. As soon as users qualify, you can act on these signals to drive more relevant impressions, better targeting, and improved measurement and ROAS.

Measure incremental impact. You can also export a user’s group assignment as a profile attribute to power Kevel’s incrementality testing. Kevel holds out a control cohort and compares it against exposed users to quantify the causal lift your campaigns drive, rather than relying on proxy metrics such as new-to-brand counts or correlation-based lift. This lets you prove incremental sales and conversions while Kevel minimizes revenue impact by serving the next best eligible ad to held-out users.

Prerequisites prerequisites

To prepare for using the Kevel destination, ensure the following prerequisites are met:

  • You must have an active Kevel network and API access.
  • You need a Kevel API key with permissions to create segments and update UserDB records.
  • You must configure identity namespaces in Experience Platform that map to the identities your site or app sends during Kevel ad requests, such as ECID, GAID, IDFA, and loyalty ID.
  • Only map identities that you send during real-time ad requests. Each mapped identity results in a UserDB record.

Supported identities supported-identities

The Kevel destination supports activation for any identity that your application may use when sending ad requests to Kevel. You may map up to three identity namespaces to generate corresponding UserDB records.

Kevel supports the following Experience Platform identity namespaces:

Identity namespace
Description
Typical usage
ECID
Experience Cloud ID
Used for onsite personalization and cross-Adobe identification.
GAID
Google Advertising ID
Used for Android app/device traffic.
IDFA
Apple Advertising ID
Used for iOS app/device traffic (subject to ATT consent).
EXTERNAL_ID
External ID (custom identifier)
Passes proprietary or backend-generated IDs.

Support for custom identity namespaces custom-identity-namespaces

The Kevel destination also accepts custom namespaces, as defined in your Experience Platform implementation.

This means:

  • You can map customer-specific identity namespaces, such as loyalty_id, gigya_id, or any custom identity you’ve defined in Identity Service.
  • You can assign these namespaces to kevel_user_key1, kevel_user_key2, or kevel_user_key3 the same way as global namespaces.

Identity mapping behavior identity-mapping-behavior

  • You may map up to three Experience Platform identity namespaces to Kevel’s three identity slots.
  • For each activated profile, Kevel generates one UserDB record per instance of each mapped identity, allowing real-time matching at ad decision time for each identifier your systems send.
  • Only map identities that you send in ad requests to Kevel to avoid unnecessary UserDB storage.

Screenshot of the identity mapping step showing three identity namespaces mapped to the Kevel identity slots.

Supported audiences supported-audiences

The Kevel destination supports the following audience origins and audience data types.

Audience origin
Supported
Description
Segmentation Service
Yes
Adobe Profile audiences evaluated by the segmentation engine.
All other audience origins
Yes

This category includes all audience origins outside of audiences generated through the Segmentation Service. Read about the various audience origins. Some examples include:

  • custom upload audiences imported into Experience Platform from CSV files,
  • look-alike audiences,
  • federated audiences,
  • audiences generated in other Experience Platform apps such as Adobe Journey Optimizer,
  • and more.

Supported audiences by audience data type:

Audience data type
Supported
Description
Use cases
People audiences
Yes
Based on customer profiles, allowing you to target specific groups of people for marketing campaigns.
Frequent buyers, cart abandoners
Account audiences
No
Target individuals within specific organizations for account-based marketing strategies.
B2B marketing
Prospect audiences
No
Target individuals who are not yet customers but share characteristics with your target audience.
Prospecting with third-party data
Dataset exports
No
Collections of structured data stored in the Adobe Experience Platform Data Lake.
Reporting, data science workflows

Export type and frequency export-type-frequency

The Kevel destination exports data using the following type and frequency.

Item
Type
Notes
Export type
Segment export
Kevel receives an update whenever a profile qualifies for or exits an audience.
Export frequency
Streaming
Updates are sent in real time using the Destination SDK streaming framework.

Connect to the destination connect

Follow the standard Experience Platform connect a destination workflow.

IMPORTANT
You must have View Destinations and Manage Destinations permissions.

Authenticate to destination authenticate

When connecting to Kevel, provide the following field:

  • Bearer token: Your Kevel API key.

Screenshot of the authentication step showing the bearer token field for the Kevel destination.

Fill in destination details destination-details

After authentication, configure:

  • Name: A label to identify this destination instance.
  • Description: Optional text to describe this destination instance.
  • Kevel Network ID: Your Kevel network identifier.

Screenshot of the destination details step showing the name, description, and Kevel Network ID fields.

Activate audiences to this destination activate

To send audiences to Kevel, follow the workflow in Activate audiences to streaming destinations.

Deactivate audiences deactivate

When an audience is deactivated or removed from the Kevel destination in Experience Platform, Experience Platform stops sending further profile qualification updates for that audience. Any existing segment created in Kevel remains available and is not automatically deleted.

If the Kevel segment is currently being used in an active campaign, Kevel prevents deletion to avoid disrupting live delivery. In this case, deactivation in Experience Platform results in the following:

  • The Experience Platform dataflow stops.
  • The Kevel segment continues to exist and may remain attached to campaigns until manually removed or the campaign is updated.

To fully stop targeting in Kevel, ensure the segment is removed from any active campaigns in Kevel’s campaign management system.

Map attributes and identities map

Kevel requires:

  • Identity namespaces: Up to three identity namespaces mapped to Kevel identity slots.
  • Audience membership: No manual mapping required. Experience Platform automatically passes audience membership identifiers and aliases.

During activation, select the identity namespaces you have configured for Kevel. Each identity generates its own UserDB update call.

Profile attributes (optional) profile-attributes

You can optionally map XDM profile attributes to Kevel. The destination recognizes the following target attribute name.

Target field name
Description
Value type
kevelGroup
The user’s incrementality testing group assignment. Used by Kevel to split users into test and control cohorts for measuring causal ad impact.
Integer (1 to 100)

To map a group attribute, add a new mapping row in the Mapping step and configure:

  1. Source field: Select the XDM attribute or computed attribute that contains the user’s group number, such as _yourSchema.incrementalityGroup.
  2. Target field: Open the target-field selector, keep Select attributes chosen, and select kevelGroup (Integer) from the schema.

Screenshot of the mapping step showing an XDM attribute mapped to the kevelGroup target field for the Kevel destination.

Validate the data export exported-data

When a profile qualifies for or exits an audience, Experience Platform sends a streaming update to Kevel.

Sample payload received by Kevel UserDB sample-payload

Experience Platform sends the following sample payload to Kevel’s UserDB API.

PUT /udb/{networkId}/segments?userKey=ECID-12345&group=42
{
  "segments": [1723, 3344, 9988]
}
Parameter
Description
userKey
Derived from the mapped Adobe identity.
group
(Optional) Sent as a query parameter. The user’s incrementality testing group (1 to 100). Only included if a profile attribute is mapped to the kevelGroup target field.
segments
The set of Kevel segment IDs corresponding to the Adobe audiences for which the profile is currently realized.

Sample Experience Platform profile used during export sample-profile

When activating audiences to the Kevel destination, Experience Platform sends profile fragments that contain both segment qualifications and the identities you mapped to Kevel’s identity slots.

Below is an example of an exported profile showing:

  • Multiple identity namespaces mapped to kevel_user_key1, kevel_user_key2, and kevel_user_key3
  • A single activated segment in the ups namespace
  • A profile attribute mapped to kevelGroup for incrementality testing
{
  "attributes": {
    "kevelGroup": 42
  },
  "segmentMembership": {
    "ups": {
      "9d161bbb-c785-474a-965b-7d7bc2adf879": {
        "status": "realized",
        "lastQualificationTime": "2025-12-10T21:43:38.541076Z"
      }
    }
  },
  "identityMap": {
    "kevel_user_key1": [
      {
        "id": "ECID-fN1zo"
      },
      {
        "id": "ECID-9Xr2p"
      }
    ],
    "kevel_user_key2": [
      {
        "id": "GAID-4oic4"
      }
    ],
    "kevel_user_key3": [
      {
        "id": "IDFA-nB5fU"
      }
    ]
  }
}

How Kevel interprets this profile kevel-profile-interpretation

With the Kevel destination configuration, each mapped identity generates a distinct UserDB record, meaning Kevel receives:

  • One update for ECID-fN1zo
  • One update for ECID-9Xr2p
  • One update for GAID-4oic4
  • One update for IDFA-nB5fU

This allows the same person to be recognized at ad decision time using any of their available identities, with each identity carrying an identical set of segment memberships.

When a kevelGroup attribute is mapped and present on the profile, each UserDB update also includes the user’s group assignment as the group query parameter, enabling Kevel’s incrementality testing feature to determine test and control cohort membership at ad decision time.

Data usage and governance data-usage-governance

All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, read the Data Governance overview.

Additional resources additional-resources

recommendation-more-help
experience-platform-help-destinations