Eine Webhook-Kampagne erstellen

Durch das Erstellen einer Webhook-Kampagne oder das Einbinden eines Webhooks in eine Multichannel-Kampagne können Sie Nicht-App-Aktionen auslösen, indem Sie anderen Systemen und Anwendungen Echtzeitinformationen bereitstellen.

Sie können Webhooks verwenden, um Informationen an Systeme wie Salesforce oder Marketo oder an Ihre Backend-Systeme zu senden. Beispielsweise möchten Sie möglicherweise die Konten Ihrer Kund:innen mit einer Aktion gutschreiben, nachdem sie ein angepasstes Event eine bestimmte Anzahl von Malen ausgeführt haben.

Tipp

Um mehr darüber zu erfahren, was Webhooks sind und wie Sie sie in Braze verwenden können, lesen Sie Webhooks, bevor Sie fortfahren.

1. Schritt: Wählen Sie, wo Sie Ihre Nachricht erstellen möchten

Sind Sie unsicher, ob Ihre Nachricht über eine Campaign oder ein Canvas gesendet werden sollte? Campaigns eignen sich besser für einzelne, gezielte Messaging-Kampagnen, während Canvases besser für mehrstufige User-Journeys geeignet sind.

• campaign
• canvas

Schritte:

1. Gehen Sie zu Messaging > Campaigns und wählen Sie Kampagne erstellen.
2. Wählen Sie Webhook oder, für Campaigns, die auf mehrere Kanäle abzielen, Multichannel.
3. Geben Sie Ihrer Campaign einen klaren und aussagekräftigen Namen.
4. (Optional) Fügen Sie eine Beschreibung hinzu, um zu erläutern, wie diese Campaign verwendet wird.
5. Fügen Sie nach Bedarf Teams und Tags hinzu.
   • Tags erleichtern das Auffinden Ihrer Campaigns und das Erstellen von Berichten. Wenn Sie beispielsweise den Berichts-Builder verwenden, können Sie nach bestimmten Tags filtern.
6. Fügen Sie so viele Varianten hinzu und benennen Sie sie, wie Sie für Ihre Campaign benötigen. Sie können für jede Ihrer hinzugefügten Varianten unterschiedliche Webhook-Templates auswählen. Weitere Informationen zu diesem Thema finden Sie unter Multivariate und A/B-Tests.

Tipp

Wenn alle Nachrichten in Ihrer Campaign ähnlich sein oder denselben Inhalt haben werden, verfassen Sie Ihre Nachricht, bevor Sie zusätzliche Varianten hinzufügen. Anschließend können Sie im Dropdown Variante hinzufügen die Option Von Variante kopieren auswählen.

Schritte:

1. Erstellen Sie Ihr Canvas mit dem Canvas-Composer.
2. Nachdem Sie Ihr Canvas eingerichtet haben, fügen Sie im Canvas-Builder einen Schritt hinzu. Geben Sie Ihrem Schritt einen klaren und aussagekräftigen Namen.
3. Wählen Sie einen Schritt-Zeitplan und legen Sie bei Bedarf eine Verzögerung fest.
4. Filtern Sie die Zielgruppe für diesen Schritt nach Bedarf. Sie können die Empfänger:innen dieses Schritts weiter eingrenzen, indem Sie Segmente angeben und zusätzliche Filter hinzufügen. Die Zielgruppenoptionen werden nach der Verzögerung zum Zeitpunkt des Nachrichtenversands überprüft.
5. Wählen Sie Ihr Fortschrittsverhalten.
6. Wählen Sie alle anderen Messaging-Kanäle aus, die Sie mit Ihrer Nachricht kombinieren möchten.

2. Schritt: Erstellen Sie Ihren Webhook

Sie können einen Webhook von Grund auf neu erstellen, ein vorhandenes Template verwenden oder eines unserer bestehenden Templates nutzen. Erstellen Sie dann Ihren Webhook im Tab Verfassen des Editors.

