Amplitude für Currents
Amplitude ist eine Plattform für Produkt-Analytics und Business-Intelligence.
Die bidirektionale Integration von Braze und Amplitude ermöglicht es Ihnen, Ihre Amplitude-Kohorten, Nutzermerkmale und Events mit Braze zu synchronisieren und Braze-Currents zu nutzen, um Ihre Braze-Events nach Amplitude zu exportieren und so tiefere Analysen Ihrer Produkt- und Marketingdaten durchzuführen.
Voraussetzungen
| Anforderung | Beschreibung |
|---|---|
| Amplitude-Konto | Ein Amplitude-Konto ist erforderlich, um diese Partnerschaft zu nutzen. |
| Currents | Um Daten zurück an Amplitude zu exportieren, müssen Sie Braze-Currents für Ihr Konto eingerichtet haben. |
Datenexport-Integration
Eine vollständige Liste der Events und Event-Eigenschaften, die von Braze an Amplitude exportiert werden können, finden Sie in den folgenden Abschnitten. Alle an Amplitude gesendeten Events enthalten die external_user_id der Nutzer:innen als Amplitude-Nutzer-ID. Braze-spezifische Event-Eigenschaften werden unter dem Schlüssel event_properties in den an Amplitude gesendeten Daten übertragen.
Um dieses Feature nutzen zu können, muss Ihre Amplitude-Nutzer-ID mit der externen Braze-ID übereinstimmen.
Braze sendet nur Event-Daten für Nutzer:innen, deren external_user_id gesetzt ist, oder für anonyme Nutzer:innen, deren device_id gesetzt ist. Für anonyme Nutzer:innen müssen Sie Ihre Amplitude-Geräte-ID mit der Braze-Geräte-ID im SDK synchronisieren. Beispiel:
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Sie können zwei Arten von Events an Amplitude exportieren: Nachrichten-Engagement-Events, die aus den direkt mit dem Nachrichtenversand verbundenen Braze-Events bestehen, und Kundenverhalten-Events, einschließlich anderer App- oder Website-Aktivitäten wie Sitzungen, angepasste Events und über die Plattform erfasste Käufe. Alle regulären Events erhalten das Präfix [Appboy], und alle angepassten Events erhalten das Präfix [Appboy] [Custom Event]. Angepasste Event- und Kauf-Event-Eigenschaften erhalten die Präfixe [Custom event property] bzw. [Purchase property].
Braze-Currents verwendet beim Export von Events an Amplitude das Präfix [Appboy]. Dieses Label bezieht sich auf den früheren Produktnamen von Braze. Dies ist erwartetes Verhalten und weist nicht auf ein SDK- oder Integrationsproblem hin.
Alle benannten und in Braze importierten Kohorten erhalten das Präfix [Amplitude] und das Suffix ihrer cohort_id. Das bedeutet, dass eine Kohorte mit dem Namen „TEST_COHORT“ und der cohort_id „abcd1234“ in Braze-Filtern als [Amplitude] TEST_COHORT: abcd1234 angezeigt wird.
Wenden Sie sich an Ihren Account Manager oder eröffnen Sie ein Support-Ticket, wenn Sie Zugang zu zusätzlichen Event-Berechtigungen benötigen.
Schritt 1: Amplitude-Integration in Braze konfigurieren
Suchen Sie in Amplitude Ihren Amplitude-Export-API-Schlüssel.
Halten Sie Ihren Amplitude-API-Schlüssel aktuell. Wenn die Zugangsdaten Ihres Konnektors ablaufen, stellt der Konnektor den Versand von Events ein. Wenn dieser Zustand länger als 5 Tage anhält, werden die Events des Konnektors verworfen und Daten gehen dauerhaft verloren.
Schritt 2: Braze Current erstellen
Navigieren Sie in Braze zu Currents > + Current erstellen > Amplitude-Export erstellen. Geben Sie einen Integrationsnamen, eine Kontakt-E-Mail, den Amplitude-Export-API-Schlüssel und die Amplitude-Region in den aufgeführten Feldern an. Wählen Sie anschließend die Events aus, die Sie verfolgen möchten; eine Liste der verfügbaren Events wird bereitgestellt. Klicken Sie abschließend auf Current starten.
Events, die von Braze-Currents an Amplitude gesendet werden, werden auf Ihr Amplitude-Event-Volumenkontingent angerechnet.
Wenn Sie beim Einfügen Ihres Amplitude-API-Schlüssels den Fehler „Ungültiger API-Schlüssel“ erhalten, versuchen Sie, den Schlüssel manuell einzugeben. Einige Browser können beim Kopieren und Einfügen versteckte Zeichen hinzufügen, die zu Validierungsfehlern führen.
Weitere Informationen finden Sie in der Amplitude-Dokumentation zur Appboy-Amplitude-Integration.
Rate-Limits
Currents stellt eine Verbindung zur HTTP-API von Amplitude her, die ein Rate-Limit von 30 Events/Sekunde pro Gerät und ein undokumentiertes Limit von 500.000 Events/Tag pro Gerät hat. Wenn diese Schwellenwerte überschritten werden, drosselt Amplitude die über Currents protokollierten Events. Falls ein Gerät in Ihrer Integration dieses Rate-Limit überschreitet, kann es zu einer Verzögerung kommen, bis Events von allen Geräten in Amplitude angezeigt werden.
Geräte sollten unter normalen Umständen nicht mehr als 30 Events/Sekunde oder 500.000 Events/Tag melden, und dieses Event-Muster sollte nur durch eine fehlerhafte Integration auftreten. Um diese Art von Verzögerung zu vermeiden, stellen Sie sicher, dass Ihre SDK-Integration Events mit einer normalen Rate meldet, wie in unseren Anweisungen zur SDK-Integration angegeben, und führen Sie keine automatisierten Tests durch, die viele Events für ein einzelnes Gerät erzeugen.
Unterstützte Currents-Ereignisse
Braze unterstützt den Export der folgenden Ereignisse an Amplitude:
Informationen zur Payload-Struktur der einzelnen Ereignisse finden Sie auf dem Tab Amplitude im Glossar der Nachrichteninteraktions-Events und im Glossar der Kundenverhalten-Events.