DokumentationExperience PlatformTags

Braze Track Events API-Erweiterung zur Ereignisweiterleitung

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Braze ist eine Plattform zur Kundeninteraktion, die kundenorientierte Interaktionen zwischen Verbrauchern und Marken in Echtzeit ermöglicht. Mit Braze können Sie Folgendes tun:

  • Liefern Sie Daten (z. B. Marketing-Nachrichten) an ausgewählte Benutzer basierend auf deren Sprachpräferenz, Standortpräferenz und mehr, um die Konversionsraten zu erhöhen und wichtige Geschäftsziele zu unterstützen.
  • Senden Sie Kundinnen und Kunden personalisierte Nachrichten über mehrere Kanäle hinweg, einschließlich E-Mail, Push-Benachrichtigungen und In-App-Nachrichten, zur richtigen Zeit und in den bevorzugten Sprachen.
  • Targeting spezifischer Benutzer für Marketing- und Werbekampagnen, um die Anzahl der Bestandskunden zu erhöhen.
  • Untersuchen Sie das Benutzerverhalten und die Muster, um bestimmte Zielgruppen mit benutzerdefinierten Nachrichten anzusprechen, was zu einer Umsatzsteigerung beitragen könnte.

Mit Erweiterung Braze Track Events APIEreignisweiterleitung können Sie die im Adobe Experience Platform-Edge Network erfassten Daten nutzen und in Form von Server-seitigen Ereignissen mithilfe der Braze User Track-API an Braze senden.

In diesem Dokument werden die Anwendungsfälle der Erweiterung behandelt und beschrieben, wie Sie sie in Ihren Bibliotheken für die Ereignisweiterleitung installieren und wie Sie ihre Funktionen in einer Regel für die verwenden.

Anwendungsfälle

Diese Erweiterung sollte verwendet werden, wenn Sie Daten aus dem Edge Network verwenden möchten, Braze die Analyse- und Targeting-Funktionen von Customer Journey Analytics zu nutzen.

Nehmen wir zum Beispiel ein Einzelhandelsunternehmen mit einer kanalübergreifenden Präsenz (Website und Mobilgerät), das Transaktions- oder Konversationseingaben als Ereignisdaten von seiner Website und seinen mobilen Plattformen erfasst. Mithilfe verschiedener Tag-Regeln werden diese Daten in Echtzeit an das Edge Network gesendet. Von hier aus sendet die Braze-Erweiterung für die Ereignisweiterleitung automatisch relevante Ereignisse von der Server-Seite an Braze.

Nach dem Versand der Daten können die Analyse-Teams des Unternehmens dann Braze’s Funktionen nutzen, um die Datensätze zu verarbeiten und geschäftliche Einblicke abzuleiten, um Diagramme, Dashboards oder andere Visualisierungen zu generieren, um geschäftliche Stakeholder zu informieren. Weitere Informationen zu den verschiedenen Anwendungsfällen Braze Plattform findenauf der Seite „Kunden“.

Braze Voraussetzungen und Leitlinien prerequisites

Sie müssen über ein Braze-Konto verfügen, um seine Technologien verwenden zu können. Wenn Sie noch kein Konto haben, navigieren Sie zur Seite Erste Schritte auf Braze, um eine Verbindung zu Braze Sales herzustellen und mit der Kontoerstellung zu beginnen.

API-Leitplanken

Die Erweiterung verwendet zwei APIs von Braze und ihre Einschränkungen sind unten beschrieben:

API
Ratenbeschränkungen
User Track
50.000 Anfragen pro Minute.
Informationen finden Sie in der User Track APIDokumentation.
User Identify
20.000 Anfragen pro Minute.
Informationen finden Sie in der User Identify APIDokumentation.
NOTE
Siehe das Handbuch zu Braze API-Beschränkungen für weitere Informationen zu den Beschränkungen, die sie vorschreiben.

Fakturierbare Datenpunkte