Der Tab Verfassen besteht aus den folgenden Feldern:

• Sprache
• Webhook-URL
• HTTP-Methode
• Anfrage-Body

Sprache

Internationalisierung wird in der URL und im Anfrage-Body unterstützt. Um Ihre Nachricht zu internationalisieren, wählen Sie Sprachen hinzufügen und füllen Sie die erforderlichen Felder aus.

Wir empfehlen, Ihre Sprachen auszuwählen, bevor Sie Ihren Inhalt verfassen, damit Sie Ihren Text an der richtigen Stelle im Liquid einfügen können. Eine vollständige Liste der verfügbaren Sprachen finden Sie unter Unterstützte Sprachen.

Wenn Sie Text in einer Sprache hinzufügen, die von rechts nach links geschrieben wird, beachten Sie, dass das endgültige Erscheinungsbild von Rechts-nach-links-Nachrichten weitgehend davon abhängt, wie Dienstanbieter sie darstellen. Best Practices für die Erstellung von Rechts-nach-links-Nachrichten, die so genau wie möglich angezeigt werden, finden Sie unter Rechts-nach-links-Nachrichten erstellen.

Webhook-URL

Die Webhook-URL oder HTTP-URL gibt Ihren Endpunkt an. Der Endpunkt ist der Ort, an den Sie die Informationen senden, die Sie im Webhook erfassen.

Wenn Sie Informationen an einen Anbieter senden möchten, sollte der Anbieter diese URL in seiner API-Dokumentation bereitstellen. Wenn Sie Informationen an Ihre eigenen Systeme senden, wenden Sie sich an Ihr Entwicklerteam, um sicherzustellen, dass Sie die richtige URL verwenden.

Braze erlaubt nur URLs, die über die Standardports 80 (HTTP) und 443 (HTTPS) kommunizieren.

Liquid verwenden

Sie können Ihre Webhook-URLs mit Liquid personalisieren. Manchmal erfordern bestimmte Endpunkte, dass Sie eine:n Nutzer:in identifizieren oder nutzerspezifische Informationen als Teil Ihrer URL angeben. Wenn Sie Liquid verwenden, stellen Sie sicher, dass Sie für jede nutzerspezifische Information, die Sie in Ihrer URL verwenden, einen Standardwert angeben.

HTTP-Methode

Die HTTP-Methode, die Sie verwenden sollten, variiert je nach Endpunkt, an den Sie Informationen senden. In den meisten Fällen verwenden Sie POST.

Anfrage-Body

Der Anfrage-Body enthält die Informationen, die an die von Ihnen angegebene URL gesendet werden. Sie können den Body Ihrer Webhook-Anfrage mit JSON-Schlüssel-Wert-Paaren oder Rohtext erstellen.

JSON-Schlüssel-Wert-Paare

JSON-Schlüssel-Wert-Paare ermöglichen es Ihnen, einfach eine Anfrage für einen Endpunkt zu schreiben, der ein JSON-Format erwartet. Sie können dies nur mit einem Endpunkt verwenden, der eine JSON-Anfrage erwartet. Wenn Ihr Schlüssel beispielsweise message_body ist, könnte der entsprechende Wert Your order just arrived! lauten. Nachdem Sie Ihr Schlüssel-Wert-Paar eingegeben haben, konfiguriert der Composer Ihre Anfrage in JSON-Syntax, und eine Vorschau Ihrer JSON-Anfrage wird automatisch angezeigt.

Sie können Ihre Schlüssel-Wert-Paare mit Liquid personalisieren, z. B. indem Sie beliebige Nutzerattribute, angepasste Attribute oder Event-Eigenschaften in Ihre Anfrage aufnehmen. Beispielsweise können Sie den Vornamen und die E-Mail-Adresse einer Kundin oder eines Kunden in Ihre Anfrage aufnehmen. Stellen Sie sicher, dass Sie für jedes Attribut einen Standardwert angeben.

