If you're here, you must be about to embark on an amazing brand language optimization journey with Phrasee and Bloomreach (formerly Exponea).

We're so excited for you and about this amazing partnership. We're itching to come up with a celebrity couple name for it. #Bloomsee? #Phroomreach? We'll workshop it.

Meanwhile, let's get you started with some setup.

Before we begin this process, make sure you've got your Phrasee Connect Server token handy. If you haven't been given a Phrasee Connect Server token, please reach out to your Phrasee Customer Success Manager to request one.

Have you got your token? Promise? Okay!

Phrasee's Bloomreach integration leverages our cutting-edge Phrasee X technology. Phrasee X powers real-time optimization 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 terrific technologies talking to each other correctly, we'll need to set up two Bloomreach integrations. Let's start with HTTP Authentication Schemas.

Wow. That's a bunch of fancy words right there. This integration will handle the authentication of the real-time endpoint call Bloomreach will make to Phrasee.

Essentially, it's preprogramming a password of sorts for Bloomreach to use when reaching out to Phrasee 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 Phrasee 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.

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 Phrasee to Bloomreach. Phancy, right?

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:

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.

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 Manager 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.

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 Phrasee custom campaign tracking! Note: You must be logged into Phrasee to view this article.