Punchh

Punchh es una plataforma de fidelización e interacció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 permite sincronizar los datos para regalos y fidelización entre las dos plataformas. Los datos publicados en Braze estarán disponibles para la segmentación y pueden sincronizar los datos de usuario de nuevo en 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 estratifica los potentes datos de audiencia de Braze para entregar experiencias significativas y dinámicas en todos los canales (aplicación, móvil, web, correo electrónico y SMS).
  • ¿Han abierto los clientes los correos electrónicos? ¿Los clientes abrieron la aplicación cerca de una tienda?
• Estandariza el aspecto de los correos electrónicos transaccionales enviados a través de Braze.
• Crea recorridos que permitan realizar pruebas A/B y optimizaciones sobre la marcha.

Requisitos previos

¿Qué más debo saber?

Antes de integrar

• Al utilizar la integración de Braze, serán necesarias dos campañas, una en Punchh y la segunda 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 podrá enviarse desde Braze.
• Los invitados ya deben existir en Punchh y Braze. Punchh filtrará a cualquier cliente que no esté ya fidelizado.

Aspectos importantes

• Punchh ha añadido la posibilidad de desactivar 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 segmentos personalizados en campañas recurrentes, debe utilizarse el nombre de la campaña en lugar del ID de campaña, ya que los ID cambian cada vez que se ejecuta la campaña.
• Los canales de comunicación disponibles en cada campaña de regalo de Punchh incluyen mensajes enriquecidos, notificaciones push, SMS y correo electrónico.
• Una vez que los usuarios han sido enviados a un segmento personalizado de Punchh desde Braze, no pueden ser eliminados. Solo se pueden añadir nuevos invitados a un segmento personalizado existente. Si es necesario eliminar invitados de un segmento personalizado de Punchh existente, será necesario crear una nueva campaña de webhook en Braze para enviar usuarios a un nuevo segmento personalizado de Punchh.

Integración

Punchh ofrece varios puntos de conexión a disposición de los clientes de Braze para ayudar a añadir ID externos a la plataforma Punchh utilizando los siguientes puntos de conexión de la API de Punchh. Una vez añadidos los ID externos, crea un adaptador en Punchh, proporciona tus credenciales de Braze y selecciona los eventos que deseas sincronizar. A continuación, puedes tomar el ID de segmento de Punchh y utilizarlo para crear un webhook de Punchh para desencadenar 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 utilizar el external_source_id, ese valor se establecerá como el external_id de Braze. De lo contrario, la integración predeterminará la configuración del user_id de Punchh como el external_id de Braze.
• Para enviar webhooks de Braze a Punchh, el user_id de Punchh debe estar disponible en el perfil de usuario de Braze. Si no se utiliza el user_id de Punchh como el external_id de Braze, debe establecerse como atributo personalizado “punchh_user_id”.

Paso 1: Configurar puntos de conexión de ingestión de ID externos (opcional)

Los ID externos de Braze pueden añadirse utilizando los siguientes puntos de conexión para usuarios nuevos y existentes de Punchh.

Importante

Los valores de los campos external_source y external_source_id deben ser exclusivos de Punchh y no estar asociados a perfiles existentes.

1. Nuevos usuarios de Punchh
   Crea nuevos usuarios en Punchh con un punto de conexión 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 puntos de conexión de registro:
   • API de registro móvil
   • API de registro SSO
     
     
2. Usuarios actuales de Punchh
   Actualiza external_source_id para los usuarios existentes de Punchh. Punchh permite añadir identificadores externos a un perfil a través de un punto de conexión de actualización de la API de usuario:
   • Actualización de usuario móvil
   • Actualización de usuario SSO
   • Actualización de usuario del panel de control
     
     

• 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 activar los identificadores externos en Punchh, desde el panel de control de Punchh, ve a Cockpit > Dashboard > External User Identifier.

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

Eventos disponibles para sincronizar

