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 nach Amplitude zu exportieren, muss Braze-Currents für Ihr Konto eingerichtet sein. |
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:innen-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:innen-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:
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Sie können zwei Arten von Events nach Amplitude exportieren: Message-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 nach Amplitude das Präfix [Appboy]. Dieses Label bezieht sich auf den früheren Produktnamen von Braze. Dies ist das erwartete Verhalten und deutet nicht auf ein SDK- oder Integrationsproblem hin.
Alle in Braze benannten und 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:in 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 stets aktuell. Wenn die Zugangsdaten Ihres Konnektors ablaufen, stellt der Konnektor den Versand von Events ein. Wenn dies länger als 48 Stunden 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 die angezeigten 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 Current starten.
Von Braze-Currents an Amplitude gesendete Events 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.
Weitere Informationen finden Sie in Amplitudes 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 sowie 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 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 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 führen Sie keine automatisierten Tests durch, 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 Nachrichteninteraktions-Events und im Glossar der Kundenverhalten-Events aus.