DokumentationExperience PlatformTags

Braze Track Events API-Erweiterung zur Ereignisweiterleitung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

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

  • Bereitstellen von Daten (z. B. Marketing-Nachrichten) für zielgerichtete Benutzer basierend auf ihrer Sprachpräferenz, Standort-Präferenz und mehr, um Konversionsraten zu erhöhen und wichtige Geschäftsziele zu unterstützen.
  • Senden Sie personalisierte Nachrichten an Kunden über verschiedene Kanäle, einschließlich E-Mail, Push-Benachrichtigungen und In-App-Nachrichten, zum richtigen Zeitpunkt und in ihrer bevorzugten Sprache.
  • Richten Sie bestimmte Benutzer für Marketing- und Werbekampagnen ein, um die Anzahl der wiederkehrenden Kunden zu erhöhen.
  • Untersuchen Sie das Benutzerverhalten und die Muster, um bestimmte Zielgruppen mit personalisierten Nachrichten anzusprechen, was zur Umsatzsteigerung beitragen könnte.

Mit der Erweiterung Braze Track Events API Ereignisweiterleitung können Sie im Adobe Experience Platform-Edge Network erfasste Daten nutzen und in Form von serverseitigen Ereignissen mithilfe der API Braze User Track an Braze senden.

In diesem Dokument werden die Anwendungsfälle der Erweiterung, die Installation in Ihren Ereignisweiterleitungsbibliotheken und die Verwendung ihrer Funktionen in einer Ereignisweiterleitung Regel behandelt.

Anwendungsfälle

Diese Erweiterung sollte verwendet werden, wenn Sie Daten aus dem Edge Network in Braze verwenden möchten, um die Analyse- und Targeting-Funktionen von Kunden nutzen zu können.

Angenommen, ein Einzelhandelsunternehmen verfügt über eine mehrkanalige Präsenz (Website und Mobilgeräte) und erfasst Transaktions- oder Konversionsdaten als Ereignisdaten von seiner Website und mobilen Plattformen. Mithilfe verschiedener Tag -Regeln werden diese Daten in Echtzeit an das Edge Network gesendet. Von hier aus sendet die Ereignisweiterleitungs-Erweiterung Braze automatisch relevante Ereignisse vom Server an Braze.

Nachdem die Daten gesendet wurden, können die Analyseteams des Unternehmens die Braze’s-Funktionen nutzen, um die Datensätze zu verarbeiten und geschäftliche Einblicke zu gewinnen, um Diagramme, Dashboards oder andere Visualisierungen zu generieren, die geschäftliche Stakeholder informieren. Weitere Informationen zu den verschiedenen Anwendungsfällen der Plattform finden Sie auf der Seite Braze Kunden .

Braze Voraussetzungen und Limits prerequisites

Sie müssen über ein Braze -Konto verfügen, um seine Technologien nutzen zu können. Wenn Sie kein Konto haben, navigieren Sie zur Seite Erste Schritte auf Braze, um eine Verbindung zu Braze Sales herzustellen und den Prozess zur Kontoerstellung zu starten.

API-Limits

Die Erweiterung verwendet zwei APIs von Braze und ihre Beschränkungen sind unten dargestellt:

API
Ratenbeschränkungen
User Track
50.000 Anfragen pro Minute. Weitere Informationen finden Sie in der User Track API-Dokumentation .
User Identify
20.000 Anfragen pro Minute. Weitere Informationen finden Sie in der User Identify API-Dokumentation .
NOTE
Weitere Informationen zu den von ihnen auferlegten Beschränkungen finden Sie im Handbuch zu Braze API-Beschränkungen .

Abrechenbare Datenpunkte

Das Senden zusätzlicher benutzerdefinierter Attribute an Braze kann Ihren Braze Datenpunktverbrauch erhöhen. Wenden Sie sich an Ihren Braze -Kundenbetreuer, bevor Sie zusätzliche benutzerdefinierte Attribute senden. Weitere Informationen finden Sie in der Dokumentation zu Braze für abrechnungsfähige Datenpunkte .

Erforderliche Konfigurationsdetails sammeln configuration-details

