Punchh

Punchh es una plataforma de fidelización y participación líder del sector que permite a las marcas ofrecer programas omnicanal de fidelización de clientes tanto en la tienda como digitalmente.

Esta integración está mantenida por Punchh.

Sobre la integración

La integración de Braze y Punchh te permite sincronizar datos con fines de obsequios y fidelización en ambas plataformas. Los datos publicados en Braze estarán disponibles para segmentación y pueden sincronizar los datos de usuario de vuelta a Punchh a través de webhooks de Braze.

¿Cuáles son los beneficios?

• Ingesta de datos de fidelización de Punchh a Braze en tiempo real.
• Aprovecha y combina potentes datos de audiencia de Braze para ofrecer experiencias multicanal significativas y dinámicas (aplicación, móvil, web, correo electrónico y SMS).
  • ¿Los clientes abrieron correos electrónicos? ¿Los clientes abrieron la aplicación cerca de una tienda?
• Estandariza la apariencia de los correos transaccionales enviados a través de Braze.
• Crea recorridos que permitan pruebas A/B y optimización sobre la marcha.

Requisitos previos

¿Qué más debo saber?

Antes de integrar

• Al utilizar la integración con Braze, se necesitarán dos campañas, una en Punchh y otra en Braze. Por ejemplo, si envías una campaña con una oferta adjunta, la campaña de regalo se configurará dentro de Punchh, y la notificación se puede enviar desde Braze.
• Los invitados ya deben existir en Punchh y Braze. Punchh filtrará a cualquier cliente que no sea ya un invitado de fidelización.

Aspectos importantes a tener en cuenta

• Punchh ha añadido la posibilidad de deshabilitar el envío de atributos de usuario predeterminados a Braze, para que el cliente no incurra en excedentes de puntos de datos. Esto se configura durante la configuración del adaptador.
• Si se utilizan Segments personalizados en campañas recurrentes, se debe usar el nombre de la campaña en lugar del ID de la campaña, ya que los ID cambian cada vez que se ejecuta la campaña.
• Los canales de comunicación disponibles dentro de cada campaña de regalo de Punchh incluyen mensajes enriquecidos, notificaciones push, SMS y correo electrónico.
• Después de que los usuarios han sido enviados a un Segment personalizado de Punchh desde Braze, no se pueden eliminar. Solo se pueden añadir nuevos invitados a un Segment personalizado existente. Si es necesario eliminar invitados de un Segment personalizado de Punchh existente, será necesario crear una nueva campaña de webhook en Braze para enviar usuarios a un nuevo Segment personalizado de Punchh.

Integración

Punchh ofrece varios endpoints disponibles para los clientes de Braze para ayudar a agregar ID externos a la plataforma Punchh utilizando los siguientes endpoints de la API de Punchh. Después de agregar los ID externos, crea un adaptador en Punchh, proporciona tus credenciales de Braze y selecciona qué eventos te gustaría sincronizar. A continuación, puedes tomar el ID de Segment de Punchh y usarlo para crear un webhook de Punchh que desencadene la sincronización de clientes en un recorrido de Canvas.

Ten en cuenta que el user_id de Punchh y el external_id de Braze deben estar disponibles en cualquiera de las dos plataformas para que la integración se sincronice correctamente.

• Los eventos enviados desde Punchh a Braze incluirán el external_id de Braze como identificador. Si Punchh está configurado para usar el external_source_id, ese valor se establecerá como el external_id de Braze. De lo contrario, la integración usará por defecto el user_id de Punchh como el external_id de Braze.
• Para enviar webhooks desde Braze a Punchh, el user_id de Punchh debe estar disponible en el perfil de usuario de Braze. Si el user_id de Punchh no se utiliza como el external_id de Braze, debe establecerse como un atributo personalizado “punchh_user_id”.

Paso 1: Configurar endpoints de ingesta de ID externo (opcional)

Los ID externos de Braze se pueden agregar utilizando los siguientes endpoints para usuarios de Punchh nuevos y existentes.

Importante

Los valores de los campos external_source y external_source_id deben ser únicos en Punchh y no estar asociados con perfiles existentes.

1. Nuevos usuarios de Punchh
   Crea nuevos usuarios en Punchh con un endpoint de registro de Punchh utilizando los campos external_source y external_source_id. Punchh permite enviar identificadores externos con un perfil de usuario a través de uno de los siguientes endpoints de registro:
   • API de registro móvil
   • API de registro inicio de sesión único
     
     
2. Usuarios existentes de Punchh
   Actualiza el external_source_id para usuarios existentes de Punchh. Punchh permite agregar identificadores externos a un perfil a través de un endpoint de actualización de la API de usuario:
   • Actualización de usuario móvil
   • Actualización de usuario inicio de sesión único
   • Actualización de usuario del panel
     
     

• user sign-up api example
• user update api example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl --location --request POST 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Accept-Timezone: Etc/UTC' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-raw '{
    "client":"CLIENT",
    "user" : {
      "email": "[email protected]",
      "password": "PASSWORD",
      "first_name":"FIRST_NAME",
      "last_name":"LAST_NAME",
      "terms_and_conditions":"true",
      "anniversary":"2014-02-02",
      "zip_code":"94497",
      "birthday":"2004-02-02",
      "external_source":"customer_id",
      "external_source_id":"111111111111111111"
      }
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request PUT 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data-raw '{
    "client":"CLIENT",
    "user": {
        "external_source":"customer_id",
        "external_source_id":"111111111111111111"
    }
}'

Nota

Configuración de la plataforma: Para habilitar identificadores externos en Punchh, desde el panel de Punchh, navega a Cockpit > Dashboard > External User Identifier.

Paso 2: Configuración del adaptador de Braze en Punchh

