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 de Braze et Punchh vous permet de synchroniser les données à des fins de cadeaux et de fidélité sur les deux plateformes. Les données publiées dans Braze seront disponibles pour la segmentation et pourront être synchronisées avec Punchh via les webhooks de Braze.

Quels en sont les avantages ?

• Ingérez les données de fidélité de Punchh à Braze en temps réel.
• Tirez parti des puissantes données d’audience de Braze pour proposer des expériences cross-canal significatives et dynamiques (applications, mobile, Web, e-mail et SMS)
  • Les clients ont-ils ouvert leurs e-mails ? Les clients ont-ils ouvert l’application à proximité d’un magasin ?
• Standardisez l’apparence des e-mails transactionnels envoyés via Braze.
• Créez des parcours qui permettent de réaliser des tests A/B et de les optimiser au fur et à mesure.

Conditions préalables

Que dois-je savoir d’autre ?

Avant l’intégration

• Lors de l’utilisation de l’intégration de Braze, deux campagnes seront nécessaires, l’une à Punchh et la seconde à Braze. Par exemple, si vous envoyez une campagne avec une offre en pièce jointe, la campagne de cadeaux sera configurée dans Punchh et la notification pourra être envoyée depuis Braze.
• Des invités devraient déjà exister à Punchh et Braze. Punchh filtrera tous les clients qui ne sont pas encore des clients 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 ne subisse pas de dépassement de point de données. Ceci est configuré lors de la configuration 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’ID de campagne, car les identifiants changent à chaque fois que la campagne est lancée.
• Les canaux de communication disponibles dans le cadre de chaque campagne de cadeaux Punchh incluent les messages enrichis, les notifications push, les SMS et les e-mails.
• Une fois que les utilisateurs ont été redirigés vers un segment personnalisé Punchh depuis Braze, ils ne peuvent pas être supprimés. Seuls les 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 de webhook devra être créée dans Braze pour rediriger les utilisateurs vers un nouveau segment personnalisé Punchh.

Intégration

Punchh propose plusieurs points de terminaison aux clients de Braze pour les aider à ajouter des identifiants externes à la plateforme Punchh à l’aide des points de terminaison de l’API Punchh suivants. Une fois les identifiants externes ajoutés, créez un adaptateur dans Punchh, fournissez vos informations d’identification Braze et sélectionnez les événements que vous souhaitez synchroniser. Ensuite, vous pouvez 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 les sites Punchh user_id et Braze external_id doivent être disponibles dans l’une ou l’autre plateforme pour que l’intégration se synchronise correctement. 

• Les événements envoyés de Punchh à Braze comprendront l’identifiant Braze external_id. Si Punchh est configuré pour utiliser external_source_id, cette valeur sera définie comme la valeur de Braze external_id. Dans le cas contraire, l’intégration se fera par défaut en définissant le Punchh user_id comme étant le Braze external_id.
• Pour envoyer des webhooks de Braze à Punchh, le profil utilisateur de Braze doit disposer de Punchh user_id. Si Punchh user_id n’est pas utilisé comme Braze external_id, il doit être défini comme un attribut personnalisé. “punchh_user_id”. 

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

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

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

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

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

Événements disponibles à synchroniser

1. Invité : Déclenché lors de toute inscription, mise à jour du profil d’invité, désactivé ou supprimé
2. Enregistrement des programmes de fidélité : Déclenché pour les transactions de fidélité ou les gains en scannant le code-barres du reçu
3. Enregistrement des cadeaux : Déclenché pour les points offerts lors d’une campagne
4. Remboursement : Déclenché en cas d’échange de récompenses, à l’exception des coupons Punchh, car ceux-ci seraient envoyés séparément en tant qu’événements liés aux coupons, y compris l’émission et le remboursement
5. Récompenses : Déclenché par des récompenses offertes lors de campagnes, d’activités, de conversions de points en récompenses ou de cadeaux d’administrateur
6. Notifications de transactions : Déclenché lors d’une activité transactionnelle pour un utilisateur dans le système Punchh (par exemple, expiration de points)
7. Notifications marketing : Déclenché en fonction de différentes configurations de campagne dans Punchh pour un segment d’utilisateurs associé

Travaillez avec votre responsable de l’implémentation Punchh pour configurer cet adaptateur.

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

