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 nach 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:in-ID. Braze-spezifische Event-Eigenschaften werden unter dem Schlüssel event_properties in den an Amplitude gesendeten Daten übermittelt.
Um dieses Feature zu nutzen, muss Ihre Amplitude-Nutzer:in-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. Zum Beispiel:
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Sie können zwei Arten von Events nach Amplitude exportieren: Nachrichteninteraktions-Events, die aus den direkt mit dem Nachrichtenversand zusammenhängenden 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 werden mit [Appboy] präfixiert, und alle angepassten Events werden mit [Appboy] [Custom Event] präfixiert. Angepasste Event- und Kauf-Event-Eigenschaften werden mit [Custom event property] bzw. [Purchase property] präfixiert.
Braze-Currents verwendet beim Export von Events nach Amplitude das Präfix [Appboy]. Diese Bezeichnung bezieht sich auf den früheren Produktnamen von Braze. Dies ist das erwartete Verhalten und weist nicht auf ein SDK- oder Integrationsproblem hin.
Alle in Braze benannten und importierten Kohorten werden mit [Amplitude] präfixiert und mit ihrer cohort_id suffixiert. 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 Ihre:n Account Manager:in oder eröffnen Sie ein Support-Ticket, wenn Sie Zugriff auf zusätzliche 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, wird der Konnektor keine Events mehr senden. Wenn dies länger als 48 Stunden anhält, werden die Events des Konnektors verworfen und die 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, einen Amplitude-Export-API-Schlüssel und eine Amplitude-Region in die aufgeführten Felder ein. 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 Launch Current.
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 „Invalid API key“ 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 können.
Weitere Informationen finden Sie in der Amplitude-Dokumentation 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. Werden diese Schwellenwerte überschritten, drosselt Amplitude die über Currents protokollierten Events. Wenn 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 erscheinen.
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 bei einer fehlerhaft konfigurierten 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 verzichten Sie auf automatisierte Tests, die viele Events für ein einzelnes Gerät erzeugen.
Unterstützte Currents-Events
Braze unterstützt den Export der folgenden Events an Amplitude:
Für die Payload-Struktur jedes Events wählen Sie den Tab Amplitude im Glossar der Nachrichten-Engagement-Events und im Glossar der Kundenverhalten-Events aus.