Das Senden zusätzlicher benutzerdefinierter Attribute an Braze kann die Nutzung Ihrer Braze-Datenpunkte erhöhen. Wenden Sie sich an Ihren Braze Account Manager, bevor Sie zusätzliche benutzerdefinierte Attribute senden. Weitere Informationen finden Sie in der Braze Dokumentation Abrechnungsfähige).

Sammeln erforderlicher Konfigurationsdetails configuration-details

Um das Edge Network an Braze anzuschließen, sind folgende Eingaben erforderlich:

Schlüsseltyp
Beschreibung
Beispiel
Instanz Braze
Der mit dem Braze-Konto verknüpfte REST-Endpunkt. Eine Anleitung finden Sie in der Braze Dokumentation Instanzen .
https://rest.iad-03.braze.com
API-Schlüssel
Der mit dem Braze-Konto verknüpfte Braze-API-Schlüssel.
Anleitungen finden Sie in der Braze-Dokumentation zum REST-APISchlüssel.
YOUR-BRAZE-REST-API-KEY

Erstellen geheimer Daten

Erstellen Sie ein neues Geheimnis für die Ereignisweiterleitung und legen Sie den Wert auf Ihren Braze -API-Schlüssel. Dies wird verwendet, um die Verbindung zu Ihrem Konto zu authentifizieren und dabei den Wert sicher zu halten.

Installieren und Konfigurieren der Braze install

Um die Erweiterung zu installieren erstellen Sie eine Ereignisweiterleitungseigenschaft oderSie stattdessen eine vorhandene Eigenschaft aus, die bearbeitet werden soll.

Wählen Sie Erweiterungen in der linken Navigation aus. Wählen Sie auf der Katalog-Registerkarte Installieren auf der Karte für die Braze aus.

Installieren der Braze-Erweiterung.

Geben Sie im nächsten Bildschirm die folgenden Konfigurationswerte ein, die Sie zuvor aus Braze erfasst haben:

  • Braze-REST-Endpunkt URL: Sie können den Wert Ihrer Braze-REST-Endpunkt-URL als Nur-Text in die bereitgestellte Eingabe eingeben.
  • API-Schlüssel: Wählen Sie das zuvor erstellte GeheimeDatenelement aus, das Ihren Braze API-Schlüssel enthält.

Wählen Sie Speichern, wenn Sie fertig sind.

Die Konfigurationsseite der Braze-Erweiterung.

Erstellen einer Send Event Regel tracking-rule

Erstellen Sie nach der Installation der Erweiterung eine neue Ereignisweiterleitungsregel Regel und konfigurieren Sie deren Bedingungen nach Bedarf. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Braze-Erweiterung aus und wählen Sie dann Ereignis senden für den Aktionstyp aus.

Fügen Sie eine Regelaktionskonfiguration für die Ereignisweiterleitung hinzu.

Benutzeridentifizierung

Eingabe
Beschreibung
Externe Benutzer-ID
Lange, zufällige und gut verteilte UUID oder GUID. Wenn Sie eine andere Methode zur Benennung Ihrer Benutzer-IDs auswählen, müssen diese auch lang, zufällig und gut verteilt sein. Weitere Informationen zur vorgeschlagenen Benennungskonvention für Benutzer-IDs.
Braze Benutzer-ID
Braze-Benutzerkennung.
Benutzeralias
Ein Alias dient als alternative eindeutige Benutzerkennung. Verwenden Sie Aliase, um Benutzende über andere Dimensionen als Ihre Hauptbenutzer-ID zu identifizieren.

Das Alias-Objekt des Benutzers besteht aus zwei Teilen: einem alias_name für den Bezeichner selbst und einem alias_label, das den Alias-Typ angibt. Benutzer können mehrere Aliase mit unterschiedlichen Kennzeichnungen haben, aber nur einen Alias_Namen pro Alias_Label.
NOTE
Um das Ereignis an einen Benutzer zu binden, müssen Sie entweder das Feld Externe Benutzer-ID oder das Feld Braze-) oder den Abschnitt Benutzeralias ausfüllen.