Um das Edge Network mit Braze zu verbinden, sind die folgenden Eingaben erforderlich:

Schlüsseltyp
Beschreibung
Beispiel
Braze Instanz
Der REST-Endpunkt, der mit dem Braze -Konto verknüpft ist. Eine Anleitung dazu finden Sie in der Dokumentation zu Braze für Instanzen .
https://rest.iad-03.braze.com
API-Schlüssel
Der Braze API-Schlüssel, der mit dem Braze -Konto verknüpft ist. Die Anleitung für
finden Sie in der Braze -Dokumentation zum REST-API-Schlüssel .
YOUR-BRAZE-REST-API-KEY

Erstellen geheimer Daten

Erstellen Sie ein neues Ereignisweiterleitungsgeheimnis und legen Sie den Wert auf Ihren Braze API-Schlüssel fest. Dies wird verwendet, um die Verbindung zu Ihrem Konto zu authentifizieren, während der Wert sicher bleibt.

Installieren und Konfigurieren der Braze -Erweiterung install

Um die Erweiterung zu installieren, erstellen Sie eine Ereignisweiterleitungs-Eigenschaft oder wählen Sie eine vorhandene Eigenschaft aus, die Sie stattdessen bearbeiten möchten.

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

Installieren Sie die Braze -Erweiterung.

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

  • REST-Endpunkt-URL einblenden: 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 geheime Datenelement 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 Ereignisweiterleitung Regel und konfigurieren Sie die Bedingungen entsprechend Ihren Anforderungen. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Erweiterung Braze und dann für den Aktionstyp Ereignis senden aus.

Fügen Sie eine Aktionskonfiguration für die Ereignisweiterleitungsregel hinzu.

Benutzeridentifizierung

Eingabe
Beschreibung
Externe Benutzer-ID
Lang, zufällig und gut verteilt UUID oder GUID. Wenn Sie eine andere Methode wählen, mit der Sie Ihre Benutzer-IDs benennen können, müssen diese auch lang, zufällig und gut verteilt sein. Erfahren Sie mehr über vorgeschlagene Benutzer-ID-Namenskonvention.
Benutzer-ID einblenden
Anzeigen der Benutzer-ID.
Benutzeralias
Ein Alias dient als alternative eindeutige Benutzerkennung. Verwenden Sie Aliase, um Benutzer anhand anderer Dimensionen als Ihrer Benutzer-ID zu identifizieren.

Das Benutzeralias-Objekt besteht aus zwei Teilen: einem alias_name für die Kennung selbst und einem alias_label, das den Aliastyp angibt. Benutzer können über mehrere Alias mit unterschiedlichen Bezeichnungen verfügen, jedoch 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 Benutzer-IDs einblenden oder den Abschnitt Benutzeralias ausfüllen.

Ereignisdaten

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

Benutzerattribute

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

Benutzerattribut
Beschreibung
Vorname
Nachname
Phone
E-Mail
Geschlecht
Eine der folgenden Zeichenfolgen: "M", "F", "O" (sonstiges), "N" (nicht zutreffend), "P" (es empfiehlt sich, nicht zu sagen).
Ort
Country
Land als Zeichenfolge im Format ISO-3166-1 alpha-2 .
Sprache
Sprache als Zeichenfolge im Format ISO-639-1.
Geburtsdatum
Zeichenfolge im Format "JJJ-MM-TT"(z. B. 1980-12-21).
Zeitzone
Zeitzonenname aus der Zeitzonendatenbank IANA (z. B. "America/New_York"oder "Eastern Time (US & Canada)").
Facebook
Hash, der eine beliebige ID (Zeichenfolge), "Gefällt mir"(Array von Zeichenfolgen), "num_friends"(Ganzzahl) enthält.
Twitter
Hash, der ID (Integer), screen_name (Zeichenfolge, Twitter-Handle), followers_count (Integer), friends_count (Integer), statuses_count(Integer) enthält.

Erstellen einer Send Purchase Event -Regel purchase-rule

