Bloomreach Set Up

Prerequisites

Before you begin, gather the following:

Integration architecture

A complete two-way integration consists of four core steps:

Optional extensions include Client Zone tracking, Bloomreach In-App Personalization, Apple Push Notification Service, and Firebase Cloud Messaging.

1. Create Bloomreach API authorization for TRIFFT

TRIFFT needs the following Bloomreach connection details:

• API Base URL
• Project Token
• API Key
• API Secret

Retrieve the API Base URL and Project Token

1. Log in to the correct Bloomreach project.

2. Click the gear icon in the top-right corner.

3. Open Project settings.
   

   

4. In the left navigation, go to Access management → API.

5. Copy the Project Token and API Base URL shown at the top of the page.
   

   

Generate the API Key and API Secret

1. Stay on the Bloomreach API page.

2. Scroll to API groups.

3. Select New group.

4. Set access type to Private access.

5. Name the group, for example TRIFFT.

6. Create the group.

   

7. Copy and securely store the API Secret shown in the popup.
   

   

8. Copy the API Key from the Group keys section.
   

   

Assign required permissions

Enable both GET and SET permissions for:

• Customer Properties
• Events

These permissions allow TRIFFT to send events and customer-related data to Bloomreach.

Enable the Bloomreach integration in TRIFFT

1. In TRIFFT, navigate to Settings → Integrations → Bloomreach.
2. Enable the integration.
3. Enter the connection values available in the project configuration, including the Base Endpoint, Project Token, and authorization credentials/token.
4. Save the configuration.
5. Keep optional tracking channels disabled until they are required and ready for testing.

2. Configure TRIFFT → Bloomreach event delivery

Create Bloomreach authorization in TRIFFT

1. In TRIFFT, navigate to Settings → Webhooks.
2. Open the Authorizations tab.
3. Click Add new.
4. Configure the authorization:

5. Click Save.

Create an event webhook

Create one webhook for each TRIFFT event that should be available in Bloomreach.

1. Return to the Webhooks tab.
2. Click Add new.
3. Configure the webhook:

4. Click Save.

Recommended Bloomreach event structure

{
  "event_type": "your_event_name",
  "properties": {
    "example_property": "{{ event.example }}"
  },
  "customer_ids": {
    "email_address": "{{ member.email }}",
    "trfft_loyalty_id": "{{ member.id }}"
  },
  "timestamp": "{{ event.created_at | date('U') }}"
}

Identity-mapping checklist

• Confirm which identifier is the Bloomreach Hard ID.
• Confirm which identifiers are configured as Soft IDs.
• Use exactly the same identifier names in customer_ids.
• Confirm the rendered identifier values are not empty.
• Test with a customer who already exists in Bloomreach.
• Verify the event appears in the correct customer's timeline, not only in webhook logs.

3. Create TRIFFT API authorization for Bloomreach

Use this setup when Bloomreach Scenarios need to call TRIFFT APIs.

Generate a TRIFFT API key

1. In TRIFFT, navigate to Settings → API Keys.
2. Click Add new.
3. Enter a note, for example Bloomreach.
4. Enable the permissions required by the planned Scenarios.
5. For the full two-way setup described in the legacy integration, enable Read Access and Write Access.
6. Click Save.
7. Copy the generated API token and store it securely.

Create HTTP Authentication in Bloomreach

1. In Bloomreach, go to Data & Assets → Integrations.
2. Click Add new integration.
3. Select HTTP Authentication Schemas.
4. Configure the integration:

5. Save the integration.

For requests with a JSON body, also add:

content-type: application/json

4. Create TRIFFT webhook presets in Bloomreach

Webhook presets make TRIFFT actions reusable across Bloomreach Scenarios.

1. In Bloomreach, go to Data & Assets → Integrations.
2. Select Webhook preset.
3. Choose the TRIFFT HTTP Authentication schema.
4. Configure the endpoint path, HTTP method, headers, and payload required by the selected TRIFFT REST API operation.
5. Save the webhook preset.
6. Open or create a Bloomreach Scenario.
7. Add Actions → Other → Custom webhook.
8. Select the webhook preset.
9. Preview the rendered request with a test customer.
10. Run the Scenario for a restricted test audience.

