HomeEngagementContentDiscoveryOther Resources

Set-Up

Suggest Edits

🚧

Prerequisites:

Before starting the Set-Up process, make sure that you have:

  • A Bloomreach Engagement project with integration access,
  • Fair knowledge of Javascript.

Select a Platform

Before getting into Omniconnect, it is vital to identify the platform you want to integrate with. Your selected platform needs to support Webhooks; otherwise, the integration will not be possible.

📘

Note

Each platform identifies Webhooks differently. It is possible that your selected platform might call it differently. Some common examples of alternative names can be API Notifications or Web Service Requests.

For the purpose of this guide, Typeform will be used as an example. You can follow the same steps with other platforms and adjust the process to your needs.

Watch this short demo on how to integrate Typeform with Bloomreach Engagement.

1. Add a New Integration

To integrate with a 3rd party platform using Omniconnect, go to your Bloomreach Engagement account. From there,

  1. Go to Data & Assets > Integrations.
  2. Click on + Add new integration.
  3. Search for Omniconnect.
  4. Click + Add integration.
  1. Give your integration a name and click on Save integration.
  2. Provide a description that explains the function of this integration.
  3. Copy the Omniconnect URL.
  1. [Optional] Go to your Typeform Workspace > Connect > Webhooks > Add a webhook.
  1. Paste the Omniconnect URL into the dedicated place inside the 3rd party platform (in this case, Typeform).

2. Transformation

The two platforms are now connected. It's time to look at the transformation function.

  1. Go to your Omniconnect Integration in Bloomreach.
  2. Click on Transformation.

Incoming request

The Incoming request dropdown menu lists the incoming data from the platform. We suggest you choose the most recent one.

Input

The input will be automatically updated once you select the required request. Go through the data to make sure everything is delivered to Bloomreach correctly.

Transformation Function

The next step is to write the Transformation Function. The transformation function will vary from integration to integration and allows for a high-level personalization of the integration using Javascript. To view the sample Typeform Transformation Function, visit the Use Cases part of this guide.

When the Transformation Function is done, click on Transform input. You will now see the data from the survey in the Output tab.

3. Track the Integration

Once you are happy with the Transformation part, click on Save changes.

You are now ready to go live with the integration! Do so by clicking on Start. The integration has now successfully started.

Go to Data & Assets > Customers to track the events coming to Bloomreach from the platform. The data from the platform will automatically update customer profiles.

Updated 5 days ago