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“ angezeigt wird 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 Ihres Unternehmens verfügbar.

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

Anforderungen

Die Verwendung von Currents mit einem unserer Partner erfordert dieselben grundlegenden Parameter und dieselbe Verbindungsmethodik.

Jeder Partner setzt voraus, dass Braze die Berechtigung hat, Datendateien an ihn zu schreiben und 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 dieser 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 dies länger als 5 Tage andauert, werden die Events des Konnektors verworfen und Daten gehen dauerhaft verloren.

Currents einrichten

1. Schritt: 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 der Integration beginnen, sollten Sie entscheiden, welche Integrationsmethode 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!).

2. Schritt: Currents öffnen

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

3. Schritt: 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.

4. Schritt: Events konfigurieren

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

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

5. Schritt: 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 Events mit fehlenden oder leeren Feldern ablehnt.
• Hashen: Wendet einen SHA-256-Hashing-Algorithmus auf das String-Feld an.

Wenn Sie ein Feld für eine dieser Transformationen auswählen, wird diese Transformation auf alle Events angewendet, in denen dieses Feld vorkommt. Wenn Sie beispielsweise email_address zum Hashen auswählen, wird das Feld email_address in den Events „E-Mail-Versand“, „E-Mail-Öffnung“, „E-Mail-Bounce“ und „Änderung des Abo-Gruppen-Status“ gehasht.

6. Schritt: Integration testen

Wichtig

Currents verwirft Events 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 Event 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.

Currents-Test-Konnektoren

Currents-Test-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 Events pro festem 24-Stunden-Zeitraum, das um Mitternacht UTC zurückgesetzt wird. Diese Event-Gesamtzahl wird stündlich im Dashboard aktualisiert.

Nachdem Ihre Test-Currents-Konnektoren das Sendelimit erreicht haben, sendet Ihr Konnektor bis zum nächsten Tag (um Mitternacht UTC) keine Events mehr.

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 aufgeführten IPs:

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