Eventos disponibles para sincronizar

1. Invitado: Se desencadena ante cualquier registro, actualización del perfil de invitado, desactivación o eliminación
2. Check-in de fidelización: Se desencadena para transacciones de fidelización o acumulación al escanear el código de barras del recibo
3. Check-in de regalo: Se desencadena para puntos regalados desde una campaña
4. Canje: Se desencadena en caso de cualquier canje de recompensas excluyendo cupones de Punchh, ya que estos se enviarían por separado como eventos de cupón, incluyendo tanto la emisión como el canje
5. Recompensas: Se desencadena desde recompensas otorgadas por campañas, actividad, conversión de puntos a recompensas u otorgamiento por administrador
6. Notificaciones de transacción: Se desencadena ante la actividad transaccional de un usuario dentro del sistema Punchh (por ejemplo, expiración de puntos)
7. Notificaciones de marketing: Se desencadena en función de diferentes configuraciones de campañas en Punchh para un Segment asociado de usuarios

Nota

Consulta la documentación de Punchh para ver cómo son las cargas útiles de ejemplo para estos eventos disponibles.

Trabaja con tu administrador de implementación de Punchh para configurar este adaptador.

Para configurar la integración de Braze y Punchh, haz lo siguiente:

1. En el panel de Punchh, navega a Cockpit > Dashboard > Major Features > Enable Webhook Management y activa Enable Webhook Management.
   
   
2. A continuación, habilita los adaptadores navegando a Settings > Webhooks Administrador > Configurations > Show Adapters Tab y activa Show Adapters Tab.
   
   
3. Navega a Webhooks Manager en la pestaña Settings, selecciona la pestaña Adapters y haz clic en Create Adapter.
   
   
   
   
4. Completa el nombre del adaptador, la descripción y el correo electrónico del administrador. Selecciona Braze como tu adaptador y proporciona tu endpoint de la REST API de Braze y tu clave de API de Braze.
   
   
5. A continuación, selecciona los eventos disponibles que deseas habilitar. Puedes encontrar una lista de estos eventos en Eventos disponibles para sincronizar.
   
   
   
   
6. Haz clic en Submit para habilitar el webhook.

Crear un webhook de Punchh en Braze

Braze puede agregar usuarios a un Segment de Punchh a través de webhooks utilizando los Custom Segments de Punchh.

1. Crea un Segment personalizado en Punchh y anota el custom_segment_id presente en la URL del panel de Segments de Punchh, como se muestra en el siguiente ejemplo. Puedes utilizar tanto el constructor de Segments clásico como el beta. Sin embargo, se recomienda el beta, ya que el clásico acabará dejando de estar disponible.
   
   En la plataforma Punchh, navega a Guest > Segment > Custom List > New Custom List.
   
   
   
   

2. Crea una Campaign de webhook en Braze utilizando el endpoint de Punchh para agregar un usuario a un Segment personalizado como la URL del webhook. Aquí puedes proporcionar el custom_segment_id extraído de la URL y el user_id como pares clave-valor.
   
   
   
   

3. Este webhook puede configurarse como una Campaign individual o como un paso dentro de un Canvas. Alternativamente, si el webhook que agrega usuarios a este Segment de Punchh específico se utilizará en múltiples Campaigns o Canvas, puede configurarse como una plantilla.
   
   La clave user_id dentro del webhook se mapea al ID de usuario de Punchh. Este identificador deberá añadirse a todos los webhooks creados en Braze para agregar usuarios a un Segment personalizado de Punchh. El atributo personalizado punch_user_id puede rellenarse dinámicamente como el valor de la clave user_id usando Liquid. Puedes insertar la variable del atributo personalizado punchh_user_id usando el icono azul de “más” en la barra de herramientas del campo de texto con plantilla.
   
   
   
   
   
   

4. Una vez guardado el webhook, puede utilizarse para sincronizar usuarios. Por ejemplo, 136 invitados se agregarían al Segment personalizado de Punchh cuando se lance esta Campaign de webhook de Braze.
   
   

Para obtener más información sobre cómo se utilizan los webhooks en Braze, consulta Crear un webhook.

Campaigns de ejemplo

Configuración de Campaign y Canvas

Desencadenamiento

Los ejemplos de mensajería de Braze desencadenados por eventos de Punchh enviados a Braze, como eventos de recompensa o eventos de invitados, pueden crearse como Campaigns basadas en acciones o Canvas desencadenados por el evento Punchh relevante.

Al añadir un desencadenador, se mostrará la lista de eventos creados en Braze. Elige el evento que debe desencadenar tu Campaign o Canvas para que se envíe al usuario que registró el evento.

Se pueden añadir filtros de propiedad para filtrar aún más el evento desencadenante. Por ejemplo, el mensaje solo debería desencadenarse cuando un cliente activa el evento “checkins_gift” donde la propiedad del evento aprobado es true. Esta es una característica opcional que puede no ser aplicable a todos los ejemplos.

Segmentación

En muchos casos, las Campaigns y Canvas de Braze desencadenados por eventos de Punchh pueden configurarse con una audiencia de “Todos los usuarios”, ya que la segmentación de los usuarios que desencadenan estos eventos se determina dentro de Punchh. Sin embargo, los clientes que busquen refinar aún más la audiencia de usuarios que recibirán la mensajería de Braze desencadenada por el evento pueden hacerlo añadiendo filtros y Segments adicionales en la sección Target Audiences del creador de Campaign o el público de entrada del creador de Canvas.

Ejemplos

• registro
• bienvenida de braze
• oferta masiva
• oferta masiva recurrente
• oferta post check-in con notificación
• oferta post check-in sin notificación
• aniversario
• recuperación