Ibexa Activation

Introduction

Raptor's Customer Data Platform (CDP) integrates with Ibexa DXP. From the CDP, it is possible to synchronize audiences directly into Ibexa as segment groups, enabling personalized content experiences based on CDP-defined customer segments. Here is how to create an Ibexa activation.

Enter general information in Raptor

In Raptor, you will find a template created to assist the integration setup. To create the Ibexa Activation, go to Customer Data Platform → Activations → Create New Activation → Ibexa.

Type in a Name, optionally include a Description, and select userid as the Person Identifier. This is required for the Ibexa integration — userid maps to the id field in Ibexa DXP and must be set consistently in both your Raptor schema and this activation. Then click Next.

🔍 Note: If userid is not present in your available identifiers list, a warning will appear. Make sure your Raptor schema has been set up with userid as the Person Identifier before creating this activation. See the Ibexa documentation for further guidance.

Enter Ibexa information

To establish communication between Ibexa and the CDP, you need the following four values. These must match the ones provided in the configuration on the Ibexa side. They are entered in the Ibexa information section of the activation setup.

Client Secret

Used to authenticate against the Ibexa Webhook endpoint. In the Ibexa configuration, this value is taken from an environment variable in the .env file.

Client Id

Used alongside the Client Secret to authenticate against the Ibexa Webhook endpoint. In the Ibexa configuration, this value is also taken from an environment variable in the .env file.

Base URL

The URL of your Ibexa instance with /cdp/webhook appended at the end — for example: https://ibexa.co/cdp/webhook

Segment Group Identifier

The identifier of the segment group in Ibexa DXP where all CDP audiences will be stored. This must match the segment group identifier defined in the Ibexa configuration — for example: example_segment_group_identifier

Once all four fields are filled in, click Next.

Add audiences

In this step, you select which Audience(s) from the CDP should be linked to the Ibexa activation. Click + Add audiences and check the box next to each audience you want to synchronize. Then click Apply.

Each audience will appear in the audiences table with columns for Synchronization status, Last synchronized, and Last checked for audience changes.

Finally, click Save to create the activation.

How it works

When the activation runs, Raptor's CDP evaluates which customer profiles belong to each linked audience and pushes those profiles to the specified Segment Group in Ibexa DXP. Ibexa can then use segment membership to personalize content, page blocks, or other DXP features for matched users.

The Person Identifier selected in step 1 determines how Raptor matches a CDP profile to a user in Ibexa — ensure the same identifier type is used consistently across both systems.