Skip to main content
Bloomreach - Getting Started

Get going with Bloomreach and Jacquard

Updated over 5 months ago

Create your token

Before we begin this process, make sure you've got your Jacquard Connect Server token handy. If you don't have one, your Jacquard admin can create one for you by following these instructions.

Jacquard and Bloomreach

Jacquard's Bloomreach integration leverages our cutting-edge Dynamic Optimisation technology. Dynamic Optimisation powers real-time optimisation by evaluating and reacting to how your subscribers are responding to language during a deployment. This ensures the best-performing language reaches the widest possible audience.

To get these two technologies talking to each other correctly, we'll need to set up two Bloomreach integrations. Let's start with HTTP Authentication Schemas.

HTTP Authentication Schemas

This integration will handle the authentication of the real-time endpoint call Bloomreach will make to Jacquard.

Essentially, it's preprogramming a password of sorts for Bloomreach to use when reaching out to Jacquard for your language variants.

On the left side of your screen in Bloomreach, hover over Data & Assets and then click Integrations.

Click Add new integration.

Hover over HTTP Authentication Schemas and click Add integration.

Start by giving the integration a unique name. In the example below, we have used Phrasee Realtime.

For the Endpoint, you should use https://realtime.phrasee.co. Then, select the Custom headers option.

Under Key, type Authorization.


For the Value, you should type Bearer and then a single space. After the space, paste your Jacquard Connect Server token.

Now, set the Type to public.
​

When you're done, it should look something like the below:
​

Now, you can save this integration with the Save changes button.

Webhook preset

The second Bloomreach integration we need to set up is the Webhook preset. This is the technology that will actually pass your language variants from Jacquard to Bloomreach.

Head back to the Integrations section we were in before. Hover over Webhook preset and click Add integration.

Again, start by giving your integration a unique name. We have used Phrasee Get Variant in the example below.

Now, it's time to complete the settings.

Selecting an Icon is optional, as is adding a Description. (But they both make it all look so much prettier down the road, and who doesn't want that?)

Set the Preset type to Normal Webhook. Set the Endpoint URL to GET. For the URL itself, paste in the below:

https://realtime.phrasee.co/live/single_variant?campaign_id=[[phrasee_campaign_id]]

For the Authentication method, you can now select the HTTP Authentication integration you created before. You'll recall we named ours Phrasee Realtime for our example.

Your setup should now resemble the below:

Under Response processing, choose Process response as JSON.

Throughput Policy

You will also have to create a Throughput policy at this point. Toggle the Throughput policy switch on. Then, click the gear that appears.

Your Customer Success representative will have a recommendation for what you should enter here. In our example, we've chosen Realtime API for the Policy name and a Concurrency limit of 100. We recommend that your limit is increased for every webhook within an scenario (for example - if there are 5 webhooks in a scenario then set the limit to 100*5 = 500).

The assignment of the Consent category will depend on your Bloomreach setup. Customers is the default here.
​

Now, click Save integration.

Configuration complete

At this stage, you should have two configured integrations.
​

This one-time setup is complete. Now, let's move on to adding the ever-important Jacquard custom campaign tracking!

Did this answer your question?