Bloomreach

​

Supported syncing

​

Connect to Bloomreach

To use the Bloomreach destination in Hightouch, you need to provide a Bloomreach API Key, API Secret, API URL, and Project Token. Follow these steps to retrieve your credentials:

1. In Bloomreach, click the wheel icon in the top right corner. Select Project Settings from the dropdown.
2. Click on Access management in the side navigation. Select API from the options.
3. Your Project token and API Base URL are here. You can either use an existing API Key ID and API Secret, or you can click + Add key to create another one.

​

Syncing data

​

Events

When syncing events, Hightouch treats any records added to your source as new events and sends them to Bloomreach when your sync runs. You need to select the type of event and one or more hard and/or soft customer IDs to make the API call to Bloomreach. The most common customer IDs are registered.

​

Field mapping

One or more of the event properties, also known as attributes, are required. The event properties show up as custom mappings and attach custom data relevant to your event. For more information about event properties, refer to Bloomreach’s documentation.

​

Customers

You can also sync to the Customers object. This integration supports Upsert mode, meaning you can insert new customers and update existing ones in Bloomreach.

​

Record matching

You can match rows in your model with customers in Bloomreach on one or more of the following hard and/or soft customer IDs:

• Cookie
• Email
• Registered

​

Field mapping

You need to include at least customer property you wish to update. The customer properties show up as custom mappings and attach custom data relevant to your customer. For more information about customer properties, refer to Bloomreach’s documentation.

​

Catalogs

You can sync data to Bloomreach Catalogs to manage product or item data. This integration supports Upsert mode, allowing you to insert new catalog items and update existing ones.

​

Catalog selection

You can either create a new catalog or sync to an existing catalog in Bloomreach. When creating a new catalog, Hightouch automatically creates the catalog with fields based on your mappings.

​

Record matching

You must match rows in your model with catalog items using the Item ID field. This uniquely identifies each item in the catalog.

​

Field mapping

Map columns from your source to catalog item properties. These properties contain the data for each item in your catalog, such as product name, price, or description. For more information about catalogs, refer to Bloomreach’s documentation.

​

Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the live debugger. To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up sync alerts. If you run into an issue this page doesn’t cover, .