Bloomreach

Overview

Bloomreach combines the power of unified customer and product data with AI optimization, helping deliver personalized customer journeys.

**API Information **

The Base URL used for the Bloomreach connector can be, for example, simply** https://api.exponea.com/,** but in many cases, this would be your own custom URL. More information can be found on their main API documentation site.

Authentication

Within the builder, click on the Bloomreach connector to display the connector properties panel. Select the Auth tab and click on the New authentication button. In the Tray.io authentication pop-up modal name your authentication in a way that will quickly identify it within a potentially large list. For example, whether it is a Sandbox or Production auth, etc. Consider who/ how many people will need access to this authentication when choosing where to create this authentication ('Personal' vs 'Organisational'). The next page asks you for your API key, API secret, Project token and Base URL credentials. To get these fields, head to the Bloomreach Engagement interface. Navigate to the settings section of your Bloomreach dashboard, found at the gear icon. Click on 'Project settings'. You can see your Project token within the General project settings. To find your API key, API secret, and base URL, click on 'Access management' and then 'API'. You will need to generate an API key and API secret. Once they have been generated, you won't be able to view the API secret again. However, you can generate a new one here if you need to. You can also view your Project key on this screen. Once you have added these fields to your Tray.io authentication pop-up window click the Create authentication button.  Your connector authentication setup should now be complete. Please run the simplest operation available to test and ensure you can retrieve data as expected.

Available Operations

The examples below show one or two of the available connector operations in use. Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Notes on using Bloomreach

The operations in Bloomreach are designed to be very customisable so as not to limit the schema you can send to the API. Please note that due to this, there may be some required fields required in some operations that are not obvious from the workflow input panel. Note also, that the output examples for each operation are for example only. The operation may return different or additional parameters when the operation is actually run, depending on your inputs.

Using the Raw HTTP Request ('Universal Operation')

As of version 1.0, you can effectively create your own operations. This is a powerful feature that you can use when there is an endpoint in Bloomreach that is not used by any of our operations. To use this you will, first of all, need to research the endpoint in the Bloomreach API documentation to find the exact format that Bloomreach will be expecting the endpoint to be passed in. For example, say that the 'Retrieve customer attributes' operation did not exist in our Bloomreach connector, and you wanted to use this endpoint. You would use the Bloomreach API docs to find the relevant endpoint - which in this case is a POST request called:** /data/v2/projects/{projectToken}/customers/attributes.**** ** More details about this endpoint can be found here. Based on the information provided in the above API call doc, you need to configure the following attributes on your Tray platform:

• Method: POST
• Headers:
  • Key: Content-Type
  • Value: application/json
• **URL: **
  • Endpoint : /data/v2/projects/{projectToken}/customers/attributes
• **Body Type: **
  • raw
  • &#123;"customer_ids": {"registered": "<the customer ID>"&#125;} Note that the endpoint URL requires your Bloomreach Project token. If you have created a Bloomreach authentication, select it for this connector. This will allow you to use the base URL, and also allow you to interpolate the Project token from your authentication into the endpoint URL via jsonpaths. A shortcut for interpolation is to start typing {$ in the input field. You can then choose the value you want from the drop-down. Once the API call is executed successfully, you should get the following results:

Bloomreach Example Usage

Below is an example of a way in which you could potentially use the Bloomfields connector 'Batch commands' operation, to update a customer's properties and add an event for a customer, at the same time. The overall logic of the workflow is:

1. Setup using a manual trigger and Bloomreach connector
2. Set your Bloomreach connector to the 'Batch commands' operation
3. Configure the operation inputs Your completed workflow should look similar to this:

Step-by-step Explanation