Segment-based content personalization is a feature that brings Bloomreach Content with [Bloomreach Engagement](🔗) even closer by integrating _Channels_ in Bloomreach Content with **Engagement Projects**.
Watch the video below for an introduction:
This integration can be found in the _Integrations_ section of your environment (_Setup -> Integrations_).
Thanks to the backend-to-backend synchronization between Bloomreach Content and Engagement, you can assign an Engagement project to **multiple channels**. But a _Channel_ can be assigned to just **one Engagement project** (or none if you choose not to make use of the feature). When you assign a _Channel_ to an Engagement project, the channel's _core_ and all its branches are connected to the project. It is not possible to connect a specific branch of a _Channel_ to a different project, **only the core of a _Channel_ can be assigned to a project.**
Keep in mind:
Assigning a _Channel_ to an Engagement project can only be done if it hadn't previously been assigned. If you want to assign the same _Channel_ to a different Engagement project, you must first delete it from the other project.
If you had segmentations added manually before, you need to configure the connection to ensure that segment-based content personalization works as before.
In addition to setting up the backend synchronization, you must also [implement segment-based personalization in your SPA](🔗).
## Which roles can set up the integration?
**Site Admins** can:
add Engagement project integrations to manage different sets of campaigns, segments, and segmentations,
create Engagement projects to import campaigns and segmentations that belong to these projects,
view and delete Engagement projects to manage their previously imported campaigns and segmentations, and
have the 'base64' encoding of the authorization header be done automatically.
**Content Authors, Content Managers, Site Editors, Site Admins,** and **Site Developers** can:
edit a _Channel_ to create component variants for segmentations for a certain project,
have an overview of all Engagement projects, and
view all campaigns and segments of a certain Engagement project.
On the Engagement side, **Segmentations Exporters**, **Analyses Editors** and **Project Admins** can expose segmentations to Content.
## Set up your Integration
Before setting up your integration, follow this checklist:
Verify that you can access Integrations in **Content SaaS** _(Set up -> Integrations)_ and projects in **Engagement** with the correct user role to manage project configuration - _Project Admin_.
Verify that your segments in **Engagement** are exposed: go to _Analyses_, click on _Segmentations_, and enable _Show only exposed_ segmentations with the toggle (to learn more about synchronizing segmentations, click [here](🔗)) .
Currently, you can expose only up to 30 segmentations from Engagement.
Verify that you have access to API management in **Engagement** by clicking on _Project settings_ in the top right corner and choosing _Access management_ from the left-hand side menu where you can find API management.
### Set up the Integration
First, you need to create a private API group in **Engagement**. To do so, navigate to the API management as shown in the [_Prerequisites_](🔗).
Click on the dropdown with API groups and select _+ New group_. Choose the _Private access_ option and name your new API group. Make sure to **copy and store your _Secret key_ as you will not be able to access it again!**
After you create your group and copy your Secret key, scroll down to _Group permissions_ and click on the _BrX_ tab. Select the _Content integration_ checkbox, and _Save the changes_.
For the next step, open your **Content SaaS** environment in a new tab. Navigate to the Integrations overview by clicking on _Setup -> Integrations_. To add an Engagement integration, click on the _Add_ icon next to the _Engagement project_ tab under _Available integrations_.
Copy and paste the information provided in the _Project settings_ in **Engagement** into the corresponding fields in the _Add integration_ menu in **Content SaaS**.
Scroll down to find the _Channels_ selection tab. Click on _Select_ to choose which channels you want to connect the Engagement project to. After selecting your _Channel_, click the _Add_ button in the right-hand to add the integration.
It is possible to verify your connection by clicking on the _Test connection_ button. After verifying your successful connection, _Save_ the integration.
After saving your integration, navigate to _Content Audience_ and choose your project to see segmentations. Integrations that have been removed will be classed as inactive.
Good to know:
Engagement and Content sync every hour in the background. You can trigger the sync any time you want by clicking on the _Segmentations_ button.
Old segments that are not part of the project that you integrated will be moved to the "Unexposed segments" tab.