Punchh

Punchh ist eine branchenführende Plattform für Kundenbindung und Engagement, die es Marken ermöglicht, Omnichannel-Kundenbindungs-Programme sowohl im Shop als auch digital anzubieten.

Diese Integration wird von Punchh gepflegt.

Über die Integration

Die Integration von Braze und Punchh ermöglicht es Ihnen, Daten für Geschenk- und Kundenbindungszwecke zwischen den beiden Plattformen zu synchronisieren. In Braze veröffentlichte Daten stehen für die Segmentierung zur Verfügung und können über Braze-Webhooks wieder in Punchh zurücksynchronisiert werden.

Welche Vorteile bietet die Integration?

• Nehmen Sie Kundenbindungsdaten von Punchh in Braze in Echtzeit auf.
• Nutzen Sie leistungsstarke Zielgruppendaten aus Braze und kombinieren Sie diese, um bedeutungsvolle und dynamische kanalübergreifende Erlebnisse zu schaffen (App, Mobilgeräte, Internet, E-Mail und SMS).
  • Haben Kund:innen E-Mails geöffnet? Haben Kund:innen die App in der Nähe eines Shops geöffnet?
• Standardisieren Sie das Erscheinungsbild von Transaktions-E-Mails, die über Braze versendet werden.
• Erstellen Sie Journeys, die A/B-Tests und laufende Optimierung ermöglichen.

Voraussetzungen

Was sollte ich sonst noch wissen?

Vor der Integration

• Bei der Nutzung der Braze-Integration werden zwei Campaigns benötigt: eine in Punchh und eine zweite in Braze. Wenn Sie beispielsweise eine Campaign mit einem angehängten Angebot senden, wird die Geschenk-Campaign in Punchh konfiguriert und die Benachrichtigung kann über Braze gesendet werden.
• Gäste sollten bereits in Punchh und Braze vorhanden sein. Punchh filtert alle Kund:innen heraus, die nicht bereits Gäste im Kundenbindungs-Programm sind.

Wichtige Hinweise

• Punchh bietet die Möglichkeit, das Senden von standardmäßigen Nutzerattributen an Braze zu deaktivieren, damit für den Kunden keine Mehrkosten bei Datenpunkten entstehen. Dies wird während der Adapter-Einrichtung konfiguriert.
• Wenn Sie benutzerdefinierte Segmente in wiederkehrenden Campaigns verwenden, muss der Campaign-Name anstelle der Campaign-ID verwendet werden, da sich die IDs bei jedem Durchlauf der Campaign ändern.
• Zu den verfügbaren Kommunikationskanälen innerhalb jeder Punchh-Geschenk-Campaign gehören Rich-Nachrichten, Push-Benachrichtigungen, SMS und E-Mail.
• Nachdem Nutzer:innen von Braze an ein benutzerdefiniertes Punchh-Segment gesendet wurden, können sie nicht mehr daraus entfernt werden. Es können nur neue Gäste zu einem bestehenden benutzerdefinierten Segment hinzugefügt werden. Wenn Gäste aus einem bestehenden benutzerdefinierten Punchh-Segment entfernt werden müssen, muss eine neue Webhook-Campaign in Braze erstellt werden, um Nutzer:innen an ein neues benutzerdefiniertes Punchh-Segment zu senden.

Integration

Punchh bietet verschiedene Endpunkte an, die Braze-Kund:innen zur Verfügung stehen, um der Punchh-Plattform über die folgenden Punchh-API-Endpunkte externe IDs hinzuzufügen. Nachdem die externen IDs hinzugefügt wurden, erstellen Sie einen Adapter in Punchh, geben Ihre Braze-Zugangsdaten an und wählen die Ereignisse aus, die Sie synchronisieren möchten. Anschließend können Sie die Punchh-Segment-ID verwenden, um einen Punchh-Webhook zu erstellen, der die Kundensynchronisierung in einer Canvas Journey triggert.

Beachten Sie, dass die Punchh user_id und die Braze external_id in beiden Plattformen verfügbar sein müssen, damit die Integration korrekt synchronisiert werden kann.

• Ereignisse, die von Punchh an Braze gesendet werden, enthalten die Braze external_id als Bezeichner. Wenn Punchh so konfiguriert ist, dass die external_source_id verwendet wird, wird dieser Wert als Braze external_id gesetzt. Andernfalls wird bei der Integration standardmäßig die Punchh user_id als Braze external_id gesetzt.
• Um Webhooks von Braze an Punchh zu senden, muss die Punchh user_id im Braze-Kundenprofil verfügbar sein. Wenn die Punchh user_id nicht als Braze external_id verwendet wird, sollte sie als angepasstes Attribut „punchh_user_id“ festgelegt werden.