Erstellen Sie nach der Installation der Erweiterung eine neue Ereignisweiterleitung Regel und konfigurieren Sie die Bedingungen entsprechend Ihren Anforderungen. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Erweiterung Braze und dann für den Aktionstyp Kaufereignis senden aus.

Fügen Sie die Konfiguration der Ereignisweiterleitungsregel für den Aktionstyp Kauf bremsenhinzu.

Benutzeridentifizierung

Eingabe
Beschreibung
Externe Benutzer-ID
Lang, zufällig und gut verteilt UUID oder GUID. Wenn Sie eine andere Methode wählen, mit der Sie Ihre Benutzer-IDs benennen können, müssen diese auch lang, zufällig und gut verteilt sein. Erfahren Sie mehr über vorgeschlagene Benutzer-ID-Namenskonvention.
Benutzer-ID einblenden
Anzeigen der Benutzer-ID.
Benutzeralias
Ein Alias dient als alternative eindeutige Benutzerkennung. Verwenden Sie Aliase, um Benutzer anhand anderer Dimensionen als Ihrer Benutzer-ID zu identifizieren.

Das Benutzeralias-Objekt besteht aus zwei Teilen: einem alias_name für die Kennung selbst und einem alias_label, das den Aliastyp angibt. Benutzer können über mehrere Alias mit unterschiedlichen Bezeichnungen verfügen, jedoch 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 Benutzer-ID einblenden 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 im ISO 8601- oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ-Format.
Ja
​ ​
Währung als Zeichenfolge im Format ISO 4217 Alphabetischer Währungscode.
Ja
Preis ​
Preis.
Ja
Quantity ​
Wenn kein Wert angegeben wird, ist der Standardwert 1. Der Höchstwert muss unter 100 liegen.
App-ID
Die App-ID oder app_id ist ein Parameter, der die Aktivität mit einer bestimmten App in Ihrer App-Gruppe verknüpft. Sie gibt an, mit welcher App innerhalb der App-Gruppe Sie interagieren. Erfahren Sie mehr über die API-Kennungstypen.
Eigenschaften für Kauf ​
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Kaufs.
NOTE
Für die Aktion Ereignis-Versand durchführen müssen nur ein Ereignisname und eine Ereigniszeit angegeben werden. Sie sollten jedoch so viele Informationen wie möglich in das Feld für benutzerdefinierte Eigenschaften aufnehmen. Weitere Informationen zum Braze-Ereignisobjekt finden Sie in der offiziellen Dokumentation.

Benutzerattribute

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

Benutzerattribut
Beschreibung
Vorname
Nachname
Phone
E-Mail
Geschlecht
Eine der folgenden Zeichenfolgen: "M", "F", "O" (sonstiges), "N" (nicht zutreffend), "P" (es empfiehlt sich, nicht zu sagen).
Ort
Country
Land als Zeichenfolge im Format ISO-3166-1 alpha-2 .
Sprache
Sprache als Zeichenfolge im Format ISO-639-1.
Geburtsdatum
Zeichenfolge im Format "JJJ-MM-TT"(z. B. 1980-12-21).
Zeitzone
Zeitzonenname aus der Zeitzonendatenbank IANA (z. B. "America/New_York"oder "Eastern Time (US & Canada)").
Facebook
Hash, der eine beliebige ID (Zeichenfolge), "Gefällt mir"(Array von Zeichenfolgen), "num_friends"(Ganzzahl) enthält.
Twitter
Hash, der ID (Integer), screen_name (Zeichenfolge, Twitter-Handle), followers_count (Integer), friends_count (Integer), statuses_count(Integer) enthält.

Daten mit Braze validieren validate

Wenn die Ereigniserfassung und die Integration von Adobe Experience Platform erfolgreich waren, werden Ereignisse in der Konsole Braze angezeigt, wenn Benutzerprofile anzeigen. Insbesondere spiegeln sich die neuen Ereignisdaten, die an Braze gesendet werden, im Abschnitt Purchases auf der Registerkarte Überblick eines bestimmten Benutzers wider.

Nächste Schritte

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

Weiterführende Informationen zu Ereignisweiterleitungsfunktionen in Experience Platform finden Sie in der Übersicht über die Ereignisweiterleitung.

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