Skip to content

Talkable

Talkable hilft Verbrauchermarken, zufriedene Kund:innen in einen skalierbaren Empfehlungskanal zu verwandeln. Mit der Braze-Integration fließen Marketing-E-Mail-Opt-ins, die in Talkable-Empfehlungskampagnen erfasst werden, in Echtzeit in Braze, sodass Ihr Team die Einwilligung, den Kontext und die Kampagnendaten erhält, die Sie benötigen, um jede:n neue:n Fürsprecher:in und Freund:in willkommen zu heißen, zu segmentieren und anzusprechen.

Diese Integration wird von Talkable gepflegt.

Über die Integration

Talkable bringt die von Fürsprecher:innen gesteuerte Akquise in die Customer Journey ein, die Braze unterstützt. Die Integration überträgt jedes Empfehlungs-Opt-in, das Talkable erfasst, in Realtime in das passende Braze-Profil, sodass Willkommens-Flows, Empfehlungs-Journeys, Segmentierung und Lifecycle-Messaging auf Basis von vertrauenswürdigem Einverständnis und Empfehlungskontext gestartet werden können – ganz ohne manuelle Listenexporte oder Batch-Synchronisierungen.

Talkable erfasst Marketing-Opt-ins in zwei Szenarien:

  • Registrierung als Fürsprecher:in: Eine Fürsprecherin oder ein Fürsprecher meldet sich für eine Talkable-Empfehlungskampagne an und stimmt dem Erhalt von Marketing-E-Mails zu.
  • E-Mail-Gating für Freund:innen: Eine eingeladene Person schließt den E-Mail-Gating-Schritt von Talkable ab und stimmt dem Erhalt von Marketing-E-Mails zu.

In beiden Fällen erstellt oder aktualisiert Talkable das passende Braze-Nutzerprofil in Realtime und setzt den E-Mail-Abo-Status der Nutzerin oder des Nutzers auf Opted In.

Standardverhalten

Talkable sendet Daten nur bei einem konkreten Opt-in-Ereignis an Braze – von einer Person, die in Talkable ausdrücklich zugestimmt hat, sei es als Fürsprecher:in bei der Anmeldung für eine Kampagne oder als eingeladene Person beim E-Mail-Gating. Talkable führt keine nächtlichen Batches, vollständigen Synchronisierungen oder impliziten Profilaktualisierungen durch. Talkable sendet niemals Profile an Braze, die kein Opt-in erteilt haben.

Anwendungsfälle

  • Triggern Sie ein Braze-Willkommens-Canvas, sobald ein:e Fürsprecher:in sich für eine Talkable-Empfehlungskampagne registriert.
  • Aktivieren Sie geworbene Freund:innen mit einem freundespezifischen Canvas und einem personalisierten Erstkaufangebot, sobald ein:e Freund:in ein Opt-in durchführt.
  • Segmentieren Sie nach Empfehlungskontext mithilfe von Fürsprecher:innen- und Freundes-Flags sowie Kampagnen-Metadaten, die als angepasste Braze-Attribute gesendet werden.
  • Leiten Sie Empfehlungs-Opt-ins in eine bestimmte Braze-Abo-Gruppe weiter, um einen datenschutzkonformen Newsletter-Versand zu gewährleisten.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Voraussetzung Beschreibung
