This article reviews minimum required settings from deploying Jacquard experiments with Bloomreach Scenarios. You should still set up your other nodes within the Scenario according to your typical process.

If you have completed the integration setup, you're now ready to deploy a Jacquard experiment with Bloomreach.

To do this, you're going to use Bloomreach's Scenarios feature. This will allow Jacquard to optimise your send's language over preconfigured period of time. If you're not familiar with Bloomreach Scenarios, read up on them here before continuing.

1. Create a new Scenario

When you're ready to set up an experiment, start by going to Scenarios. You'll find them by hovering over Campaigns on the left side of your Bloomreach homepage.

Start by creating a new Scenario with the New Scenario button in the upper-right corner.

Click Create New Scenario on the pop-up menu, as we'll want to start from a blank template.

Give your Scenario a unique name using the pencil icon.

Whether you're setting up a broadcast or trigger experiment, the steps we follow will be largely the same. One step will be for broadcast only and will be noted in the section headline.

2. Add a Trigger

Start building the Scenario by adding a Trigger that will serve as the start the experiment.

In our example, we're using Now so the Scenario will begin immediately when we click the Start button. You can use On date if you'd like to schedule this Scenario to run later for a broadcast experiment. You should choose Repeat, On event or API trigger if this is a triggered experiment that will be running over a longer period of time.

Simply click and drag your desired Trigger to the canvas.

3. Add a Wait operator (broadcast only)

If this is a broadcast experiment, expand the section below to add a Wait operator. Otherwise, skip to step 4.

Wait operator (broadcast only)

Click and drag a Wait operator to the canvas.

Connect the Trigger node to the Wait node.

Double-click the Wait node and select Dynamic time period. Copy the following code into the blank space below Dynamic time period:

{{ range(0,360) | random }}

Now, select minutes from the dropdown menu.

This code determines the duration of your send. The number 360 is indicating the number of minutes to send over. This is editable and may vary based on your business case.

Jacquard generally recommends a minimum of 4 hours (240 minutes) but preferably 6 hours (360 minutes) when optimising in-app or web push messages. Speak with your Jacquard Customer Success representative to determine the best time period to use for your audience.

When you're finished your settings should resemble the below:

Click the Done button to save your send time.

4. Add an Other action

Click and drag an Other action to the canvas.

In the window that pops up, choose your the webhook integration you created during integration setup with the Select button. You'll recall our example integration from earlier is called Jacquard Get In-App Variant.

Then, paste your Jacquard Experiment ID in the text box that appears and click Done.

You'll find your Jacquard Experiment ID in the Jacquard platform in the column on the right side of the screen within your unique experiment.

Connect your Other node to your previous node.

5. Add a message action

Finally, drag the appropriate message Action node to the canvas and connect it to the Other node you just configured.

If this is a broadcast experiment Scenario, you should now have four nodes connected like the following:

If this is a trigger experiment Scenario, you should have three like the following:

6. Configure the message Action

Double-click on the Action node.

We'll now set up the message action in the final step in the scenario in order to send the message with the retrieved variant.

It's important to determine before continuing if your variant is going to have one field or two. You should be able to tell by the generation you did in Jacquard. If there is a single line of text per variant, your variant will all be assigned to one field (e.g. Message). If there are two lines of text per variant, your variant will need to be assigned to two fields (e.g. Title and Message) and some additional code will be required.

Expand the relevant section below to continue.

One field

Use the retrieved variant anywhere in the message editor by including the following handlebars code:

{{ webhook.variant_text }}

You can’t preview the message with the embedded content due to limitations with Bloomreach. However, you can test the webhook response in the Other step you configured to ensure the content is being retrieved.

Two fields

To use the retrieved variant in two fields (e.g. Title and Message), you'll need to use our special handlebars code to divide the variant in two.

To do this, you'll need to use the following code for the field that should receive the first line of your variant:

{% if (webhook.variant_text) %}
{{ webhook.variant_text.split('〽') | first }}
{% else%}
PASTE HUMAN CONTROL FIRST LINE HERE
{% endif %}

Then, enter the following code in the field that should receive the second line of your variant:

{% if (webhook.variant_text) %}
{{ webhook.variant_text.split('〽') | last}}
{% else%}
PASTE HUMAN CONTROL SECOND LINE HERE
{% endif %}

Don't forget to replace the PASTE HUMAN CONTROL placeholder line in each bit of code with your actual human control language for each field.

When you're finished, your message should resemble the following:

Next, ensure you select the appropriate Consent category from the Settings tab.

Finally, double-check that all of your Custom campaign tracking is pulling in properly on the Settings tab just below. Jacquard custom campaign tracking should match the following:

Custom attribute name	Default value
phrasee_campaign_id	{{ webhook.campaign_id }}
phrasee_batch_id	{{ webhook.batch_id }}
phrasee_variant_id	{{ webhook.variant_id }}
phrasee_send_id	{{ webhook.send_id }}
phrasee_project_id	{{ webhook.project_id }}
phrasee_variant_text	{{ webhook.variant_text }}
scenario_id	{{scenario.id}}{{time \| from_timestamp('%y%m%d')}}

From here, simply configure the rest of your message action as you normally would and then click Done in the upper-right corner.

7. Proof your messages (optional)

If you wish to proof your Jacquard language variants, please expand the Proofing section below for further instructions.

Proofing process

Jacquard's Bloomreach integration utilises Webhooks. Therefore, the native message action previewing doesn't return any Jacquard content.

Instead, before Starting the Optimisation in Jacquard, it is recommended you clone the experiment in Jacquard, and use the cloned Experiment ID to send the Scenario to a dedicated test audience (with the necessary audience adjustments being made).

You may need to repeat the send multiple times to return all variants.

Once the content has been approved via the proofs, the main Experiment can then be started, and the Scenario can be updated to reflect the live audience and Experiment ID.

Now, simply configure the rest of your Scenario as you usually do and then you're ready to deploy your experiment.

Article path

Previous article	Next article
< Integration Setup

Page last reviewed: 25 March 2025