Bloomreach

​

Overview

​

How It Works

1. Listen: Zeotap CDP continuously updates your customer profiles based on data from your various sources.
2. Segment: You create specific audiences (segments) of users in Zeotap that you want to target.
3. Sync: Zeotap automatically pushes these user lists to Bloomreach Engagement securely.
4. Act: Bloomreach receives the data, allowing you to trigger personalized email, SMS, or push campaigns immediately.

​

Pre-requisites

• Access to your Zeotap CDP account with Admin or Editor permissions.
• Access to the Integrate (Destinations) module.

• An active Bloomreach Engagement project.
• Admin access to the project to view API settings.
• You will need to locate or generate four specific credentials:
  1. API Base URL
  2. Project Token
  3. Public API Key ID
  4. API Secret (Private Key)

​

Authentication

​

Step-by-Step Configuration Guide

​

Part 1: Get Your Credentials from Bloomreach Engagement

1

Log in to your Bloomreach Engagement dashboard.

2

Click on the Settings (cogwheel icon) in the top right corner and select Project Settings.

3

Navigate to Access Management > API in the left sidebar.

4

Copy the General Settings:

• Locate the API Base URL (e.g., https://api.exponea.com or your custom domain) and copy it.

Note:Currently we do not allow the support of custom URL. Please contact your CSM to have this changed for your org.

• Locate the Project Token (a unique alphanumeric string) and copy it.

5

Generate Your Keys:

• Scroll down to the API Groups section.
• You must use a group with Private Access. If you don’t have one, click + New Group, select “Private Access,” and give it a name (e.g., “Zeotap Integration”).
• Ensure this group has permissions for Import and Customers (Write access).
• Click the three dots next to the group and select Get Private Key.
• Copy the Public ID (this is your API Key ID).
• Copy the Secret (this is your API Secret).
• Important: Save the Secret immediately. Bloomreach will not show it to you again once you close the window.

​

Create a Destination for Bloomreach

1

Log into the Zeotap CDP App and go to the DESTINATIONS application.

2

Click + Create Destination.

3

Under the All Destinations section, search for Bloomreach.

4

Click Bloomreach. A screen appears displaying details about the particular destination towards the left. On the right-hand side of the screen find a list of fields that are required for the integration to be established. Enter the required details as mentioned in the following steps:a. Enter a name for the Destination.

b. Enter the API Key, secret and Project ID of your Bloomreach instance. The steps to get the API key is mentioned in the Authentication section of this document.c. Review all the values entered above and then click Next to proceed.

5

In the new screen that appears, choose the appropriateaction and mapping as explained below. Under Choose your Action, choose add or update users or Add events as the action.

6

You need to map the following fieldsi. Identifier Hard ID (registered)ii. Event Type for Adding events to a useriii. Any other custom field in the Properties using the +Add Mapping button(optional along with other fields)

Click Create Destination. The created Destination gets listed in the Journeys application, which can be linked to any particular journey.

​

Activate the Destination on Journeys

1

In the workflow, click + and choose Send to Destinations.

2

Choose the destination from the list of available destinations by using the search feature

3

Under the Destination Details tab, the API key, Secret and Project ID fields are automatically populated based on the value that you have entered while creating the destination.

4

Under the Destination Settings tab, choose the mapping as per your requirement

5

Upon clicking Save Destination. The destination is attached as shown in the image below.