Bloomreach is a leading digital experience platform that empowers businesses to deliver personalized customer journeys across channels. By adding Bloomreach integration, you can supercharge your campaigns with gamification, driving higher engagement and fostering lasting customer connections.
In this article, we'll explore the process of configuring the Bloomreach integration in the platform. We will cover how to:
Setting up the integration
To add the Bloomreach integration, navigate to the integrations tab select 'Email Provider' find and select Bloomreach on the list.
To connect Bloomreach with Playable, you’ll need to authenticate with a:
Project token
Public key
Private key
API endpoint
Tip: Ensure the Bloomreach API permissions has sufficient group permissions (e.g., read/write access). Check the group permission documentation in Bloomreach.
Select trigger
The trigger is the event that determines when data should be sent through the integration.
The triggers available depend on the placement of your registration form(s) and whether you have included prizes in the campaign.
Trigger name | Event that triggers data transfer |
Primary registration form submitted | Data is sent every time the primary registration form (containing the email field) is submitted |
Game completed | Data is sent as soon as the game status is known (winner or loser), only if the primary registration form has already been submitted. Note: this option is only available if registration form is placed BEFORE the game. |
Prize won | Data is sent when a regular prize has a winner assigned (whether or not the game has been completed) |
Bulk prize won | Data is sent when a bulk prize has a winner assigned (whether or not the game has been completed) |
Add additional conditions
It is possible to add additional conditions to the trigger. Together with the trigger, these must be met in order for the data to be transferred.
Using the form field option you can define a specific field in the registration form(s) that must be filled out.
With the advanced option you have the option to set up a data flow based on more complex conditions. For example, the trigger could be based on performance in the game or a specific selection or data input in the registration form.
Mapping data fields
In order to send data over to Bloomreach, you need to map information collected in Playable to your contact fields in Bloomreach. By mapping the data fields, you will make sure that data is sent to the correct contact fields.
The integration displays default fields that data can be transferred to, like first name, last name, e-mail etc.
If you are not able to find the correct field, you may have to manually define it. Read more in the next section.
Custom Fields and Static values
Custom fields in Bloomreach allow you to store and manage additional information about contacts. These fields can be used to enrich the data you collect and customize your campaigns.
When you add a custom field in Playable, the data is transferred as part of the JSON payload. For example:
How to setup custom fields:
Scroll down to the Custom Fields section in the bottom of the integration settings.
Add a new field by specifying the
NameandValue.Name: Corresponds to the field group in the JSON (e.g.,
preferences).Value: Matches the subfield within the group (e.g.,
acceptsEmailoracceptsSms).
Mark the field as required if applicable.
Example of how it can look:
Static values
Static values allow you to send consistent, predefined data as part of the JSON payload, regardless of user input. These values can be mapped to fields and used for fixed parameters in your campaigns.
How to Set Up Static Values:
Scroll to Integration setup > Static information.
Add the value in the Static value field.
Example: Sending a constant source for all registrations.
Name: Source
Value: Playable
Test and troubleshoot the integration
We always advise that you test the integration by going through the actual campaign. The testing process will depend on what your triggers are, but we suggest that you test by submitting the registration form(s) and play through the game.
In the activity tab, you will be able to check if the data has successfully been transferred to Bloomreach. To learn more about how to test the integration, please read this Help Center article.
You can also find more information about troubleshooting integrations.