1. Dans le tableau de bord Punchh, accédez à Cockpit > Tableau de bord > Principales fonctionnalités > Activer la gestion des webhooks et basculer sur Activer la gestion des webhooks.
   
   
2. Activez ensuite les adaptateurs en accédant à Paramètres > Gestionnaire de webhooks > Configurations > Afficher l’onglet Adaptateurs et en basculant sur l’onglet Afficher les adaptateurs.
   
   
3. Accédez au gestionnaire Webhooks sous l’onglet Paramètres, sélectionnez l’onglet Adaptateurs, puis cliquez sur Créer un adaptateur.
   
   
   
   
4. Entrez le nom, la description et l’e-mail de l’administrateur de l’adaptateur. Sélectionnez Braze comme adaptateur et fournissez votre endpoint d’API Braze REST et votre clé d’API Braze.
   
   
5. Sélectionnez ensuite les événements disponibles que vous souhaitez activer. Une liste de ces événements se trouve dans Événements disponibles à synchroniser.
   
   
   
   
6. Cliquez sur Soumettre pour activer le webhook.

Créer un webhook Punchh dans Braze

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

1. Créez un segment personnalisé dans Punchh et notez le contenu dans l’URL du custom_segment_id tableau de bord des segments Punchh, comme indiqué ci-dessous. Les constructeurs de segments classiques ou bêta peuvent être utilisés. Cependant, la version bêta est recommandée car la version classique finira par devenir obsolète.
   
   Sur la plateforme Punchh, accédez à Invité > Segment > Liste personnalisée > Nouvelle liste personnalisée.
   
   
   
   

2. Créez une campagne de webhook dans Braze à l’aide de l’endpoint Punchh pour ajouter un utilisateur à un segment personnalisé en tant qu’URL du webhook. Ici, vous pouvez fournir les données custom_segment_id extraites de l’URL et user_id sous forme de paires clé-valeur.
   
   
   
   

3. Ce webhook peut être configuré en tant que campagne individuelle ou en tant qu’étape d’un Canvas. Sinon, si le webhook qui ajoute des utilisateurs à ce segment Punchh spécifique est utilisé dans plusieurs campagnes ou Canvases, il peut être configuré comme modèle.
   
   La clé user_id du webhook correspond à l’ID utilisateur Punchh. Cet identifiant devra être ajouté à tous les webhooks créés dans Braze pour ajouter des utilisateurs à un segment personnalisé Punchh. L’attribut punch_user_id personnalisé peut être renseigné dynamiquement en tant que valeur de la clé user_id à l’aide de Liquid. Vous pouvez insérer la variable d’attribut punchh_user_id personnalisée à l’aide de l’icône bleue « plus » située en haut à droite de tout champ de texte modélisé.
   
   
   
   
   
   

4. Une fois le webhook enregistré, il peut être utilisé pour synchroniser les utilisateurs, comme indiqué ci-dessous. Par exemple, 136 invités seraient ajoutés au segment personnalisé Punch lors du lancement de cette campagne de webhook Braze.
   
   

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

Campagnes de cas d’utilisation

Configuration de la campagne et du canevas

Déclenchement

Les cas d’utilisation des messages Braze déclenchés par l’envoi d’événements Punchh à Braze, tels que les événements de récompense ou les événements réservés aux invités, peuvent être créés sous forme de campagnes basées sur l’action ou de canvas déclenchés par l’événement Punchh concerné.

L’ajout d’un déclencheur affichera la liste des événements créés dans Braze. Choisissez l’événement qui doit déclencher votre campagne ou Canvas à envoyer à l’utilisateur qui a enregistré l’événement.

Des filtres de propriétés peuvent être ajoutés pour filtrer 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” et que la propriété d’événement approuvée est true. Il s’agit d’une fonctionnalité optionnelle qui peut ne pas être applicable à tous les cas d’utilisation.

Segmentation

Dans de nombreux cas, les campagnes et les toiles Braze déclenchées par des événements Punchh peuvent être définies sur 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 qui souhaitent affiner davantage l’audience des utilisateurs qui recevront l’envoi de messages Braze déclenché par l’événement peuvent le faire en ajoutant des filtres et des segments supplémentaires dans la section Audiences cibles du compositeur de campagne ou dans la section Entry Audience du compositeur Canvas.

Cas d’utilisation

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