Open Loyalty

Open Loyalty es una plataforma de programas de fidelización basada en la nube que te permite crear y gestionar programas de recompensa y fidelización de clientes. La integración de Braze y Open Loyalty sincroniza los datos de fidelización —como el saldo de puntos, los cambios de nivel y las advertencias de caducidad— directamente en Braze en tiempo real. Esto te permite desencadenar mensajes personalizados (correo electrónico, push, SMS) cuando cambia el estado de fidelización de un usuario.

Esta integración la mantiene Open Loyalty

Sobre la integración

Esta integración utiliza Transformación de datos de Braze para capturar webhooks de Open Loyalty y mapearlos a perfiles de usuario de Braze.

• Actualizaciones en tiempo real: Envía eventos de fidelización (puntos ganados, subidas de nivel) a Braze.
• Personalización: Utiliza atributos de fidelización (saldo actual, nombre del siguiente nivel) en tus plantillas de Braze.
• Bidireccional: Actualiza los atributos personalizados de los clientes de Open Loyalty basándote en los datos de interacción de Braze.

Casos de uso

Esta integración abarca los siguientes flujos de datos:

1. Sincronizar eventos con Braze (de entrada): Realiza un seguimiento de los cambios de puntos, las subidas de nivel o los canjes de recompensas enviando datos de Open Loyalty a Braze. La Transformación de datos convierte estos datos en un evento de usuario.
2. Modificar miembros de Open Loyalty (de salida): Actualiza automáticamente los datos de los miembros en Open Loyalty en función del comportamiento del usuario en Braze, como añadir etiquetas “VIP” o actualizar atributos personalizados.

Requisitos previos

Antes de empezar, necesitas lo siguiente:

Integración

La integración principal sincroniza los eventos webhook de Open Loyalty con Braze mediante Transformación de datos.

Paso 1: Generar la URL del webhook en Braze

Primero, crea una transformación de datos en Braze para generar una URL única para recibir datos.

1. En Braze, abre Data Settings > Data Transformation.
2. Haz clic en Create Transformation.
3. Completa los siguientes campos:
   • Transformation name: Proporciona un nombre descriptivo (por ejemplo, “Open Loyalty Point Update Events”).
   • Select destination: Elige POST: Track users.
4. Haz clic en Create Transformation.
5. Localiza la Webhook URL en la parte derecha y haz clic en Copy.

Importante

Guarda bien esta URL; la necesitas para el siguiente paso.

Paso 2: Crear la suscripción al webhook en Open Loyalty

Indica a Open Loyalty que envíe eventos específicos a la URL que acabas de generar.

1. Inicia sesión en tu panel de administración de Open Loyalty.
2. Ve a General > Webhooks.
3. Haz clic en Add new webhook y configura la suscripción:
   • eventName: Selecciona el evento del que quieres hacer un seguimiento (por ejemplo, AvailablePointsAmountChanged, CustomerLevelChanged o CampaignEffectWasApplied).
   • url: Pega la URL del webhook de Braze del paso 1.
   • Añade los siguientes encabezados:
     • Content-Type: application/json
     • User-Agent: partner-OpenLoyalty
4. Guarda la suscripción al webhook.

Paso 3: Configurar la Transformación de datos

Escribe la lógica JavaScript en Braze para mapear la carga útil entrante de Open Loyalty a propiedades de Braze.

1. En Braze, abre la transformación de datos que creaste en el paso 1.
2. Desencadena el evento en Open Loyalty (por ejemplo, cambia los puntos de un miembro o asigna un nivel) para generar una carga útil de muestra en el panel de Webhook details.
3. En el editor de Transformation code, escribe un script para mapear los datos entrantes. Utiliza el siguiente ejemplo como guía:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// 1. Parse the incoming Open Loyalty payload
const data = payload.data;

// 2. Construct the Braze API body
let brazecall = {
  "events": [
    {
      // CRITICAL: Map the identifier (e.g., loyaltyCardNumber -> external_id)
      "external_id": data.customer.loyaltyCardNumber,

      // Define the Event Name (what you see in Braze)
      "name": "Loyalty Event Triggered",

      // timestamp
      "time": new Date().toISOString(),

      // Map specific properties you want to use in emails/segments
      "properties": {
        "event_type": payload.type, // for example, 'AvailablePointsAmountChanged'
        "new_balance": data.amount,
        "change_amount": data.amountChange,
        "tier_name": data.tier ? data.tier.name : null
      }
    }
  ]
};

return brazecall;

4. Haz clic en Validate para asegurarte de que el código se ejecuta con tu carga útil de muestra y, a continuación, haz clic en Activate.

Usar Open Loyalty con Braze

Una vez completada la integración de entrada, configura las actualizaciones de salida para modificar los miembros de Open Loyalty en función del comportamiento en Braze.

Paso 1: Configurar una Campaign de webhook en Braze

Este proceso utiliza webhooks de Braze para enviar una solicitud PATCH a la API de miembros de Open Loyalty (por ejemplo, para añadir una etiqueta “VIP”).

1. En Braze, crea una nueva Campaign de webhook (o utiliza un webhook dentro de un Canvas).
2. Haz clic en Compose Webhook.
3. Webhook URL: Construye la URL utilizando tu instancia de Open Loyalty, el ID de tenant y la variable Liquid de Braze para el ID de usuario.

   • Formato:

     https://<YOUR_OL_INSTANCE>/api/<TENANT_ID>/member/loyaltyCardNumber={{${user_id}}}

4. Completa los siguientes campos:
   • Request Method: PATCH
   • Request Headers:
     • Content-Type: application/json
     • X-AUTH-TOKEN: <YOUR_PERMANENT_TOKEN>
     • User-Agent: Braze
5. Request Body: Selecciona Raw text y pega la carga útil:

1
2
3
4
5
6
7
8
9
10
{
  "customer": {
    "labels": [
      {
        "key": "braze_vip_segment",
        "value": "optedIn"
      }
    ]
  }
}

Paso 2: Configurar el desencadenador

1. Ve a la pestaña Delivery o Entry Schedule.
2. Completa los siguientes campos:
   • Delivery Method: Action-Based.
   • Trigger: Define el desencadenador correspondiente (por ejemplo, un usuario entra en un Segment específico en Braze).
   • Launch: Activa la Campaign.

Solución de problemas

Verificar eventos de entrada

Cuando la Transformación de datos está activa, los datos aparecen en Braze como un evento personalizado. Compruébalo creando una Campaign con un desencadenador Perform Custom Event y verificando si el evento que definiste (por ejemplo, Loyalty Event Triggered) está disponible.

Verificar webhooks de salida

Comprueba el Registro de actividad de mensajes en Braze para asegurarte de que el webhook devolvió un estado 200 OK.

• Error 401: Comprueba tu token de la API de Open Loyalty.
• Error 404: El ID de usuario en Braze no existe en Open Loyalty.