Currents einrichten

Auf dieser Seite wird der allgemeine Prozess zur Integration und Konfiguration von Braze-Currents beschrieben.

Wichtig

Currents sind in bestimmten Braze-Paketen enthalten. Wenden Sie sich an Ihre Vertretung von Braze, wenn Sie Fragen haben oder Zugang erhalten möchten.

Fehlerbehebung

Neue Currents-Integration kann nicht hinzugefügt werden

Wenn beim Hinzufügen einer neuen Integration die Meldung „You do not have any remaining Currents integrations“ erscheint oder der Button zum Hinzufügen eines neuen Currents-Konnektors ausgegraut ist, hat das meist eine der folgenden Ursachen:

• Für diesen Workspace wurde keine Currents-Berechtigung erworben.
• Die Currents-Berechtigung ist in einem anderen Workspace Ihres Unternehmens verfügbar.

Prüfen Sie die anderen Workspaces in Ihrem Unternehmen. Möglicherweise ist in einem anderen Workspace eine Currents-Berechtigung verfügbar. Wenn Sie eine Berechtigung anfordern oder Ihre Konfiguration anpassen möchten, wenden Sie sich an Ihren Braze Account Manager.

Zusätzliches Event-Tracking kann nicht aktiviert werden

Wenn Sie einen Konnektor erstellen oder bearbeiten, aber einen der optionalen Tracking-Schalter nicht aktivieren können, hat Ihr Workspace möglicherweise das Berechtigungslimit für diese Event-Kategorie erreicht.

• Track Customer Behavior and User Events erfordert verfügbare Berechtigungen für Customer Behavior Events.
• Track user profiles and attributes erfordert verfügbare Berechtigungen für User Profiles and Attributes.

Wenn Sie zusätzliche Berechtigungen oder Hilfe bei der Anpassung Ihrer Konfiguration benötigen, wenden Sie sich an Ihren Braze Account Manager.

Fehlerbenachrichtigungen zu Integrationen verstehen

Wenn bei einer Currents-Integration Probleme bei der Zustellung von Events auftreten, sendet Braze eine E-Mail an die Kontakt-E-Mail-Adressen, die für diese Integration hinterlegt sind. Ist für die Integration keine Kontakt-E-Mail hinterlegt, bittet Braze Ihr Braze-Account-Team, die richtige Person zu erreichen. Damit Sie diese Benachrichtigungen direkt erhalten, fügen Sie jeder Integration eine Kontakt-E-Mail hinzu.

Jede Benachrichtigung hat dieselbe Betreffzeile: „[Urgent Action Required to Prevent Data Loss] Firmenname Integrationstyp Currents integration failing“. Das gilt auch für Benachrichtigungen, dass sich die Integration wiederhergestellt hat. Um herauszufinden, welche Benachrichtigung Sie erhalten haben, suchen Sie die passende Formulierung aus dem E-Mail-Text in der folgenden Tabelle. Wenn in der E-Mail steht, dass die Integration deaktiviert wurde, verwenden Sie die entsprechende „disabled“-Zeile, auch wenn die E-Mail zusätzlich angibt, dass die Integration weiterhin fehlschlägt.

Anforderungen

Für die Nutzung von Currents mit jedem unserer Partner gelten dieselben grundlegenden Parameter und dieselbe Verbindungsmethodik.

Jeder Partner setzt voraus, dass Braze die Berechtigung hat, Datendateien zu schreiben und an ihn zu senden. Braze fragt außerdem nach dem Speicherort, an den diese Dateien geschrieben werden sollen, insbesondere nach Bucket-Namen oder Schlüsseln.

Die folgenden Anforderungen sind die grundlegenden Mindestanforderungen für die Integration mit den meisten unserer Partner. Einige Partner benötigen zusätzliche Parameter. Diese finden Sie in der jeweiligen Partnerdokumentation zusammen mit allen Besonderheiten dieser grundlegenden Anforderungen.

Wichtig

Es ist wichtig, Ihre Partner-Schlüssel, Partner-Token und Authentifizierungsdaten aktuell zu halten. Wenn die Zugangsdaten Ihres Konnektors ablaufen, sendet der Konnektor keine Events mehr. Hält dieser Zustand länger als 5 Tage an, werden die Events des Konnektors verworfen und die Daten gehen dauerhaft verloren.

Currents einrichten

Schritt 1: Partner auswählen

Mit Braze-Currents können Sie entweder über Data Storage mit Flat Files integrieren oder über gebündelte JSON-Payloads an einen festgelegten Endpunkt unsere Partner für Verhaltensanalysen und Kundendaten anbinden.

Bevor Sie mit der Integration beginnen, sollten Sie entscheiden, welche Integration sich am besten für Ihre Zwecke eignet. Wenn Sie zum Beispiel bereits mParticle und Segment nutzen und Braze-Daten dorthin streamen möchten, ist eine gebündelte JSON-Payload die beste Wahl. Wenn Sie die Daten lieber selbst bearbeiten möchten oder ein komplexeres System zur Datenanalyse haben, ist Data Storage wahrscheinlich die bessere Option (Braze nutzt diese Methode!)

Schritt 2: Currents öffnen

Gehen Sie zunächst zu Partnerintegrationen > Currents. Sie gelangen dann auf die Seite zur Verwaltung der Currents-Integration.

Schritt 3: Partner hinzufügen

Fügen Sie einen Partner hinzu, manchmal auch „Currents-Konnektor“ genannt, indem Sie das Dropdown-Menü oben auf dem Bildschirm auswählen.

Jeder Partner erfordert eigene Konfigurationsschritte. Um die jeweilige Integration zu aktivieren, lesen Sie unsere Liste der verfügbaren Partner und folgen Sie den Anweisungen auf den jeweiligen Seiten.

