Generación dinámica de código con Punchh

Un código de cupón es un código único que puede ser utilizado por un solo usuario (ya sea de uso único o múltiple). El marco Punchh genera códigos de cupón, que pueden procesarse dentro de una aplicación móvil o en el sistema de punto de venta (TPV).

Esta integración está mantenida por Punchh.

Sobre la integración

Utilizando el marco de cupones Punchh y Braze, puede lograr los siguientes escenarios:

• Genere un código de cupón cuando el invitado haga clic en un enlace de generación de cupón en un correo electrónico: El código del cupón se generará dinámicamente y se mostrará en una página web.
• Genere un código de cupón cuando el invitado abra un correo electrónico: El código del cupón se generará dinámicamente y se mostrará como una imagen dentro del correo electrónico.

Integración de la generación dinámica de códigos de cupón

Paso 1: Crear una campaña de cupones

1. Utilizando una campaña de cupones Punchh, cree una campaña de cupones de generación dinámica como se muestra en la siguiente imagen.
2. El marco de cupones Punchh generará los siguientes parámetros para permitir la generación dinámica de cupones:
   • Token dinámico de generación de cupones: Se trata de un token de seguridad generado por el sistema para la encriptación.
   • URL de generación de cupones dinámicos: Esta URL se incrustará en el correo electrónico como enlace o imagen, según requiera la empresa.

Paso 2: Generar firma y construir URL

La biblioteca JWT.IO descodifica, verifica y genera tokens Web JSON, un método abierto RFC 7519 estándar del sector para representar reclamaciones de forma segura entre dos partes.

Los siguientes nombres ClaimType pueden utilizarse para garantizar la unicidad de los invitados y los cupones:

• campaign_id: representa el ID de campaña Punchh generado por el sistema.
• email: representa la dirección de correo electrónico del usuario.
• first_name: captura el nombre de pila del usuario.
• last_name: captura el apellido del usuario.

Para utilizar la API de código de cupón dinámico de Punchh, debe crearse un token JWT. Añada la siguiente plantilla Liquid a su cuadro de mandos Braze en el cuerpo del mensaje del canal que desea utilizar:

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
{% assign header = '{"alg":"HS256","typ":"JWT"}' | base64_encode | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% capture payload_raw %}

{
  "campaign_id": "CAMPAIGN_ID",
  "email": "{{${email_address}}}",
  "first_name": "{{${first_name}}}",
  "last_name": "{{${last_name}}}"
}

{% endcapture %}

{% assign payload = payload_raw | replace: ' ', '' | replace: '\n', '' | base64_encode | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% assign unsigned_token = header | append: "." | append: payload %}

{% assign secret = "DYNAMIC_COUPON_GENERATION_TOKEN" %}

{% assign signature_raw = unsigned_token | hmac_sha256_base64: secret %}

{% assign signature = signature_raw | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% assign jwt = unsigned_token | append: "." | append: signature %}

Sustituye lo siguiente:

Paso 3: Añada el código del cupón al cuerpo del mensaje

Enlace a la página web de Punchh

Para enlazar con una página web alojada en Puncch, añada {{jwt}} a la URL de generación dinámica que creó anteriormente. Su enlace debe ser similar al siguiente:

1
https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX?sign={{jwt}}

Cuando un usuario haga clic en la URL del cupón, será redirigido a una página web alojada en Punchh, donde se mostrará el cupón generado.

Extracción de código mediante JSON como texto sin formato

Para devolver una respuesta JSON, añada {{jwt}} a la URL de generación dinámica que creó anteriormente y, a continuación, añada .json después del token en la cadena de URL. Su enlace debe ser similar al siguiente:

1
https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.json?sign={{jwt}}

A continuación, puede aprovechar Connected Content para insertar el código como texto sin formato en el cuerpo de cualquier mensaje. Por ejemplo:

1
2
{% connected_content https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.json?sign={{jwt}} :save punchh_coupon %}
{{punchh_coupon.coupon}}

Enlazar una imagen dentro del contenido de un correo electrónico

Para enlazar el código del cupón dentro de una imagen:

1. Añada {{jwt}} a la URL de generación dinámica que creó anteriormente.
2. Añada .png después del token en la cadena URL.
3. Inserte su enlace en una etiqueta HTML <img>.

• ejemplo de entrada
• ejemplo de salida

1
<img src="https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.png?sign={{jwt}}">

Mensajes de error