Punchh

Punchh est une plateforme de fidélisation et d’engagement de pointe qui permet aux marques de proposer des programmes de fidélité omnicanaux à la fois en magasin et en ligne.

Cette intégration est maintenue par Punchh.

À propos de l’intégration

L’intégration entre Braze et Punchh vous permet de synchroniser les données relatives aux cadeaux et à la fidélité entre les deux plateformes. Les données publiées dans Braze seront disponibles pour la segmentation et pourront resynchroniser les données utilisateur dans Punchh via les webhooks Braze.

Quels sont les avantages ?

• Ingérer les données de fidélité de Punchh vers Braze en temps réel.
• Exploiter et superposer les données d’audience puissantes de Braze pour offrir des expériences cross-canal significatives et dynamiques (application, mobile, web, e-mail et SMS)
  • Les clients ont-ils ouvert les e-mails ? Les clients ont-ils ouvert l’application à proximité d’un magasin ?
• Standardiser l’apparence des e-mails transactionnels envoyés via Braze.
• Créer des parcours permettant le test A/B et l’optimisation au fil du temps.

Prérequis

Que faut-il savoir d’autre ?

Avant l’intégration

• Lors de l’utilisation de l’intégration Braze, deux campagnes seront nécessaires, une dans Punchh et la seconde dans Braze. Par exemple, si vous envoyez une campagne avec une offre associée, la campagne de distribution de cadeaux sera configurée dans Punchh, et la notification pourra être envoyée depuis Braze.
• Les invités doivent déjà exister dans Punchh et Braze. Punchh filtrera tout client qui n’est pas déjà un invité du programme de fidélité.

Points importants à noter

• Punchh a ajouté la possibilité de désactiver l’envoi des attributs utilisateur par défaut à Braze, afin que le client n’encoure pas de dépassements de points de données. Ceci est configuré lors de la mise en place de l’adaptateur.
• Si vous utilisez des Segments personnalisés dans des campagnes récurrentes, le nom de la campagne doit être utilisé à la place de l’identifiant de la campagne, car les identifiants changent à chaque exécution de la campagne.
• Les canaux de communication disponibles dans chaque campagne de distribution de cadeaux Punchh incluent les messages enrichis, les notifications push, les SMS et les e-mails.
• Une fois que les utilisateurs ont été envoyés vers un Segment personnalisé Punchh depuis Braze, ils ne peuvent pas être retirés. Seuls de nouveaux invités peuvent être ajoutés à un Segment personnalisé existant. Si des invités doivent être retirés d’un Segment personnalisé Punchh existant, une nouvelle campagne webhook devra être créée dans Braze pour envoyer les utilisateurs vers un nouveau Segment personnalisé Punchh.

Intégration

Punchh propose plusieurs endpoints accessibles aux clients de Braze pour faciliter l’ajout d’ID externes à la plateforme Punchh à l’aide des endpoints API Punchh suivants. Une fois les ID externes ajoutés, créez un adaptateur dans Punchh, fournissez vos identifiants Braze et sélectionnez les événements que vous souhaitez synchroniser. Vous pouvez ensuite utiliser l’ID de Segment Punchh pour créer un webhook Punchh afin de déclencher la synchronisation des clients dans un parcours Canvas.

Notez que le user_id Punchh et l’external_id Braze doivent être disponibles sur l’une ou l’autre plateforme pour que l’intégration se synchronise correctement.

• Les événements envoyés de Punchh à Braze incluront l’external_id Braze comme identifiant. Si Punchh est configuré pour utiliser l’external_source_id, cette valeur sera définie comme l’external_id Braze. Sinon, l’intégration définira par défaut le user_id Punchh comme l’external_id Braze.
• Pour envoyer des webhooks de Braze à Punchh, le user_id Punchh doit être disponible sur le profil utilisateur Braze. Si le user_id Punchh n’est pas utilisé comme l’external_id Braze, il doit être défini comme attribut personnalisé « punchh_user_id ».

Étape 1 : Configurer les endpoints d’ingestion d’ID externes (facultatif)

Les ID externes de Braze peuvent être ajoutés à l’aide des endpoints suivants pour les utilisateurs Punchh nouveaux et existants.

Important

Les valeurs des champs external_source et external_source_id doivent être uniques dans Punchh et ne pas être associées à des profils existants.

1. Nouveaux utilisateurs Punchh
   Créez de nouveaux utilisateurs dans Punchh avec un endpoint d’inscription Punchh en utilisant les champs external_source et external_source_id. Punchh permet d’envoyer des identifiants externes avec un profil utilisateur via l’un des endpoints d’inscription suivants :
   • API d’inscription mobile
   • API d’inscription authentification unique
     
     
2. Utilisateurs Punchh existants
   Mettez à jour l’external_source_id pour les utilisateurs Punchh existants. Punchh permet d’ajouter des identifiants externes à un profil via un endpoint de mise à jour de l’API utilisateur :
   • Mise à jour utilisateur mobile
   • Mise à jour utilisateur authentification unique
   • Mise à jour utilisateur tableau de bord
     
     

• exemple d'api d'inscription utilisateur
• exemple d'api de mise à jour utilisateur

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"
    }
}'

Remarque

Configuration de la plateforme : pour activer les identifiants externes dans Punchh, depuis le tableau de bord Punchh, accédez à Cockpit > Dashboard > External User Identifier.

Étape 2 : Configuration de l’adaptateur Braze dans Punchh

Événements disponibles à synchroniser