Geben Sie eine Kontakt-E-Mail-Adresse für Benachrichtigungen bei Integrationsfehlern an. Braze sendet Benachrichtigungen an diese Adresse, wenn bei der Integration Fehler auftreten, z. B. Probleme mit Anmeldedaten oder der Konnektivität. Um sicherzustellen, dass die richtigen Personen Benachrichtigungen erhalten, verwenden Sie einen Verteiler oder eine Gruppen-E-Mail-Adresse.

Schritt 4: Events konfigurieren

Wählen Sie die Events aus, die Sie an diesen Partner übergeben möchten, indem Sie die entsprechenden Optionen ankreuzen. Eine Auflistung dieser Events finden Sie in unseren Bibliotheken für Kundenverhalten-Events und Message-Engagement-Events.

Bei Bedarf erfahren Sie mehr über unsere Events im Artikel zur Semantik der Zustellung von Events.

Schritt 5: Feldtransformationen einrichten

Mit Currents-Feldtransformationen können Sie ein String-Feld entfernen oder hashen.

• Entfernen: Ersetzt das String-Feld durch [REDACTED]. Das ist hilfreich, wenn Ihr Partner Events mit fehlenden oder leeren Feldern ablehnt.
• Hashen: Wendet einen SHA-256-Hash-Algorithmus auf das String-Feld an.

Wenn Sie ein Feld für eine dieser Transformationen auswählen, wird die Transformation auf alle Events angewendet, in denen dieses Feld vorkommt. Wenn Sie zum Beispiel email_address zum Hashen auswählen, wird das Feld email_address in den Events Email Send, Email Open, Email Bounce und Subscription Group State Change gehasht.

Feldtransformationen funktionieren nur bei String-Feldern. Andere Feldtypen, wie z. B. Arrays, stehen nicht zur Auswahl, sodass Sie diese weder entfernen noch hashen können. So bleibt zum Beispiel das Array-Feld suspected_bot_click_reason in Email-Click-Events in Ihrem Export erhalten.

Feldtransformationen bei einem aktiven Konnektor bearbeiten

Sie können Feldtransformationen bei einem aktiven Konnektor hinzufügen, ändern oder entfernen, ohne ihn neu zu starten. Nachdem Sie den Konnektor aktualisiert haben, werden Ihre Änderungen nach etwa 5 Minuten wirksam.

Das Bearbeiten von Feldtransformationen ändert weder die Version des Avro-Schemas noch das Segment version=<currents_version> in Ihrem Speicherpfad. Nur Currents-Releases ändern dieses Segment. Weitere Informationen finden Sie unter Änderungen am Avro-Schema.

Schritt 6: Integration testen

Wichtig

Currents verwirft Events mit übermäßig großen Payloads von mehr als 900 KB.

Bevor Sie testen, sollten Sie sich unsere Beispieldaten für Currents auf GitHub ansehen. Wenn Sie bereit zum Testen sind, wählen Sie eine der Optionen im folgenden Abschnitt:

Test-Events senden

Um Ihre Integration zu testen, können Sie Send Test Events auswählen, um ein Event jedes ausgewählten Event-Typs an diesen Current zu senden. Detaillierte Informationen zu jedem Event-Typ finden Sie in unseren Bibliotheken für Kundenverhalten-Events und Message-Engagement-Events.

Currents-Konnektoren testen

Test-Currents-Konnektoren sind kostenlose Versionen unserer bestehenden Konnektoren, mit denen Sie verschiedene Ziele testen und ausprobieren können. Für Test-Currents gilt:

• Bis zu 10 Test-Currents-Konnektoren pro Workspace.
• Insgesamt maximal 1.500 Events pro festem 24-Stunden-Zeitraum, der um Mitternacht UTC zurückgesetzt wird. Auf der Seite Currents können Sie Ihr aktuelles Sendevolumen im Verhältnis zu diesem Limit verfolgen. Braze aktualisiert diese Summe stündlich.

Braze prüft die Nutzung von Test-Currents einmal pro Stunde anhand dieses Limits. Wenn zwischen zwei stündlichen Prüfungen eine große Menge an Events eingeht, können Ihre Test-Currents-Konnektoren in diesem Zeitraum mehr als 1.500 Events exportieren, bevor das Limit greift.

Stellt eine stündliche Prüfung fest, dass Ihre Test-Currents-Konnektoren das Sendelimit erreicht haben, deaktiviert Braze den Konnektor und verwirft Events, die erstellt werden, solange das Limit erreicht ist. Die Synchronisierung der Events wird fortgesetzt, nachdem das Limit um Mitternacht UTC zurückgesetzt wurde.

Um Ihren Test-Currents-Konnektor upzugraden, bearbeiten Sie die Integration im Dashboard und wählen Sie Upgrade Test Integration.

Currents aktualisieren

Um Ihren Currents-Konnektor nach dem Starten zu aktualisieren, gehen Sie wie folgt vor:

1. Navigieren Sie in Braze zu Partnerintegrationen > Datenexport.
2. Suchen Sie Ihren Currents-Konnektor in der Liste.
3. Wählen Sie  Bearbeiten.
4. Nehmen Sie Ihre Änderungen vor.
5. Wählen Sie Update Current.

Dadurch wird Ihr bestehender Export nicht gestoppt, sondern es wird mit dem Versand von Ereignissen gemäß Ihrer neuen Auswahl begonnen.

Hinweis

Es kann einige Zeit dauern, bis Ihre Änderungen wirksam werden.

IP-Allowlisting

Braze sendet Currents-Daten von den aufgeführten IPs:

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