DokumentationExperience PlatformTags

Braze Track Events API-Erweiterung zur Ereignisweiterleitung

Last update: Thu Dec 07 2023 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. Verwenden Brazekö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.

Die Braze Track Events API Ereignisweiterleitung -Erweiterung ermöglicht es Ihnen, die im Adobe Experience Platform Edge Network erfassten Daten zu nutzen und an Braze in Form von serverseitigen Ereignissen, bei denen die Braze User Track API.

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

Anwendungsfälle

Diese Erweiterung sollte verwendet werden, wenn Sie Daten aus dem Edge-Netzwerk in Braze , um die Analyse- und Targeting-Funktionen der Kunden zu nutzen.

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. Verwendung verschiedener Tag Regeln, werden diese Daten in Echtzeit an das Edge-Netzwerk gesendet. Von hier aus kann die Braze Ereignisweiterleitungserweiterung sendet automatisch relevante Ereignisse an Braze vom Server aus.

Sobald die Daten gesendet wurden, können die Analyseteams des Unternehmens Braze’s Funktionen zur Verarbeitung der Datensätze und Ableitung von Geschäftsinsights, um Diagramme, Dashboards oder andere Visualisierungen zu generieren, die geschäftliche Stakeholder informieren. Siehe Abschnitt Braze Kunden für weitere Informationen zu den verschiedenen Anwendungsfällen der Plattform.

Braze Voraussetzungen und Limits prerequisites

Sie müssen über eine Braze , um seine Technologien zu nutzen. Wenn Sie kein Konto haben, navigieren Sie zu Erste Schritte on Braze zur Verbindung mit Braze Sales und starten Sie die Kontoerstellung.

API-Limits

Die Erweiterung verwendet zwei von BrazeDie APIs und ihre Beschränkungen sind unten beschrieben:

API
Ratenbeschränkungen
User Track
50.000 Anfragen pro Minute.
Siehe Abschnitt User Track API-Dokumentation für Details.
User Identify
20.000 Anfragen pro Minute.
Siehe Abschnitt User Identify API-Dokumentation für Details.
NOTE
Weitere Informationen finden Sie im Handbuch unter Braze API-Beschränkungen weitere Einzelheiten zu den von ihnen auferlegten Beschränkungen.

Abrechenbare Datenpunkte

Senden zusätzlicher benutzerdefinierter Attribute an Braze kann die Braze Datenpunktverbrauch. Wenden Sie sich an Ihre Braze Kundenbetreuer vor dem Senden zusätzlicher benutzerdefinierter Attribute. Siehe Abschnitt Braze Dokumentation zu Abrechnungsdatenpunkte für weitere Informationen.

Erforderliche Konfigurationsdetails sammeln configuration-details

Um das Edge-Netzwerk mit Braze, sind folgende Eingaben erforderlich:

Schlüsseltyp
Beschreibung
Beispiel
Braze Instanz
Der REST-Endpunkt, der mit dem Braze -Konto. Siehe Abschnitt Braze Dokumentation zu Instanzen für Leitlinien.
https://rest.iad-03.braze.com
API-Schlüssel
Die Braze API-Schlüssel, der mit dem Braze -Konto.
Siehe Abschnitt Braze Dokumentation zu REST-API-Schlüssel für Leitlinien.
YOUR-BRAZE-REST-API-KEY

Erstellen geheimer Daten

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

Installieren und konfigurieren Sie die Braze Erweiterung install

So installieren Sie die Erweiterung: Erstellen einer 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. Im Katalog Registerkarte auswählen Installieren auf der Karte für die Braze -Erweiterung.

Installieren Sie die Braze -Erweiterung.

Geben Sie im nächsten Bildschirm Folgendes ein: Konfigurationswerte die Sie zuvor aus Braze:

  • Rest-Endpunkt-URL löschen: Sie können den Wert Ihrer Braze REST-Endpunkt-URL als Nur-Text in der bereitgestellten Eingabe.
  • API-Schlüssel: Wählen Sie die Geheimdatenelement die Sie zuvor erstellt haben und die Braze API-Schlüssel.

Wählen Sie Speichern, wenn Sie fertig sind.

Die Braze Erweiterungskonfigurationsseite.

Erstellen Sie eine Send Event Regel tracking-rule