1. Guest : déclenché lors de toute inscription, mise à jour du profil invité, désactivation ou suppression
2. Loyalty Check-in : déclenché pour les transactions de fidélité ou les gains par scan de code-barres depuis le reçu
3. Gift Check-in : déclenché pour les points offerts dans le cadre d’une campagne
4. Redemption : déclenché en cas d’échange de récompense, à l’exclusion des coupons Punchh, car ceux-ci sont envoyés séparément en tant qu’événements de coupon, y compris l’émission et l’échange
5. Rewards : déclenché par les récompenses offertes via des campagnes, une activité, la conversion de points en récompenses ou l’attribution par un administrateur
6. Transaction Notifications : déclenché lors d’une activité transactionnelle pour un utilisateur au sein du système Punchh (par exemple, l’expiration de points)
7. Marketing Notifications : déclenché en fonction de différentes configurations de campagnes dans Punchh pour un Segment d’utilisateurs associé

Remarque

Consultez la documentation Punchh pour découvrir à quoi peuvent ressembler les exemples de payloads pour ces événements disponibles.

Travaillez avec votre responsable de déploiement Punchh pour configurer cet adaptateur.

Pour configurer l’intégration Braze et Punchh, procédez comme suit :

1. Dans le tableau de bord Punchh, accédez à Cockpit > Dashboard > Major Features > Enable Webhook Management et activez Enable Webhook Management.
   
   
2. Ensuite, activez les adaptateurs en accédant à Settings > Webhooks gestionnaire > Configurations > Show Adapters Tab et activez Show Adapters Tab.
   
   
3. Accédez à Webhooks Manager sous l’onglet Settings, sélectionnez l’onglet Adapters, puis cliquez sur Create Adapter.
   
   
   
   
4. Renseignez le nom de l’adaptateur, la description et l’e-mail de l’administrateur. Sélectionnez Braze comme adaptateur et fournissez votre endpoint REST API Braze et votre clé API Braze.
   
   
5. Ensuite, sélectionnez les événements disponibles que vous souhaitez activer. Une liste de ces événements est disponible dans Événements disponibles à synchroniser.
   
   
   
   
6. Cliquez sur Submit pour activer le webhook.

Créer un webhook Punchh dans Braze

Braze peut ajouter des utilisateurs à un Segment Punchh via des webhooks en utilisant les segments personnalisés Punchh.

1. Créez un segment personnalisé dans Punchh et notez le custom_segment_id présent dans l’URL du tableau de bord des segments Punchh, comme illustré dans l’exemple suivant. Les générateurs de segments classique et bêta peuvent tous deux être utilisés. Cependant, la version bêta est recommandée, car la version classique sera à terme abandonnée.
   
   Dans la plateforme Punchh, accédez à Guest > Segment > Custom List > New Custom List.
   
   
   
   

2. Créez une campagne webhook dans Braze en utilisant l’endpoint Punchh pour ajouter un utilisateur à un segment personnalisé comme URL du webhook. Ici, vous pouvez fournir le custom_segment_id extrait de l’URL et le user_id en tant que paires clé-valeur.
   
   
   
   

3. Ce webhook peut être configuré en tant que Campaign unique ou en tant qu’étape au sein d’un Canvas. Alternativement, si le webhook ajoutant des utilisateurs à ce Segment Punchh spécifique sera utilisé dans plusieurs Campaigns ou Canvas, il peut être configuré en tant que modèle.
   
   La clé user_id dans le webhook correspond à l’identifiant utilisateur Punchh. Cet identifiant devra être ajouté à tous les webhooks créés dans Braze pour ajouter des utilisateurs à un segment personnalisé Punchh. L’attribut personnalisé punch_user_id peut être renseigné dynamiquement comme valeur de la clé user_id à l’aide de Liquid. Vous pouvez insérer la variable d’attribut personnalisé punchh_user_id en utilisant l’icône bleue « plus » dans la barre d’outils du champ de texte modélisé.
   
   
   
   
   
   

4. Une fois le webhook enregistré, il peut être utilisé pour synchroniser les utilisateurs. Par exemple, 136 invités seraient ajoutés au segment personnalisé Punchh lorsque cette campagne webhook Braze est lancée.
   
   

Pour plus d’informations sur l’utilisation des webhooks dans Braze, consultez Créer un webhook.

Campaigns de cas d’usage

Configuration de Campaign et de Canvas

Déclenchement

Les cas d’usage pour la messagerie Braze déclenchée par des événements Punchh envoyés à Braze, tels que des événements de récompense ou des événements invité, peuvent être créés en tant que campaigns basées sur des actions ou Canvas déclenchés par l’événement Punchh pertinent.

L’ajout d’un déclencheur fera apparaître la liste des événements créés dans Braze. Choisissez l’événement qui doit déclencher l’envoi de votre Campaign ou Canvas à l’utilisateur qui a enregistré l’événement.

Des filtres de propriétés peuvent être ajoutés pour affiner davantage l’événement déclencheur. Par exemple, le message ne doit être déclenché que lorsqu’un client déclenche l’événement « checkins_gift » dont la propriété d’événement approved est true. Il s’agit d’une fonctionnalité facultative qui peut ne pas s’appliquer à tous les cas d’usage.

Segmentation

Dans de nombreux cas, les Campaigns et Canvas Braze déclenchés par des événements Punchh peuvent être définis pour une audience « Tous les utilisateurs », car la segmentation des utilisateurs déclenchant ces événements est déterminée au sein de Punchh. Cependant, les clients souhaitant affiner davantage l’audience des utilisateurs qui recevront la messagerie Braze déclenchée par l’événement peuvent le faire en ajoutant des filtres et des Segments supplémentaires dans la section Target Audiences du compositeur de Campaign ou dans l’Entry Audience du compositeur de Canvas.

Cas d’usage

• inscription
• accueil braze
• offre groupée
• offre groupée récurrente
• offre post-visite avec notification
• offre post-visite sans notification
• anniversaire
• rappel