Ereignisdaten

Eingabe
Beschreibung
Erforderlich
Ereignisname ​
Name des Ereignisses.
Ja
Ereigniszeit
Datum-Uhrzeit als Zeichenfolge in ISO 8601 oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Ja
App-Kennung
Die App-Kennung oder app_id ist ein Parameter, der die Aktivität einer bestimmten App in Ihrer App-Gruppe zuordnet. Es gibt an, mit welcher App innerhalb der App-Gruppe Sie interagieren. Weitere Informationen zu den API-Kennungstypen.
Ereigniseigenschaften ​
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Ereignisses.
NOTE
Für Aktion " senden“ müssen nur ein Ereignisname und Ereigniszeit angegeben werden. Sie sollten jedoch so viele Informationen wie möglich in das Feld für benutzerdefinierte Eigenschaften aufnehmen. Einzelheiten zum Braze Ereignisobjekt finden Sie in der offiziellen Dokumentation.

Benutzerattribute

Benutzerattribute können ein JSON-Objekt sein, das Felder enthält, mit denen ein Attribut mit dem angegebenen Namen und Wert im angegebenen Benutzerprofil erstellt oder aktualisiert wird. Die folgenden Eigenschaften werden unterstützt:

Benutzerattribut
Beschreibung
Vorname
Nachname
Phone
E-Mail
Geschlecht
Eine der folgenden Zeichenketten: „M“, „F“, „O“ (andere), „N“ (nicht zutreffend), „P“ (bitte nicht sagen).
Stadt
Country
Land als Zeichenfolge im ISO-3166-1 alpha-2-Format.
Sprache
Sprache als Zeichenfolge im ISO-639-1Format.
Geburtsdatum
Zeichenfolge im Format „JJJJ-MM-TT“ (z. B. 1980-12-21).
Zeitzone
Name der Zeitzone aus IANA-Zeitzonendatenbank (z. B. 'America/New_York' oder 'Eastern Time (US & Kanada)').
Facebook
Hash, der einen der Werte id (Zeichenfolge), likes (Zeichenfolgen-Array), num_friends (Ganzzahl) enthält.
Twitter
Hash, der einen der Werte id (Ganzzahl), screen_name (Zeichenfolge, Twitter-Handle), followers_count (Ganzzahl), friends_count (Ganzzahl), statuses_count (Ganzzahl) enthält.

Erstellen einer Send Purchase Event Regel purchase-rule

Erstellen Sie nach der Installation der Erweiterung eine neue Ereignisweiterleitungsregel Regel und konfigurieren Sie deren Bedingungen nach Bedarf. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Braze-Erweiterung aus und wählen Sie dann Kaufereignis senden für den Aktionstyp aus.

Fügen Sie eine Aktionskonfiguration für die Ereignisweiterleitungsregel vom Typ „Braze-Kauf“ hinzu.

Benutzeridentifizierung

Eingabe
Beschreibung
Externe Benutzer-ID
Lange, zufällige und gut verteilte UUID oder GUID. Wenn Sie eine andere Methode zur Benennung Ihrer Benutzer-IDs auswählen, müssen diese auch lang, zufällig und gut verteilt sein. Weitere Informationen zur vorgeschlagenen Benennungskonvention für Benutzer-IDs.
Braze Benutzer-ID
Braze-Benutzerkennung.
Benutzeralias
Ein Alias dient als alternative eindeutige Benutzerkennung. Verwenden Sie Aliase, um Benutzende über andere Dimensionen als Ihre Hauptbenutzer-ID zu identifizieren.