1. Invitado: Se activa al registrarse, actualizar el perfil de invitado, desactivarlo o eliminarlo.
2. Registro de fidelización: Se activa en las transacciones de fidelización o al escanear el código de barras del recibo.
3. Registro de regalos: Se desencadena por puntos regalados de una campaña.
4. Canje: Se activa en caso de canje de cualquier recompensa, excluidos los cupones Punchh, ya que estos se enviarían por separado como eventos de cupón, incluida la emisión y el canje.
5. Recompensas: Se activa a partir de recompensas otorgadas por campañas, actividad, conversión de puntos en recompensas o por la administración.
6. Notificaciones de transacciones: Se activa cuando un usuario realiza una transacción en el sistema Punchh (por ejemplo, caducidad de puntos).
7. Notificaciones de marketing: Se activa en función de diferentes configuraciones de campaña en Punchh para un segmento asociado de usuarios.

Nota

Consulta la documentación de Punchh sobre el aspecto que pueden tener las cargas útiles de muestra para estos eventos disponibles.

Trabaja con tu gestor 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 control de Punchh, ve a Cockpit > Dashboard > Major Features > Enable Webhook Management y activa Enable Webhook Management.
   
   
2. A continuación, habilita los adaptadores accediendo a Settings > Webhooks Manager > Configurations > Show Adapters Tab y activa Show Adapters Tab.
   
   
3. Ve a Webhooks Manager en la pestaña Settings, selecciona la pestaña Adapters y haz clic en Create Adapter.
   
   
   
   
4. Introduce el nombre del adaptador, la descripción y el correo electrónico del administrador. Selecciona Braze como adaptador e indica el punto de conexión de la REST API de Braze y la clave de API de Braze.
   
   
5. A continuación, selecciona los eventos disponibles que deseas activar. Encontrarás una lista de estos eventos en Eventos disponibles para sincronizar.
   
   
   
   
6. Haz clic en Submit para activar el webhook.

Crear webhook de Punchh en Braze

Braze puede añadir usuarios a un segmento de Punchh a través de webhooks utilizando segmentos personalizados de Punchh.

1. Crea un segmento personalizado en Punchh y observa el custom_segment_id presente en la URL del panel de control del segmento de Punchh, como se muestra a continuación. Pueden utilizarse constructores de segmentos clásicos o beta. Sin embargo, se recomienda la versión beta, ya que la versión clásica quedará obsoleta con el tiempo.
   
   En la plataforma Punchh, ve a Guest > Segment > Custom List > New Custom List.
   
   
   
   

2. Crea una campaña de webhook en Braze utilizando el punto de conexión de Punchh para añadir un usuario a un segmento personalizado como URL de 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 campaña singular o como un paso dentro de un Canvas. Alternativamente, si el webhook que añade usuarios a este segmento específico de Punchh se va a utilizar en múltiples Campaigns o Canvas, se puede configurar como una plantilla.
   
   La clave user_id del webhook corresponde al ID de usuario de Punchh. Este identificador deberá añadirse a todos los webhooks creados en Braze para añadir usuarios a un segmento personalizado de Punchh. El atributo personalizado punch_user_id puede rellenarse dinámicamente como valor de la clave user_id utilizando Liquid. Puedes insertar la variable de atributo personalizado punchh_user_id utilizando el icono azul “más” situado en la parte superior derecha de cualquier campo de texto de plantilla.
   
   
   
   
   
   

4. Una vez guardado el webhook, puede utilizarse para sincronizar usuarios, como se muestra a continuación. Por ejemplo, se añadirían 136 invitados al segmento personalizado de Punchh cuando se lance esta campaña de webhook de Braze.
   
   

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

Campañas de casos de uso

Configuración de Campaign y Canvas

Desencadenar

Los casos de uso para la mensajería de Braze desencadenados por eventos de Punchh que se envían a Braze, como eventos de recompensa o eventos de invitados, pueden crearse como campañas basadas en acciones o Canvas desencadenados por el evento de Punchh correspondiente.

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

Se pueden añadir filtros de propiedades para filtrar aún más el evento desencadenante. Por ejemplo, el mensaje solo debe desencadenarse cuando un cliente active el evento “checkins_gift” en el que la propiedad del evento aprobado sea true. Se trata de una función opcional que puede no ser aplicable a todos los casos de uso.

Segmentación

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

Casos de uso

• signup
• braze welcome
• mass offer
• recurring mass offer
• post check-in offer with notification
• post check-in offer without notification
• anniversary
• recall