Bloomreach Integration

Step-by-step guide for brands to complete the Duel x Bloomreach integration.

⚠️ Before you begin this integration be sure to let us know so we can enable the Bloomreach setting on your Duel account.


ℹ️ Bloomreach Help Center (external resources).

Step 1: API Keys & Tokens

Open Bloomreach, click on your Settings (top right) and then Project settings from the drop down menu. 

Screenshot 2022-12-02 at 12.20.13

On the left hand side, click into Access management:

Screenshot 2022-12-02 at 12.21.41

And then click into API:

Screenshot 2022-12-02 at 12.24.30

Project Token:

First, Duel requires the project token. Copy the token to your clipboard.

Screenshot 2022-12-02 at 12.42.03

With the token copied to your clipboard, open the Duel app. Navigate to Settings (by clicking your logo in the top right), then Bloomreach, and Settings. Paste the token under “Project token”.


Next, we need the API Base URL. Copy the URL to your clipboard and paste it into Duel under “API Base URL”.

Screenshot 2022-12-02 at 12.43.01

API Secret:

Add a new key - we recommend naming this “Duel” or something similar. Copy the secret API key to your clipboard and paste it in Duel underneath “API Secret”.

Screenshot 2022-12-02 at 12.50.32


Once you have created a new key, you will notice it appear under your “Group keys”. Copy the API Key ID to your clipboard, and paste it in Duel under “API Key ID”.

Screenshot 2022-12-02 at 13.01.29
Customer hard ID:

Lastly, in order to send member updates, we need their hard ID, which can be found on the customer detail page. Copy this to your clipboard and paste it into the field labelled "Customer Hard ID"


Step 2: Enabling Events/Properties

Within the Bloomreach section of the Duel app, head to “Events/Properties” and switch on all elements that you’d like sent over to Bloomreach. We recommend enabling all, so as to capture as much data as possible.

Screenshot 2021-09-10 at 10.39.42

NOTE: You are able to change the Targets for each source if you would like to. 

Step 3: Export & Import Members List

Still within the Bloomreach section of the Duel app, head to “Member sync” and click “Export members (.csv)”. Once the export is complete, head back to Bloomreach to import the list. 

Screenshot 2022-12-02 at 13.27.29

Screenshot 2022-12-02 at 13.06.25Within Bloomreach, navigate to Imports within the left hand side:







Create a new import, using the button in the top right, and select “Customers” when asked which data type you’d like to import. From here, you can name the import, and upload the CSV file you exported from Duel.

Screenshot 2022-12-02 at 13.07.25

This sync is only relevant if you have existing members in the program, all new members will be automatically sent to Bloomreach.

Step 4: Test the integration

Within your “Customers” list (under Data & Assets), you can check that the Duel parameters are visible. You can find any Duel events & properties within each individual profile page (see below)  

Screenshot 2022-12-02 at 13.13.49Screenshot 2022-12-02 at 13.14.06

Step 5: All done! You are now integrated with Bloomreach

Now it's time to set up some epic flows and build that community!