Das Alias-Objekt des Benutzers besteht aus zwei Teilen: einem alias_name für den Bezeichner selbst und einem alias_label, das den Alias-Typ angibt. Benutzer können mehrere Aliase mit unterschiedlichen Kennzeichnungen haben, aber nur einen Alias_Namen pro Alias_Label.
NOTE
Um das Ereignis mit einem Benutzer zu verknüpfen, müssen Sie entweder das Feld Externe Benutzer-ID, das Feld Braze-Benutzerkennung oder den Abschnitt Benutzeralias ausfüllen.

Kaufdaten

Eingabe
Beschreibung
Erforderlich
Produkt-ID ​
Kennung für den Kauf. (z. B. Produktname oder Produktkategorie)
Ja
Kaufzeit
Datum-Uhrzeit als Zeichenfolge in ISO 8601 oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Ja
​
Währung als Zeichenfolge im ISO 4217 Alphabetisches Währungscodeformat.
Ja
Preis ​
Preis.
Ja
​
Wenn kein Wert angegeben wird, ist der Standardwert 1. Der Höchstwert muss kleiner als 100 sein.
App-Kennung
Die App-Kennung oder app_id ist ein Parameter, der die Aktivität einer bestimmten App in Ihrer App-Gruppe zuordnet. Es gibt an, mit welcher App innerhalb der App-Gruppe Sie interagieren. Weitere Informationen zu den API-Kennungstypen.
Kaufeigenschaften ​
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Kaufs.
NOTE
Für Aktion " senden“ müssen nur ein Ereignisname und Ereigniszeit angegeben werden, Sie sollten jedoch so viele Informationen wie möglich in das Feld für benutzerdefinierte Eigenschaften aufnehmen. Einzelheiten zum Braze Ereignisobjekt finden Sie in der offiziellen Dokumentation.

Benutzerattribute

Benutzerattribute können ein JSON-Objekt sein, das Felder enthält, mit denen ein Attribut mit dem angegebenen Namen und Wert im angegebenen Benutzerprofil erstellt oder aktualisiert wird. Die folgenden Eigenschaften werden unterstützt:

Benutzerattribut
Beschreibung
Vorname
Nachname
Phone
E-Mail
Geschlecht
Eine der folgenden Zeichenketten: „M“, „F“, „O“ (andere), „N“ (nicht zutreffend), „P“ (bitte nicht sagen).
Stadt
Country
Land als Zeichenfolge im ISO-3166-1 alpha-2-Format.
Sprache
Sprache als Zeichenfolge im ISO-639-1Format.
Geburtsdatum
Zeichenfolge im Format „JJJJ-MM-TT“ (z. B. 1980-12-21).
Zeitzone
Name der Zeitzone aus IANA-Zeitzonendatenbank (z. B. 'America/New_York' oder 'Eastern Time (US & Kanada)').
Facebook
Hash, der einen der Werte id (Zeichenfolge), likes (Zeichenfolgen-Array), num_friends (Ganzzahl) enthält.
Twitter
Hash, der einen der Werte id (Ganzzahl), screen_name (Zeichenfolge, Twitter-Handle), followers_count (Ganzzahl), friends_count (Ganzzahl), statuses_count (Ganzzahl) enthält.

Validieren von Daten in Braze validate

Wenn die Ereignissammlung und Adobe Experience Platform Integration erfolgreich waren, werden bei der Anzeige von Benutzerprofilen Ereignisse in der Braze-Konsole angezeigt. Insbesondere die neuen Ereignisdaten, die an Braze gesendet werden, werden im Abschnitt Purchases der Registerkarte Übersicht“ eines bestimmten Benutzers.

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie Konversionsereignisse mithilfe der Ereignisweiterleitung an Braze senden. Weitere Informationen zu nachgelagerten Anwendungen für Ereignisdaten, die an Braze gesendet werden, finden Sie in der offiziellen Dokumentation.

Weitere Informationen zu den Ereignisweiterleitungsfunktionen in Experience Platform finden Sie unter Übersicht über die Ereignisweiterleitung.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743