Ein Talkable-Konto Eine Talkable-Website mit mindestens einer konfigurierten Campaign ist erforderlich, um diese Partnerschaft nutzen zu können.
Ein Braze-REST-API-Schlüssel Ein Braze-REST-API-Schlüssel mit users.track-Berechtigungen. Erstellen Sie diesen Schlüssel im Braze-Dashboard unter Einstellungen > API-Schlüssel. Weitere Informationen finden Sie unter REST-API-Schlüssel erstellen.
Ein Braze-REST-Endpunkt Ihre Braze-REST-Endpunkt-URL (zum Beispiel https://rest.iad-01.braze.com). Sowohl US- (.com) als auch EU-Braze-Cluster (.eu) werden unterstützt. Weitere Informationen finden Sie unter REST-API-Endpunkte.

Integration

1. Schritt: Braze-App in Talkable installieren

  1. Melden Sie sich in Ihrem Talkable-Admin an, öffnen Sie das Menü und navigieren Sie zu All Site Settings > App Store.
  2. Suchen Sie Braze und wählen Sie Install.
  3. Geben Sie Ihren Braze-REST-Endpunkt und einen REST-API-Schlüssel mit users.track-Berechtigungen ein und wählen Sie Save.

2. Schritt: E-Mail-Opt-in-Aktion konfigurieren

  1. Öffnen Sie in der Talkable-Braze-App die Aktion Email opt-in.
  2. (Optional) Geben Sie einen Braze-Abo-Gruppen-Bezeichner ein, fügen Sie angepasste Attribute hinzu und/oder konfigurieren Sie einen Nutzer-Alias. Weitere Informationen finden Sie unter Talkable anpassen.
  3. Wählen Sie Save. Lassen Sie die Aktion deaktiviert, damit Sie die Konfiguration mit einem Test-Payload überprüfen können, bevor Live-Opt-in-Ereignisse synchronisiert werden.

3. Schritt: Mit einem Beispiel-Payload testen

  1. Wählen Sie in Talkable Send sample payload bei der Aktion Email opt-in, um eine Testanfrage an Braze zu senden.
  2. Gehen Sie in Braze zu Audience > User Search und suchen Sie nach der Test-E-Mail-Adresse.
  3. Bestätigen Sie, dass das Profil mit Email Subscribe auf Opted In gesetzt existiert und dass alle konfigurierten angepassten Attribute, Abo-Gruppen-Zuordnungen oder Nutzer-Aliase wie erwartet angezeigt werden.

4. Schritt: Aktion für Live-Traffic aktivieren

Wenn das Testprofil in Braze korrekt aussieht, kehren Sie zu Talkable zurück und aktivieren Sie die Aktion Email opt-in.

Ab diesem Zeitpunkt synchronisiert jedes Talkable-Opt-in-Ereignis das passende Profil in Echtzeit mit Braze.

Standard-Nutzerattribute, die an Braze gesendet werden

Bei jedem Opt-in-Ereignis erstellt oder aktualisiert Talkable das entsprechende Braze-Nutzerprofil mit den folgenden Standard-Nutzerattributen von Braze. Leere Werte werden ausgelassen.

Braze-Attribut Typ Hinweise
email_subscribe String Wird bei jedem Talkable-Opt-in-Ereignis auf Opted In gesetzt.
email String Primärer Bezeichner, der zum Abgleich mit dem Braze-Profil verwendet wird.
phone String Wird nur als Nutzerattribut erfasst. Braze erwartet das E.164-Format; der Wert wird so gesendet, wie er in Talkable gespeichert ist.
first_name String Der Vorname der Person.
last_name String Der Nachname der Person.
Abo-Gruppenregistrierung Nicht zutreffend Talkable registriert die Nutzer:innen als abonniert, wenn eine Abo-Gruppe konfiguriert ist.
Nutzer-Alias Nicht zutreffend Wird nur hinzugefügt, wenn ein Nutzer-Alias konfiguriert ist. Weitere Informationen finden Sie unter Talkable anpassen.

Talkable anpassen

Die folgenden optionalen Anpassungen sind verfügbar. Konfigurieren Sie eine beliebige Kombination; sie sind unabhängig voneinander.

Opt-ins in eine Braze-Abo-Gruppe aufnehmen

  1. Kopieren Sie in Braze eine Abo-Gruppen-ID unter Zielgruppe > Abo-Gruppenverwaltung. Weitere Informationen finden Sie unter Nutzerabos verwalten.
  2. Fügen Sie die ID in der Talkable-Aktion Email opt-in in das Feld Subscription group identifier ein.

Talkable nimmt jedes Opt-in als abonniert in diese Abo-Gruppe auf und beschränkt Empfehlungs-Opt-ins auf diese Gruppe anstatt auf ein globales Abo. Talkable fügt nur Abos hinzu; es entfernt sie niemals.

Angepasste Attribute senden

Fügen Sie im Payload-Editor der Aktion ein beliebiges Schlüssel-Wert-Paar hinzu. Der eingegebene Schlüssel wird zum Attributnamen im Braze-Nutzerprofil.

Werte werden als Liquid-Templates verarbeitet. Die folgenden Variablen stehen zur Verfügung:

Variable Inhalt
{{ person }} Die Fürsprecherin bzw. der Fürsprecher oder die eingeladene Person, die sich angemeldet hat (email, first_name, last_name, phone_number, username, is_advocate, custom_properties und mehr).
{{ ip }} Die IP-Adresse, von der aus das Opt-in erfolgte.
{{ campaign }} Die zugehörige Talkable-Campaign (name, type, tag_names und mehr).

Beispiel: Fügen Sie talkable_is_advocate = {{ person.is_advocate }} und talkable_campaign_name = {{ campaign.name }} hinzu, um in Braze nach Empfehlungskontext zu segmentieren.

Nutzer:innen mit Braze-Nutzer-Aliasen identifizieren

Fügen Sie im Payload-Editor user_alias.alias_name (zum Beispiel {{ person.username }}) und user_alias.alias_label (zum Beispiel username) hinzu. Weitere Informationen finden Sie unter Nutzer-Alias-Objekt.

Wenn beide Felder vorhanden sind, identifiziert das System die Nutzerin bzw. den Nutzer zusätzlich zur E-Mail über den Alias, und Braze erstellt ein neues Alias-Profil, falls keine Übereinstimmung gefunden wird.

Nutzer:innen in Braze finden und erstellen

  • Standardmäßig gleicht Braze das Profil anhand der E-Mail-Adresse ab. Wenn kein übereinstimmendes Profil vorhanden ist, erstellt Braze ein neues.
  • Wenn ein Nutzer-Alias konfiguriert ist, gleicht Braze auch anhand dieses Alias ab und erstellt ein neues Alias-Profil, falls keine Übereinstimmung gefunden wird.
  • Externe IDs werden von dieser Integration nicht verwendet. Um Talkable-Opt-ins an ein bestehendes, extern identifiziertes Profil anzuhängen, konfigurieren Sie einen Nutzer-Alias, dessen Alias-Label mit dem bekannten Alias dieses Profils übereinstimmt.

Talkable mit Braze verwenden

Synchronisierte:n Nutzer:in finden

Gehen Sie zu Audience > Nutzersuche und suchen Sie nach E-Mail, um ein von Talkable erstelltes oder aktualisiertes Profil anzuzeigen.

Standardfelder (E-Mail, Telefon, Vorname oder Nachname) und alle von Ihnen konfigurierten angepassten Attribute werden im Profil angezeigt; Email Subscribe zeigt Opted In an.

Ein Empfehlungssegment erstellen

  1. Erstellen Sie ein Segment, das nach Email Subscribe ist Opted In gefiltert ist.
  2. Verfeinern Sie es mit den angepassten Attributen, die Talkable sendet – zum Beispiel talkable_is_advocate gleich true, um Fürsprecher:innen anzusprechen, oder talkable_campaign_name gleich Ihrer Campaign, um ein bestimmtes Empfehlungsprogramm anzusprechen.

Lifecycle-Messaging triggern

  1. Erstellen Sie einen Canvas oder eine Campaign mit aktionsbasierter Zustellung. Die folgenden Braze-Trigger-Typen funktionieren mit dieser Integration:
    • Update Subscription Status (zum Beispiel, wenn das E-Mail-Abo zu Opted In wird)
    • Update Subscription Group Status (wenn eine Abo-Gruppe konfiguriert ist)
    • Change Custom Attribute Value (für jedes angepasste Talkable-Attribut, das Sie senden).
  2. Personalisieren Sie Nachrichten mit den angepassten Talkable-Attributen im Profil (Campaign-Name, Belohnungswert, Empfehlende:r usw.).

Überlegungen

  • Nur E-Mail-Opt-in: Telefonnummern werden als Standard-Nutzerattribut erfasst, aber die Integration setzt keinen SMS-Abo-Status. Talkable synchronisiert keine SMS-Opt-ins.
  • Telefonnummernformat: Braze erwartet Telefonnummern im internationalen Format (E.164).
  • Realtime-Synchronisierung, ereignisgesteuert: Talkable sendet eine Anfrage pro Opt-in-Ereignis (eine Nutzer:in pro Anfrage). Es gibt kein Batching und keine periodische Vollsynchronisierung; das Volumen entspricht Ihrem Empfehlungs-Opt-in-Volumen.
  • Zuverlässige Zustellung: Wenn Braze vorübergehend einen Fehler zurückgibt, wiederholt Talkable den Versuch automatisch. Bei persistenten Fehlern wird eine E-Mail-Benachrichtigung an die Administrator:in der Website gesendet.

Fehlerbehebung

Fehler Wahrscheinliche Ursache Lösung
401 Unauthorized Dem REST-API-Schlüssel fehlen die users.track-Berechtigungen, oder der Endpunkt verweist auf den falschen Cluster. Erstellen Sie den Schlüssel mit den users.track-Berechtigungen neu und bestätigen Sie, dass der REST-Endpunkt mit Ihrem Braze-Cluster übereinstimmt.
REST-Endpunkt wird bei der Installation abgelehnt Die URL ist kein Braze-REST-Endpunkt. Verwenden Sie den REST-Endpunkt Ihres Clusters, zum Beispiel https://rest.iad-01.braze.com. Eine Dashboard-URL funktioniert nicht.
Profil erstellt, aber nicht in einer Abo-Gruppe Keine Abo-Gruppen-ID konfiguriert. Geben Sie die Abo-Gruppen-ID in der Aktion Email opt-in ein.
Nutzer-Alias wird nicht angewendet Nur eines der beiden Alias-Felder (Name oder Label) ist ausgefüllt. Geben Sie beide Felder in der Aktion ein: Alias-Name und Alias-Label.
Profil wird nicht angezeigt Die Beispielanfrage wurde noch nicht gesendet, oder die Aktion ist deaktiviert. Wählen Sie Send sample payload in Talkable aus und stellen Sie sicher, dass die Aktion Email opt-in aktiviert ist.
Anfragen werden nach einer Schlüsselrotation nicht mehr gesendet Der gespeicherte API-Schlüssel wurde in Braze widerrufen oder ersetzt. Öffnen Sie im Talkable App Store die Braze-App, fügen Sie den neuen REST-API-Schlüssel ein und wählen Sie Save aus. Testen Sie anschließend erneut mit Send sample payload.

Weitere Informationen zur Talkable-Integration finden Sie in der Talkable-Braze-Integrationsdokumentation. Um den Talkable-Support zu kontaktieren, senden Sie eine E-Mail an [email protected].

New Stuff!