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 Sie beim Hinzufügen einer neuen Integration die Meldung „You do not have any remaining Currents integrations“ sehen oder der Button zum Hinzufügen eines neuen Currents-Konnektors ausgegraut ist, sind häufige Ursachen:

• Für diesen Workspace wurde kein Currents-Kontingent erworben.
• Das Currents-Kontingent ist in einem anderen Workspace in Ihrem Unternehmen verfügbar.

Um dies zu beheben, prüfen Sie andere Workspaces in Ihrem Unternehmen. Ein anderer Workspace kann ein verfügbares Currents-Kontingent anzeigen. Wenn Sie ein Kontingent anfordern oder Ihre Konfiguration anpassen müssen, wenden Sie sich an Ihren Braze Account Manager.

Zusätzliches Event-Tracking kann nicht aktiviert werden

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

• Track Customer Behavior and User Events erfordert verfügbare Customer Behavior Events-Kontingente.
• Track user profiles and attributes erfordert verfügbare User Profiles and Attributes-Kontingente.

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

Anforderungen

Die Verwendung von Currents mit einem unserer Partner erfordert die gleichen grundlegenden Parameter und die gleiche Verbindungsmethodik.

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

Die folgenden Anforderungen sind die grundlegenden Mindestanforderungen für die Integration mit den meisten unserer Partner. Einige Partner erfordern zusätzliche Parameter, die in der jeweiligen Partnerdokumentation zusammen mit etwaigen Besonderheiten zu diesen grundlegenden Anforderungen aufgeführt sind.

Wichtig

Es ist wichtig, Ihre Partner-Schlüssel, Partner-Token und Authentifizierungsdetails aktuell zu halten. Wenn die Zugangsdaten Ihres Konnektors ablaufen, stellt der Konnektor das Senden von Events ein. Wenn dieser Zustand länger als 5 Tage anhält, werden die Events des Konnektors verworfen und Daten gehen dauerhaft verloren.

Currents einrichten

Schritt 1: Partner auswählen

Braze-Currents ermöglicht die Integration über Data Storage mithilfe von Flat Files oder über unsere Partner für Verhaltensanalysen und Kundendaten mithilfe von gebündelten JSON-Payloads an einen festgelegten Endpunkt.

Bevor Sie mit Ihrer Integration beginnen, sollten Sie entscheiden, welche Integration für Ihre Zwecke am besten geeignet ist. Wenn Sie beispielsweise bereits mParticle und Segment verwenden und Braze-Daten dorthin streamen möchten, ist ein gebündelter JSON-Payload die beste Wahl. Wenn Sie die Daten lieber selbst bearbeiten oder ein komplexeres System zur Datenanalyse haben, ist Data Storage möglicherweise die bessere Option (Braze nutzt diese Methode selbst!).

Schritt 2: Currents öffnen

Gehen Sie zunächst zu Partnerintegrationen > Currents. Sie gelangen zur Verwaltungsseite für Currents-Integrationen.

Schritt 3: Partner hinzufügen

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

Jeder Partner erfordert unterschiedliche Konfigurationsschritte. Um die jeweilige Integration zu aktivieren, lesen Sie unsere Liste der verfügbaren Partner und folgen Sie den Anweisungen auf den entsprechenden 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: Ereignisse konfigurieren

Wählen Sie die Ereignisse aus, die Sie an den jeweiligen Partner weitergeben möchten, indem Sie die verfügbaren Optionen aktivieren. Auflistungen dieser Ereignisse finden Sie in unseren Bibliotheken für Kundenverhalten-Events und Nachrichten-Engagement-Events.

Bei Bedarf können Sie mehr über unsere Ereignisse im Artikel Semantik der Zustellung von Events erfahren.

Schritt 5: Feldtransformationen einrichten

Sie können Currents-Feldtransformationen verwenden, um ein String-Feld zu entfernen oder zu hashen.

• Entfernen: Ersetzt das String-Feld durch [REDACTED]. Dies ist hilfreich, wenn Ihr Partner Ereignisse 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 diese Transformation auf alle Ereignisse angewendet, in denen dieses Feld vorkommt. Wenn Sie beispielsweise email_address zum Hashen auswählen, wird das Feld email_address in E-Mail-Versand-, E-Mail-Öffnungs-, E-Mail-Bounce- und Abo-Gruppen-Statusänderungs-Events gehasht.

Schritt 6: Integration testen

Wichtig

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

Bevor Sie testen, sollten Sie sich unsere Currents-Beispieldaten auf GitHub ansehen. Wenn Sie bereit zum Testen sind, wählen Sie eine Option im folgenden Abschnitt:

Test-Events senden

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

Test-Currents-Konnektoren

Test-Currents-Konnektoren sind kostenlose Versionen unserer bestehenden Konnektoren, die zum Testen und Ausprobieren verschiedener Ziele verwendet werden können. Test-Currents bieten:

• Bis zu 10 Test-Currents-Konnektoren pro Workspace.
• Ein aggregiertes Maximum von 1.500 Ereignissen pro festem 24-Stunden-Zeitraum, das um Mitternacht UTC zurückgesetzt wird. Auf der Currents-Seite können Sie Ihr aktuelles Sendevolumen im Vergleich zu diesem Limit verfolgen. Braze aktualisiert diese Gesamtzahl stündlich.

Nachdem Ihre Test-Currents-Konnektoren das Sendelimit erreicht haben, deaktiviert Braze den Konnektor und verwirft Ereignisse, die erstellt werden, während das Limit erreicht ist. Die Event-Synchronisierung wird nach dem Zurücksetzen des Limits um Mitternacht UTC wieder aufgenommen.

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

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 aufgelisteten IPs:

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