Skip to main content

Bloomreach integration

Sync your Rivo loyalty data with Bloomreach

T
Written by Travis Brault

Connect Rivo and Bloomreach to sync loyalty profile data and trigger loyalty-based events for campaigns and automations.
​

Integration setup

To connect Rivo with Bloomreach, add these three credentials from Bloomreach:

  • Project Token

  • API Key

  • API Secret

When the integration is connected and enabled, Rivo can sync profile data and send supported events to Bloomreach.

💡 Tip: API credential locations can vary by Bloomreach account and UI version. If you can’t find them, check Bloomreach’s current API credential documentation in your project settings.


​

Synced profile attributes

Rivo syncs standard customer fields and Rivo-specific fields.
​

Standard fields

  • first_name

  • last_name

  • phone


​

Rivo-specific fields

Attribute name

Description

Example

rivo_balance

Current loyalty balance. Value can be either points or a 2-decimal currency amount (for store credit setups).

1000 or 25.00

rivo_loyalty_status

Customer loyalty status.

member

rivo_referral_url

Customer referral link.

https://shop.com/?rivo_ref=abc

rivo_date_of_birth

Birthday date value with year fixed to 1940.

1940-09-28

rivo_vip_tier_name

Current VIP tier name (when VIP tiers are active for the shop).

Gold

Syncing existing customers

You can run a customer sync from the Bloomreach integration page in Rivo.

  • Use Sync Customers to queue a profile sync for existing customers.

  • The button is temporarily disabled for about 1 hour after a sync is initiated.


​

Event triggers sent to Bloomreach

Event names are sent with a rivo_ prefix.
​

Points

  • rivo_points_earned

  • rivo_notification_points_expiry_warning (first reminder)

  • rivo_notification_points_expiry_last_chance (final reminder)


​

Rewards

  • rivo_reward_redeemed

  • rivo_notification_reward_expiry_warning (first reminder)

  • rivo_notification_reward_expiry_last_chance (final reminder)


​

VIP tiers

  • rivo_customer_moves_up_a_tier

  • rivo_customer_moves_down_a_tier


​

Referrals

  • rivo_referral_completed

  • rivo_advocate_signup

  • rivo_referral_friend_claim

  • rivo_referral_invite_friend


​

Customer lifecycle

  • rivo_customer_birthday

  • rivo_customer_account_activated

  • rivo_birthday_captured


​

Event controls

Merchants can enable or disable individual event triggers in the Rivo Bloomreach integration settings.
​

Availability

Bloomreach integration access depends on whether your current Rivo plan includes integrations.

Did this answer your question?