Rohtext

Die Rohtext-Option bietet Ihnen die Flexibilität, eine Anfrage für einen Endpunkt zu schreiben, der einen Body in beliebigem Format erwartet. Beispielsweise können Sie dies verwenden, um eine Anfrage für einen Endpunkt zu schreiben, der erwartet, dass Ihre Anfrage im XML-Format vorliegt.

Sowohl Personalisierung als auch Internationalisierung mit Liquid werden im Rohtext unterstützt.

Wenn Sie den Content-Type-Anfrage-Header auf application/x-www-form-url-encoded setzen, muss der Anfrage-Body als URL-codierter String formatiert sein. Zum Beispiel:

1
to={{custom_attribute.${example}}}&text=Your+order+just+arrived

3. Schritt: Zusätzliche Einstellungen konfigurieren

Anfrage-Header (optional)

Bestimmte Endpunkte erfordern möglicherweise, dass Sie Header in Ihre Anfrage aufnehmen. Im Abschnitt Verfassen des Composers können Sie so viele Header hinzufügen, wie benötigt.

Gängige Anfrage-Header sind Content-Type-Spezifikationen (die beschreiben, welche Art von Daten im Body erwartet werden, z. B. XML oder JSON) und Autorisierungs-Header, die Ihre Zugangsdaten bei Ihrem Anbieter oder System enthalten.

Content-Type-Spezifikationen müssen den Schlüssel Content-Type verwenden. Gängige Werte sind application/json oder application/x-www-form-urlencoded.

Autorisierungs-Header müssen den Schlüssel Authorization verwenden. Gängige Werte sind Bearer {{YOUR_TOKEN}} oder Basic {{YOUR_TOKEN}} , wobei YOUR_TOKEN die von Ihrem Anbieter oder System bereitgestellten Zugangsdaten sind.

4. Schritt: Testnachricht senden

Bevor Sie Ihre Campaign live schalten, empfiehlt Braze, den Webhook zu testen, um sicherzustellen, dass die Anfrage korrekt formatiert ist.

Wechseln Sie dazu zum Tab Test und senden Sie einen Test-Webhook. Sie können den Webhook als zufällige:n Nutzer:in, als bestimmte:n Nutzer:in (durch Eingabe der E-Mail-Adresse oder externen Nutzer-ID) oder als angepasste:n Nutzer:in mit Attributen Ihrer Wahl testen.

Nach dem Senden des Test-Webhooks erscheint ein Dialog mit der Antwortnachricht. Wenn die Webhook-Anfrage nicht erfolgreich ist, lesen Sie die Fehlermeldung zur Unterstützung bei der Fehlerbehebung Ihres Webhooks. Das folgende Beispiel zeigt die Antwort eines Webhooks mit einer ungültigen Webhook-URL.

1
2
3
4
5
6
7
8
9
404 Not Found

{
  "error": {
    "message": "Unrecognized request URL. Please see https://lob.com/docs or email us at [email protected].",
    "status_code": 404
  }
}

Weitere Informationen finden Sie unter Testnachrichten senden.

5. Schritt: Erstellen Sie den Rest Ihrer Campaign oder Ihres Canvas

• campaign
• canvas

Erstellen Sie als Nächstes den Rest Ihrer Campaign. In den folgenden Abschnitten finden Sie weitere Details zur optimalen Nutzung unserer Tools zum Erstellen von Webhooks.

Zustellungszeitplan oder Trigger wählen

Webhooks können basierend auf einem geplanten Zeitpunkt, einer Aktion oder einem API-Trigger zugestellt werden. Weitere Informationen finden Sie unter Ihre Campaign planen.

Für aktionsbasierte Zustellung können Sie auch die Dauer der Campaign und die Ruhezeiten festlegen.