1. Schritt: Einrichten von externen ID-Ingestion-Endpunkten (optional)

Externe IDs von Braze können über die folgenden Endpunkte für neue und bestehende Punchh-Nutzer:innen hinzugefügt werden.

Wichtig

Die Werte in den Feldern external_source und external_source_id müssen für Punchh eindeutig sein und dürfen nicht mit bestehenden Profilen verknüpft sein.

1. Neue Punchh-Nutzer:innen
   Erstellen Sie neue Nutzer:innen in Punchh mit einem Punchh-Registrierungsendpunkt unter Verwendung der Felder external_source und external_source_id. Punchh ermöglicht die Übermittlung externer Bezeichner mit einem Kundenprofil über einen der folgenden Registrierungsendpunkte:
   • Mobile Signup API
   • Single Sign-on Signup API
     
     
2. Bestehende Punchh-Nutzer:innen
   Aktualisieren Sie die external_source_id für bestehende Punchh-Nutzer:innen. Punchh ermöglicht das Hinzufügen externer Bezeichner zu einem Profil über einen Nutzer-API-Update-Endpunkt:
   • Mobile User Update
   • Single Sign-on User Update
   • Dashboard User Update
     
     

• beispiel für die nutzerregistrierungs-api
• beispiel für die nutzeraktualisierungs-api

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

Hinweis

Plattform-Konfiguration: Um externe Bezeichner in Punchh zu aktivieren, navigieren Sie im Punchh-Dashboard zu Cockpit > Dashboard > External User Identifier.

2. Schritt: Braze-Adapter-Einrichtung in Punchh

Verfügbare zu synchronisierende Ereignisse

1. Gast: Ausgelöst bei jeder Registrierung, Aktualisierung des Gastprofils, Deaktivierung oder Löschung
2. Loyalitäts-Check-in: Ausgelöst bei Treuetransaktionen oder durch Scannen des Barcodes auf dem Kassenbon
3. Geschenk-Check-in: Ausgelöst durch Punkte, die aus einer Kampagne verschenkt werden
4. Einlösung: Ausgelöst bei jeder Prämieneinlösung mit Ausnahme von Punchh-Coupons, da diese separat als Coupon-Ereignisse gesendet werden, einschließlich Ausgabe und Einlösung
5. Rewards: Ausgelöst durch geschenkte Rewards aus Kampagnen, Aktivität, Konversion von Punkten in Rewards oder Admin-Geschenke
6. Transaktionsbenachrichtigungen: Ausgelöst bei Transaktionsaktivitäten einer Nutzer:in innerhalb des Punchh-Systems (z. B. Punkteverfall)
7. Marketing-Benachrichtigungen: Ausgelöst auf der Grundlage verschiedener Kampagnen-Setups in Punchh für ein zugehöriges Segment von Nutzer:innen

Hinweis

In der Punchh-Dokumentation finden Sie Beispiel-Payloads für diese verfügbaren Ereignisse.

Arbeiten Sie mit Ihrem Punchh Implementation Manager:in zusammen, um diesen Adapter einzurichten.

Um die Integration von Braze und Punchh einzurichten, gehen Sie wie folgt vor:

1. Navigieren Sie im Punchh-Dashboard zu Cockpit > Dashboard > Major Features > Enable Webhook Management und schalten Sie Enable Webhook Management ein.
   
   
2. Aktivieren Sie als Nächstes die Adapter, indem Sie zu Settings > Webhooks Manager:in > Configurations > Show Adapters Tab navigieren und Show Adapters Tab einschalten.
   
   
3. Navigieren Sie zum Webhooks Manager unter dem Tab Settings, wählen Sie den Tab Adapters und klicken Sie auf Create Adapter.
   
   
   
   
4. Geben Sie den Adapternamen, die Beschreibung und die Admin-E-Mail ein. Wählen Sie Braze als Ihren Adapter und geben Sie Ihren Braze REST-API-Endpunkt und Braze-API-Schlüssel an.
   
   
5. Wählen Sie dann die verfügbaren Ereignisse aus, die Sie aktivieren möchten. Eine Liste dieser Ereignisse finden Sie unter Verfügbare zu synchronisierende Ereignisse.
   
   
   
   
6. Klicken Sie auf Submit, um den Webhook zu aktivieren.

Punchh-Webhook in Braze erstellen

