Skip to content

Treasure Data für Currents

Treasure Data ist eine Customer Data Platform (CDP), die Informationen aus verschiedenen Quellen sammelt und an eine Vielzahl anderer Ziele in Ihrem Marketing Stack weiterleitet.

Die Integration von Braze und Treasure Data erlaubt es Ihnen, den Informationsfluss zwischen den beiden Systemen zu steuern. Mit Currents können Sie Braze-Ereignisdaten in Treasure Data streamen und über den gesamten Growth Stack hinweg nutzbar machen.

Die empfohlene Methode ist der Braze Currents Streaming-Konnektor in Treasure Data in Kombination mit einem Custom Currents Export in Braze. Dieser Ansatz bietet:

  • Realtime-Event-Streaming von Braze in Treasure Data
  • Optionales automatisches Tabellenrouting nach Ereignistyp
  • Ein flaches, SQL-abfragbares Schema, das kein JSON-Parsing erfordert

Voraussetzungen

Anforderung Beschreibung
Treasure Data-Konto Ein aktives Treasure Data-Konto ist erforderlich, um diese Partnerschaft nutzen zu können.
Currents Um Daten nach Treasure Data zu exportieren, müssen Braze-Currents für Ihr Konto eingerichtet sein.
Braze-Currents-Streaming-Konnektor Wenden Sie sich an den Treasure Data-Support, um den Braze-Currents-Streaming-Konnektor für Ihr Treasure Data-Konto aktivieren zu lassen.
Treasure Data Write-API-Schlüssel Ein Treasure Data Write-API-Schlüssel authentifiziert den eingehenden Stream von Braze.

Integration

Schritt 1: Konnektor in Treasure Data konfigurieren

  1. Navigieren Sie in der Treasure Data-Konsole zu Connections > New Connection.
  2. Wählen Sie Braze Currents Streaming aus.
  3. Geben Sie unter Authentication Ihren Treasure Data Write-API-Schlüssel ein.
  4. Konfigurieren Sie unter Source Settings die folgenden Einstellungen:
Feld Beschreibung
Source Name Ein beschreibender Name für diese Verbindung
Datastore Wählen Sie Plazma aus
Database Die Treasure Data-Datenbank, in der Ereignisse gespeichert werden
Table Die Standard-Zieltabelle
Multiple Tables Aktivieren Sie diese Option, um jeden Braze-Ereignistyp in eine eigene Tabelle zu leiten
  1. Kopieren Sie nach dem Speichern die Unique ID (task_id). Sie benötigen diesen Wert im nächsten Schritt.

Schritt 2: Custom Currents Export in Braze erstellen

Die Option Treasure Data Export in der Braze-Currents-UI verwendet die veraltete Postback-API-Methode und wird nicht mehr empfohlen. Verwenden Sie stattdessen Custom Currents Export.

  1. Navigieren Sie in Braze zu Partnerintegrationen > Data Export.
  2. Wählen Sie Create New Current > Custom Currents Export aus.
  3. Geben Sie einen Integrationsnamen und eine Kontakt-E-Mail für Fehlerbenachrichtigungen ein.
  4. Geben Sie unter Credentials die Endpunkt-URL für Ihre Treasure Data-Region ein. Geben Sie Ihren Treasure Data Write-API-Schlüssel als Bearer Token ein.
Region Endpunkt-URL
US https://braze-in-streaming.treasuredata.com/v1/task/{TASK_ID}
EU https://braze-in-streaming.eu01.treasuredata.com/v1/task/{TASK_ID}
AP02 https://braze-in-streaming.ap02.treasuredata.com/v1/task/{TASK_ID}
Tokyo https://braze-in-streaming.treasuredata.co.jp/task/v1/{TASK_ID}

Ersetzen Sie {TASK_ID} durch die Unique ID, die Sie in Schritt 1 kopiert haben.

  1. Wählen Sie die Ereignistypen aus, die Sie exportieren möchten. Custom Currents-Verbindungen können Ereignisse für identifizierte Nutzer:innen und für Nutzer:innen ohne external_user_id senden. Treasure Data nimmt beide auf.
  2. Wählen Sie Launch Current aus.

Daten abfragen

Sobald Ereignisse einfließen, können Sie diese mit SQL abfragen. Treasure Data flacht die Payload ab, sodass Sie kein JSON parsen müssen.

1
2
3
4
5
6
7
8
9

SELECT
  id AS event_id,
  event_type,
  user_external_user_id,
  properties_campaign_name,
  properties_email_address,
  time
FROM your_database.your_table
WHERE TD_INTERVAL(time, '-1d', 'JST')

Wenn Sie Multiple Tables ausgewählt haben, landet jeder Ereignistyp in einer eigenen Tabelle (zum Beispiel users_message_email_open oder users_behaviors_purchase).

Um zu bestätigen, dass Daten ankommen, führen Sie einige Minuten nach dem Start des Currents eine Zählabfrage aus:

1
2
3

SELECT COUNT(*)
FROM your_table
WHERE TD_INTERVAL(time, '-1h')

Datenschema

Treasure Data flacht verschachteltes JSON bis zu zwei Ebenen tief ab:

JSON-Typ Treasure Data-Spaltentyp
string string
number long
boolean string
array JSON-String
object (Ebene 1) field_name
object (Ebene 2) parent_field_name_field_name
null ausgelassen

Spaltennamen verwenden ausschließlich Kleinbuchstaben und Unterstriche.

Limits

Element Limit
Maximale Payload-Größe 1 MB pro Anfrage
Batch-Größe 100 Ereignisse pro Batch (Standard)

Integrationsdetails

Braze unterstützt den Export aller Daten, die in den Currents-Ereignisglossaren aufgeführt sind, an Treasure Data. Dies umfasst alle Eigenschaften sowohl in Nachrichteninteraktions- als auch in Kundenverhaltensereignissen.

Die Payload-Struktur für exportierte Daten entspricht der Payload-Struktur für angepasste HTTP-Konnektoren. Sie können Beispiel-Payloads im Beispiel-Repository für angepasste HTTP-Konnektoren einsehen.

Migration von der alten Postback-Methode

Wenn Sie zuvor Treasure Data Export (Postback) in Braze verwendet haben:

  1. Schließen Sie die Einrichtung des Custom Currents Export ab, wie in diesem Artikel beschrieben.
  2. Bestätigen Sie, dass Ereignisse in die neue Tabelle fließen.
  3. Deaktivieren Sie den alten Postback-basierten Current in Braze.

Alte Daten, die als JSON-Arrays im Rohformat gespeichert sind, können weiterhin mit JSON_PARSE und UNNEST abgefragt werden. Neue Daten, die über den Streaming-Konnektor aufgenommen werden, verwenden das flache Schema, das unter Datenschema beschrieben wird.
New Stuff!