Erstellen Sie nach der Installation der Erweiterung eine neue Ereignisweiterleitung. Regel und konfigurieren Sie die Bedingungen nach Bedarf. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Brase Erweiterung und wählen Sie Ereignis senden für den Aktionstyp.

Fügen Sie eine Aktionskonfiguration für Ereignisweiterleitungsregeln 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. Weitere Informationen vorgeschlagene Benutzer-ID-Benennungskonvention.
Benutzer-ID speichern
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 user alias -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 Externe Benutzer-ID -Feld oder dem Benutzerkennung für Blitzen oder Benutzeralias Abschnitt.

Ereignisdaten

Eingabe
Beschreibung
Erforderlich
​
Name des Ereignisses.
Ja
Ereigniszeit
Datum/Uhrzeit als Zeichenfolge in ISO 8601 oder in yyyy-MM-dd'T'HH:mm:ss:SSSZ Format.
Ja
App-Kennung
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. Weitere Informationen zum API-Kennungstypen.
Ereigniseigenschaften ​
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Ereignisses.
NOTE
Die Ereignis "Senden" -Aktion erfordert nur Ereignisname und Ereigniszeit angegeben werden. Sie sollten jedoch so viele Informationen wie möglich in das Feld für benutzerdefinierte Eigenschaften einfügen. Weitere Informationen finden Sie unter Braze event -Objekt, siehe amtliche 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).
Stadt
Land
Land als Zeichenfolge in ISO-3166-1 alpha-2 Format.
Sprache
Sprache als Zeichenfolge in ISO-639-1 Format.
Geburtsdatum
Zeichenfolge im Format "JJJ-MM-TT"(z. B. 1980-12-21).
Zeitzone
Zeitzonenname aus IANA-Zeitzonen-Datenbank (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 Sie eine Send Purchase Event Regel purchase-rule

Erstellen Sie nach der Installation der Erweiterung eine neue Ereignisweiterleitung. Regel und konfigurieren Sie die Bedingungen nach Bedarf. Wählen Sie beim Konfigurieren der Aktionen für die Regel die Brase Erweiterung und wählen Sie Kaufereignis senden für den Aktionstyp.

Fügen Sie die Konfiguration der Ereignisweiterleitungsregel vom Typ Aktion für den Kauf eines Leerlaufs 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. Weitere Informationen vorgeschlagene Benutzer-ID-Benennungskonvention.
Benutzer-ID speichern
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 user alias -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 Externe Benutzer-ID -Feld, Benutzerkennung für Blitzen -Feld oder dem Benutzeralias Abschnitt.

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 in yyyy-MM-dd'T'HH:mm:ss:SSSZ Format.
Ja
​
Währung als Zeichenfolge in ISO 4217 Alphabetisches Währungscode-Format.
Ja
​
Preis.
Ja
​
Wenn kein Wert angegeben wird, ist der Standardwert 1. Der Höchstwert muss unter 100 liegen.
App-Kennung
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. Weitere Informationen zum API-Kennungstypen.
​
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Kaufs.
NOTE
Die Ereignis "Senden" -Aktion erfordert nur Ereignisname und Ereigniszeit angegeben werden. Sie sollten jedoch so viele Informationen wie möglich in das Feld für benutzerdefinierte Eigenschaften einfügen. Weitere Informationen finden Sie unter Braze event -Objekt, siehe amtliche 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).
Stadt
Land
Land als Zeichenfolge in ISO-3166-1 alpha-2 Format.
Sprache
Sprache als Zeichenfolge in ISO-639-1 Format.
Geburtsdatum
Zeichenfolge im Format "JJJ-MM-TT"(z. B. 1980-12-21).
Zeitzone
Zeitzonenname aus IANA-Zeitzonen-Datenbank (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.

Validieren von Daten in Braze validate

Wenn die Ereigniskollektion und Adobe Experience Platform -Integration erfolgreich war, werden Ereignisse im Braze console when Anzeigen von Benutzerprofilen. Insbesondere die neuen Ereignisdaten, die an Braze wird im Purchases -Abschnitt eines bestimmten Benutzers Übersichtsregisterkarte.

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Konversionsereignisse an gesendet werden Braze über die Ereignisweiterleitung. Weitere Informationen zu nachgelagerten Anwendungen für Ereignisdaten, die an gesendet werden Braze, siehe amtliche Dokumentation.

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

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