Braze kann Nutzer:innen über Webhooks, die Punchh Custom Segments nutzen, zu einem Punchh-Segment hinzufügen.

1. Erstellen Sie ein benutzerdefiniertes Segment in Punchh und notieren Sie die custom_segment_id, die in der URL des Punchh-Segment-Dashboards angezeigt wird, wie im folgenden Beispiel gezeigt. Sowohl der klassische als auch der Beta-Segment-Builder können verwendet werden. Der Beta-Builder wird jedoch empfohlen, da der klassische Builder irgendwann eingestellt wird.
   
   Navigieren Sie in der Punchh-Plattform zu Guest > Segment > Custom List > New Custom List.
   
   
   
   

2. Erstellen Sie eine Webhook-Kampagne in Braze und verwenden Sie den Punchh-Endpunkt zum Hinzufügen einer Nutzer:in zu einem benutzerdefinierten Segment als Webhook-URL. Hier können Sie die custom_segment_id aus der URL und die user_id als Schlüssel-Wert-Paare angeben.
   
   
   
   

3. Dieser Webhook kann als einzelne Campaign oder als Schritt innerhalb eines Canvas eingerichtet werden. Alternativ kann der Webhook, der Nutzer:innen zu diesem bestimmten Punchh-Segment hinzufügt, als Template eingerichtet werden, wenn er in mehreren Campaigns oder Canvases verwendet wird.
   
   Der user_id-Schlüssel innerhalb des Webhooks wird der Punchh-Nutzer:innen-ID zugeordnet. Dieser Bezeichner muss zu allen in Braze erstellten Webhooks hinzugefügt werden, um Nutzer:innen zu einem benutzerdefinierten Punchh-Segment hinzuzufügen. Das angepasste Attribut punch_user_id kann mithilfe von Liquid dynamisch als Wert für den user_id-Schlüssel befüllt werden. Sie können die Variable des angepassten Attributs punchh_user_id über das blaue „Plus“-Symbol in der Symbolleiste des Template-Textfelds einfügen.
   
   
   
   
   
   

4. Nachdem der Webhook gespeichert wurde, kann er zur Synchronisierung von Nutzer:innen verwendet werden. Beispielsweise würden 136 Gäste zum benutzerdefinierten Punchh-Segment hinzugefügt, wenn diese Braze-Webhook-Campaign gestartet wird.
   
   

Weitere Informationen zur Verwendung von Webhooks in Braze finden Sie unter Webhook erstellen.

Anwendungsfälle für Campaigns

Campaign- und Canvas-Konfiguration

Triggering

Anwendungsfälle für Braze-Nachrichten, die durch Punchh-Ereignisse ausgelöst werden, die an Braze gesendet werden, wie z. B. Reward-Ereignisse oder Gast-Ereignisse, können als aktionsbasierte Campaigns oder Canvases erstellt werden, die durch das entsprechende Punchh-Ereignis ausgelöst werden.

Durch das Hinzufügen eines Triggers wird die Liste der in Braze erstellten Ereignisse angezeigt. Wählen Sie das Ereignis aus, das Ihre Campaign oder Ihren Canvas auslösen soll, damit die Nachricht an die Nutzer:innen gesendet wird, die das Ereignis protokolliert haben.

Es können Eigenschaftsfilter hinzugefügt werden, um das auslösende Ereignis weiter einzugrenzen. Beispielsweise sollte die Nachricht nur ausgelöst werden, wenn eine Kund:in das Ereignis „checkins_gift“ auslöst und die Ereigniseigenschaft „approved“ den Wert true hat. Dies ist ein optionales Feature, das möglicherweise nicht für alle Anwendungsfälle relevant ist.

Segmentierung

In vielen Fällen können Braze Campaigns und Canvases, die durch Punchh-Ereignisse ausgelöst werden, auf die Zielgruppe „Alle Nutzer:innen“ gesetzt werden, da die Segmentierung der Nutzer:innen, die diese Ereignisse auslösen, innerhalb von Punchh erfolgt. Kund:innen, die die Zielgruppe der Nutzer:innen, die das durch das Ereignis ausgelöste Braze-Messaging erhalten, weiter verfeinern möchten, können dies tun, indem sie zusätzliche Filter und Segmente im Bereich Target Audiences des Campaign-Composers oder in der Entry Audience des Canvas-Composers hinzufügen.

Anwendungsfälle

• registrierung
• braze-willkommen
• massenangebot
• wiederkehrendes massenangebot
• post-check-in-angebot mit benachrichtigung
• post-check-in-angebot ohne benachrichtigung
• jubiläum
• rückruf