Punchh

Punchh es una plataforma de fidelización y compromiso 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 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?
• Estandarice el aspecto de los correos electrónicos transaccionales enviados a través de Braze.
• Cree 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 Braze, serán necesarias dos campañas, una en Punchh y la segunda en Braze. Por ejemplo, si envía 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 excesos 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. Sólo 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 webhook en Braze para enviar usuarios a un nuevo segmento personalizado de Punchh.

Integración

Punchh ofrece varios puntos finales a disposición de los clientes de Braze para ayudar a añadir ID externos a la plataforma Punchh utilizando los siguientes puntos finales de la API de Punchh. Una vez añadidos los ID externos, cree un adaptador en Punchh, proporcione sus credenciales de Braze y seleccione los eventos que desea sincronizar. A continuación, puede tomar el ID de segmento de Punchh y utilizarlo para crear un webhook de Punchh para activar la sincronización de clientes en un recorrido de Canvas.

Ten en cuenta que Punchh user_id y Braze external_id 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 Braze external_id. De lo contrario, la integración predeterminará la configuración de Punchh user_id como Braze external_id.
• Para enviar webhooks de Braze a Punchh, la dirección user_id de Punchh debe estar disponible en el perfil de usuario de Braze. Si no se utiliza Punchh user_id como atributo de Braze external_id, debe establecerse como atributo personalizado. “punchh_user_id”. 

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

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

1. Nuevos usuarios de Punchh
   Cree nuevos usuarios en Punchh con un punto final 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 finales de registro:
   • API de registro móvil
   • API de registro SSO
     
     
2. Usuarios actuales de Punchh
   Actualice external_source_id para los usuarios existentes de Punchh. Punchh permite añadir identificadores externos a un perfil a través de un punto final de actualización de la API de usuario:
   • Actualización para usuarios móviles
   • Actualización de usuarios SSO
   • Actualización de usuarios 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"
    }
}'

Paso 2: Configuración del adaptador de soldadura 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 éstos 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.

Trabaje con su gestor de implantación de Punchh para configurar este adaptador.

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

1. En el panel de control de Punchh, vaya a Cockpit > Panel de control > Funciones principales > Activar Webhook Management y active Activar Webhook Management.
   
   
2. A continuación, habilite los adaptadores accediendo a Configuración > Administrador de Webhooks > Configuraciones > Mostrar pestaña Adaptadores y active la pestaña Mostrar adaptadores.
   
   
3. Vaya a Webhooks Manager en la pestaña Configuración, seleccione la pestaña Adaptadores y haga clic en Crear adaptador.
   
   
   
   
4. Introduzca el nombre del adaptador, la descripción y el correo electrónico del administrador. Seleccione Braze como adaptador e indique el punto final de la API REST de Braze y la clave de la API de Braze.
   
   
5. A continuación, seleccione los eventos disponibles que desea activar. Encontrará una lista de estos eventos en Eventos disponibles para sincronizar.
   
   
   
   
6. Haga clic en Enviar para activar el webhook.

Crear Punchh webhook en Braze

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

1. Cree un segmento personalizado en Punchh y observe la dirección 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, vaya a Invitado > Segmento > Lista personalizada > Nueva lista personalizada.
   
   
   
   

2. Cree una campaña de webhook en Braze utilizando el punto final de Punchh para añadir un usuario a un segmento personalizado como URL de webhook. Aquí, puede proporcionar los custom_segment_id extraídos de la URL y 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 campañas o Canvases, 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. Puede 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 Punch cuando se lance esta campaña webhook 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 campañas y Canvas

Desencadenar

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

Al añadir un activador, aparecerá la lista de eventos creados en Braze. Elija el evento que debe desencadenar su campaña 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 sólo 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 campañas Braze y los Lienzos 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 Braze activada por el evento pueden hacerlo añadiendo filtros y segmentos adicionales en la sección Target Audiences del compositor de campañas o en Entry Audience del compositor de Canvas.

Ejemplos

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