Génération de code dynamique avec Punchh

Un code de coupon est un code unique qui peut être utilisé par un seul utilisateur (une seule fois ou plusieurs fois). Le framework Punchh génère des codes de coupon, qui peuvent être traités dans une application mobile ou au point de vente (POS).

Cette intégration est maintenue par Punchh.

À propos de l’intégration

En combinant le framework de coupons Punchh et Braze, vous pouvez réaliser les scénarios suivants :

• Générer un code de coupon lorsque l’invité clique sur un lien de génération de coupon dans un e-mail : le code de coupon sera généré dynamiquement et affiché sur une page web.
• Générer un code de coupon lorsque l’invité ouvre un e-mail : le code de coupon sera généré dynamiquement et affiché sous forme d’image dans l’e-mail.

Intégration de la génération dynamique de codes de coupon

Étape 1 : Créer une campagne de coupons

1. À l’aide d’une campagne de coupons Punchh, créez une campagne de génération dynamique de coupons comme indiqué dans l’image suivante.
2. Le framework de coupons Punchh générera les paramètres suivants pour permettre la génération dynamique de coupons :
   • Jeton de génération dynamique de coupon : il s’agit d’un jeton de sécurité généré par le système pour le chiffrement.
   • URL de génération dynamique de coupon : cette URL sera intégrée dans l’e-mail sous forme de lien ou d’image, selon les besoins de l’entreprise.

Étape 2 : Générer une signature et construire une URL

La bibliothèque JWT.IO décode, vérifie et génère des jetons web JSON, une méthode ouverte et standard de l’industrie RFC 7519 pour représenter des revendications de manière sécurisée entre deux parties.

Les noms ClaimType suivants peuvent être utilisés pour garantir l’unicité des invités et des coupons :

• campaign_id : représente l’ID de campagne Punchh généré par le système.
• email : représente l’adresse e-mail de l’utilisateur.
• first_name : capture le prénom de l’utilisateur.
• last_name : capture le nom de famille de l’utilisateur.

Pour utiliser l’API de code de coupon dynamique Punchh, un jeton JWT doit être créé. Ajoutez le modèle Liquid suivant à votre tableau de bord de Braze dans le corps du message du canal que vous souhaitez utiliser :

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 %}

Remplacez les éléments suivants :

Étape 3 : Ajouter le code de coupon au corps du message

Lien vers la page web Punchh

Pour créer un lien vers une page web hébergée par Punchh, ajoutez {{jwt}} à l’URL de génération dynamique que vous avez créée précédemment. Votre lien doit ressembler à ce qui suit :

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

Lorsqu’un utilisateur clique sur l’URL du coupon, il est redirigé vers une page web hébergée par Punchh, où son coupon généré sera affiché.

Extraction du code via JSON en texte brut

Pour renvoyer une réponse JSON, ajoutez {{jwt}} à l’URL de génération dynamique que vous avez créée précédemment, puis ajoutez .json après le jeton dans la chaîne de caractères de l’URL. Votre lien doit ressembler à ce qui suit :

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

Vous pouvez ensuite tirer parti du Contenu connecté pour insérer le code en texte brut dans le corps de n’importe quel message. Par exemple :

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

Intégration d’une image dans le contenu de l’e-mail

Pour intégrer le code de coupon dans une image :

1. Ajoutez {{jwt}} à l’URL de génération dynamique que vous avez créée précédemment.
2. Ajoutez .png après le jeton dans la chaîne de caractères de l’URL.
3. Intégrez votre lien dans une balise HTML <img>.

• exemple d'entrée
• exemple de sortie

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

Messages d’erreur