Typical TRIFFT actions include:

• Assign a coupon.
• Credit or debit a wallet.
• Add a member to a segment.
• Remove a member from a segment.
• Send a personalized notification.

Example flow: add a member to a segment

1. Create a Bloomreach Scenario.
2. Add the required trigger and conditions.
3. Add the preconfigured TRIFFT segment webhook.
4. Pass the customer's TRIFFT member ID and the target segment ID.
5. Test the request.
6. Confirm the member is visible in the TRIFFT segment.

Example: In this scenario, on event "Booking", a user is added to a TRIFFT segment "Booked"

5. Enable Client Zone / Web Portal tracking

Enable this when Bloomreach Weblayers should appear in the TRIFFT Web Portal or Client Zone.

1. In TRIFFT, navigate to Settings → Integrations → Bloomreach.
2. Open the Settings tab.
3. Scroll to Tracking.
4. Enable Client Zone tracking.
5. Save the configuration.
6. Create and activate the required Bloomreach Weblayer.
7. Test with a customer who belongs to the Weblayer audience.

6. Configure Bloomreach mobile push for white-label apps

Prerequisites

Confirm that:

• The white-label mobile app is provisioned and distributed by TRIFFT.
• The app contains the Bloomreach Mobile SDK.
• The Bloomreach integration is enabled in TRIFFT.
• The base endpoint, project token, and authorization details are configured.
• The test member has a valid mobile push token.

iOS: Apple Push Notification Service

Create the APNs integration

1. In Bloomreach, navigate to Data & Assets → Integrations → Add new integration.
2. Select Apple Push Notification Service.
3. Open the integration editor.
4. Enter:

The private key must include the complete block:

-----BEGIN PRIVATE KEY-----
[KEY CONTENT HERE]
-----END PRIVATE KEY-----

Obtain Apple credentials

1. Open the Apple Developer account's Keys section.
2. Create a new key with APNs access.
3. Download the .p8 file and store it securely.
4. Copy the Key ID.
5. Copy the Team ID from the Apple Developer account.
6. Copy the app's Bundle ID from Certificates, Identifiers & Profiles.

Assign APNs to the iOS channel

1. Go to Settings → Project settings → Channels → Push notifications.
2. Under iOS notifications, select the Apple Push Notification Service integration.
3. Save changes.

Android: Firebase Cloud Messaging

Create the Firebase integration

1. In Bloomreach, navigate to Data & Assets → Integrations → Add new integration.
2. Search for Firebase.
3. Select Firebase Cloud Messaging.
4. Accept the terms and continue.
5. Open the Firebase Cloud Messaging integration editor.
6. Paste the required Firebase service-account credentials/private key.

The private key must preserve its full format:

-----BEGIN PRIVATE KEY-----
[KEY CONTENT HERE]
-----END PRIVATE KEY-----

Assign Firebase to the Android channel

1. Go to Settings → Project settings → Channels → Push notifications.
2. Under Android notifications, select the Firebase Cloud Messaging integration.
3. Save changes.

Test mobile push

1. Create a small test segment or manual test trigger in Bloomreach.
2. Add a Mobile Push node to a test Scenario.
3. Select a test customer with a valid iOS or Android push token.
4. Run the Scenario.
5. Confirm delivery on the test device.
6. Review Bloomreach execution logs if the push is not delivered.

7. Validate the complete integration

Test TRIFFT → Bloomreach

1. Select a test member that exists in both platforms.
2. Trigger a configured TRIFFT event, for example member verification, app open, transaction, or coupon activity.
3. Open the corresponding customer profile in Bloomreach.
4. Confirm the event appears in the customer timeline.
5. Inspect the event properties and timestamp.

Test Bloomreach → TRIFFT

1. Create a test Scenario with a restricted audience.
2. Add a TRIFFT webhook preset, for example adding a test member to a segment.
3. Preview the request and confirm all variables render correctly.
4. Execute the Scenario.
5. Confirm the result in the TRIFFT member detail and event history.

Test personalization channels

• Confirm the Client Zone Weblayer appears only for an eligible test member.
• Confirm a Bloomreach in-app campaign renders in the correct TRIFFT Placeholder ID.
• Confirm iOS and Android push delivery independently.

Configuration checklist