In diesem Schritt können Sie auch Zustellungs-Kontrollgruppen festlegen, z. B. ob Nutzer:innen erneut berechtigt werden können, die Campaign zu erhalten, oder Frequency-Capping-Regeln aktivieren.

Zielgruppe zusammenstellen

Als Nächstes müssen Sie Nutzer:innen als Zielgruppe auswählen, indem Sie Segmente oder Filter wählen, um Ihre Zielgruppe einzugrenzen. In diesem Schritt wählen Sie die größere Zielgruppe aus Ihren Segmenten aus und grenzen dieses Segment bei Bedarf mit unseren Filtern weiter ein. Sie erhalten automatisch eine Vorschau der ungefähren Segmentgröße. Beachten Sie, dass die genaue Segment-Zugehörigkeit immer direkt vor dem Nachrichtenversand berechnet wird.

Wichtig

Ihre Nachricht wird ausschließlich an Nutzer:innen gesendet, die bereits die Bedingungen erfüllen, die Sie im Schritt „Zielgruppe“ festgelegt haben. Anschließend müssen sie noch die Bedingungen erfüllen, die Sie im Schritt „Zeitplan für die Zustellung“ festgelegt haben. Stellen Sie sich die Zielgruppe als einen Warteraum vor – nur Personen, die sich bereits darin befinden, können voranschreiten, wenn die nächste Aktion erfolgt.

Konversions-Events wählen

Braze ermöglicht es Ihnen zu verfolgen, wie oft Nutzer:innen bestimmte Aktionen, sogenannte Konversions-Events, nach Erhalt einer Campaign ausführen. Sie haben die Möglichkeit, ein Zeitfenster von bis zu 30 Tagen festzulegen, in dem eine Conversion gezählt wird, wenn die Nutzerin oder der Nutzer die angegebene Aktion ausführt.

Falls noch nicht geschehen, vervollständigen Sie die verbleibenden Abschnitte Ihres Canvas-Schritts. Weitere Details zum Aufbau des restlichen Canvas, zur Implementierung von multivariaten Tests und intelligenter Auswahl und mehr finden Sie im Schritt Canvas erstellen unserer Canvas-Dokumentation.

6. Schritt: Überprüfen und bereitstellen

Nachdem Sie den letzten Teil Ihrer Campaign oder Ihres Canvas fertiggestellt haben, überprüfen Sie die Details, testen Sie sie und senden Sie sie ab!

Wissenswertes

Fehler, Wiederholungslogik und Timeouts

Webhooks basieren darauf, dass Braze-Server Anfragen an einen externen Endpunkt senden, und gelegentlich können Fehler auftreten. Die häufigsten Fehler sind Syntaxfehler, abgelaufene API-Schlüssel, Rate-Limits und unerwartete serverseitige Probleme. Bevor Sie eine Webhook-Kampagne senden:

• Testen Sie Ihren Webhook auf Syntaxfehler
• Stellen Sie sicher, dass personalisierte Variablen Standardwerte haben

Wenn Ihr Webhook nicht gesendet werden kann, wird eine Fehlermeldung im Nachrichten-Aktivitätsprotokoll protokolliert, einschließlich Details wie dem Fehlerzeitstempel, dem App-Namen und Details zum Fehler.

Wenn die Fehlermeldung nicht ausreichend Aufschluss über die Fehlerursache gibt, sollten Sie die Dokumentation des von Ihnen verwendeten API-Endpunkts prüfen. Diese enthält in der Regel eine Erklärung der Fehlercodes, die der Endpunkt verwendet, sowie deren typische Ursachen.

Antwortcodes und Wiederholungslogik

Wenn die Webhook-Anfrage gesendet wird, gibt der empfangende Server einen Antwortcode zurück, der angibt, was mit der Anfrage passiert ist. Die folgende Tabelle fasst die verschiedenen Antworten zusammen, die der Server senden kann, wie sie sich auf die Campaign-Analytics auswirken und ob Braze im Fehlerfall versucht, die Campaign erneut zuzustellen:

Hinweis

Braze wiederholt die oben genannten Statuscodes bis zu fünfmal innerhalb von 30 Minuten mit exponentiellem Backoff. Wenn wir Ihren Endpunkt nicht erreichen können, können sich die Wiederholungen über einen Zeitraum von 24 Stunden erstrecken.

Jeder Webhook hat ein Timeout von 90 Sekunden.

Retry-After- und Rate-Limit-Antwort-Header können beeinflussen, wie lange Braze vor einem wiederholbaren Versuch wartet (z. B. nach 408, 429 oder 5XX). Sie machen nicht-wiederholbare Antworten wie 401 nicht für eine Wiederholung berechtigt.

Authentifizierung und Connected-Content-Zugangsdaten

Die ausgehende Webhook-HTTP-Anfrage unterstützt nicht das Anhängen von Connected-Content-Zugangsdaten (:basic_auth oder :auth_credentials) zur Authentifizierung gegenüber Ihrem Endpunkt. Legen Sie die Authentifizierung stattdessen über Anfrage-Header im Webhook fest. Um ein Token oder Secret zum Sendezeitpunkt abzurufen, können Sie ein {% connected_content %}-Tag in einem Header- oder Body-Feld platzieren, damit Liquid es auflöst, bevor der Webhook gesendet wird.

Gespeicherte Webhook-Templates und Campaign-Nutzung

Braze bietet keinen integrierten Bericht, der jede Campaign oder jeden Canvas-Schritt auflistet, der auf ein bestimmtes gespeichertes Webhook-Template verweist. Um die Nutzung zu überprüfen, prüfen Sie Webhook-Schritte, die dieselbe URL und HTTP-Methode verwenden, oder kontaktieren Sie den Braze-Support.

Fehlerbehebung und zusätzliche Fehlerdetails

Ausführliche Erklärungen, Schritte zur Fehlerbehebung und Anleitungen zur Behebung spezifischer Webhook-Fehler finden Sie unter Fehlerbehebung bei Webhook- und Connected-Content-Anfragen. Dort finden Sie auch weitere Erklärungen zur Funktionsweise unseres Systems zur Erkennung fehlerhafter Hosts und wie Braze Fehlerbenachrichtigungen über automatisierte E-Mails und zusätzliche Protokollierung in Braze-Currents bereitstellt.

IP-Allowlisting

Wenn ein Webhook von Braze gesendet wird, stellen die Braze-Server Netzwerkanfragen an Kunden- oder Drittanbieter-Server. Mit IP-Allowlisting können Sie überprüfen, ob Webhook-Anfragen von Braze stammen, und so eine zusätzliche Sicherheitsebene hinzufügen.

Braze sendet Webhooks von den folgenden IPs. Die aufgelisteten IPs werden automatisch und dynamisch zu allen API-Schlüsseln hinzugefügt, die für das Allowlisting aktiviert wurden.

Wichtig

Wenn Sie einen Braze-zu-Braze-Webhook erstellen und Allowlisting verwenden, sollten Sie alle folgenden IPs einschließlich 127.0.0.1 auf die Allowlist setzen.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)

Nutzer:innen löschen

Um einzelne Nutzer:innen oder ein Segment von Nutzer:innen zu löschen, gehen Sie zu Zielgruppe > Zielgruppe verwalten > Nutzer:innen löschen. Das Dashboard unterstützt die massenhafte Löschung von Segmenten (bis zu 10 Millionen Profile), bietet ein 7-tägiges Stornierungsfenster und verbraucht keine gemeinsamen REST-API-Rate-Limits. Schritte, Limits und Berechtigungen finden Sie unter Nutzer:innen löschen.

Für die programmatische Löschung in kleineren Batches verwenden Sie stattdessen den /users/delete-Endpunkt anstelle einer Webhook-Kampagne.