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 Um die Vorteile dieser Partnerschaft zu nutzen, benötigen Sie ein aktives Treasure Data-Konto.
Currents Um Daten in Treasure Data zu exportieren, müssen Sie Braze-Currents für Ihr Konto einrichten lassen.
Braze Currents Streaming-Konnektor Kontaktieren Sie den Treasure Data-Support, um den Braze Currents Streaming-Konnektor (Beta) für Ihr Treasure Data-Konto zu aktivieren.
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 eintreffen, können Sie sie mit SQL abfragen. Treasure Data flacht die Payload ab, sodass kein JSON-Parsing erforderlich ist.

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, wird jeder Ereignistyp in einer eigenen Tabelle gespeichert (zum Beispiel users_message_email_open oder users_behaviors_purchase).

Um zu bestätigen, dass Daten eintreffen, 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)

Details zur Integration

Braze unterstützt den Export aller Daten, die in den Currents-Ereignisglossaren aufgeführt sind, in Treasure Data. Dies umfasst alle Eigenschaften von Nachrichten-Engagement- und Kundenverhalten-Ereignissen.

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

Migration von der veralteten Postback-Methode

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

  1. Führen Sie die Einrichtung des Custom Currents Exports gemäß dieser Anleitung durch.
  2. Bestätigen Sie, dass Ereignisse in die neue Tabelle fließen.
  3. Deaktivieren Sie den alten Postback-basierten Current in Braze.

Ältere Daten, die als rohe JSON-Arrays 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 ist.
New Stuff!