Introduction

The Bloomreach Commerce Experience Cloud provides a suite of products designed to drive personalization and digital commerce growth. These include Discovery, which uses AI-driven search and merchandising; Content, a headless CMS; and Engagement, a leading Customer Data Platform (CDP) with marketing automation tools. Together, these solutions leverage unified customer and product data, combined with the speed and power of AI optimization, to create revenue-boosting digital commerce experiences that convert across all channels and customer journeys.

Annex Cloud's Loyalty Success Services focus on aligning with your brand promise while meeting customer needs and expectations. Their loyalty strategy engages customers at every touchpoint. The Annex Cloud platform uses a single-site ID for all client-related factors, with each site differentiated by country, language, currency, and other variables.

Purpose

This document outlines the integration between Annex Cloud and Bloomreach. By combining the strengths of both platforms, businesses can use customer loyalty data to enhance digital experiences and create more personalized customer journeys.

User Sync Integration Guide

Obtain API Tokens and Base URL

To begin, you’ll need to access your project token, API token, and API base URL for the integration. Follow these steps:

1. Navigate to Settings: Go to the Settings section on your dashboard.
   Access Project Settings: Click on "Project Settings" for project-specific configurations.
   
2. Locate API Settings: On the Project Settings page, find the API settings section.
3. Generate or View Tokens: You will find options to generate or view your project and API tokens, which are used for authentication.
   
4. Find API Base URL: The API base URL should also be listed here, and it will serve as the foundation for all API requests.

Sync Users from Bloomreach to Annex Cloud

Follow these steps to sync users from Bloomreach to Annex Cloud:

Step 1: Log in to Bloomreach

1. Open a web browser and navigate to Bloomreach .
2. Enter your login credentials to access your Bloomreach account.

Step 2: Navigate to Scenarios

1. After logging in, you’ll be directed to the Bloomreach dashboard.
2. Look for the 'Scenarios' button (as shown in the image below).
   

Step 3: Create a New Scenario

1. Click on 'Create New' to initiate a new scenario for syncing users.
   

Step 4: Add Triggers, Actions, Conditions, and Operators

1. Add Triggers: Define the event or condition that will trigger the sync process (For example, user actions or changes in user data).
2. Add Actions: Specify the action to be taken when the trigger occurs. Here, the action will be syncing user data to Annex Cloud.
   
3. Add Conditions (Optional): You can add conditions to refine when the sync should occur.
4. Add Operators: Use operators to define relationships between triggers, actions, and conditions.
   

Step 5: Add Webhook Action

• In the scenario setup, locate the option to add an action.
• Choose the webhook action to integrate with Annex Cloud.
  

Step 6: Specify Endpoint and Payload

• Define the endpoint URL where Annex Cloud expects to receive the data.
• Configure the payload to include the necessary user data you wish to sync.

Step 7: Configure Additional Settings

• Add Headers: Include any necessary headers, such as Content-Type or custom headers specified by Annex Cloud.
• Set Authentication: If authentication is required, configure it within the webhook action settings (e.g., using API keys or OAuth tokens).
  

After completing these steps, save all changes to your scenario in Bloomreach.

Sync Users from Annex Cloud to Bloomreach

To sync customer data from Annex Cloud to Bloomreach, follow these steps:

1. Access the Customer API Endpoint: Use the following API endpoint to retrieve customer data from Annex Cloud:

Customer API Endpoint:
https://api-demoapp.exponea.com/track/v2/projects/cf68a938-8e46-11ec-a601-5aacd9056366/customers

2. Process Data: The retrieved customer data is processed and transmitted to Bloomreach using the "Bloomreach" library in the production API environment.

Push Loyalty Event Details to Bloomreach

To push loyalty event data to Bloomreach, follow these steps:

1. Access the Event API Endpoint: Use the following API endpoint to send loyalty event details to Bloomreach:

Event API Endpoint:
https://api-demoapp.exponea.com/track/v2/projects/cf68a938-8e46-11ec-a601-5aacd9056366/customers/events

2. Transmit Data: The event data is transmitted via the "Bloomreach" library in the production API environment.