Treasure Data pour Currents

Treasure Data est une plateforme de données client (CDP) qui collecte et achemine des informations provenant de sources multiples vers divers autres emplacements de votre stack marketing.

L’intégration de Braze et Treasure Data vous permet de contrôler le flux d’informations entre les deux systèmes. Avec Currents, vous pouvez diffuser les données d’événements Braze vers Treasure Data et les rendre exploitables dans l’ensemble de vos outils de croissance.

La méthode recommandée est le connecteur Braze Currents Streaming dans Treasure Data, associé à un Custom Currents Export dans Braze. Cette approche offre :

• La diffusion d’événements en temps réel de Braze vers Treasure Data
• Le routage automatique optionnel par type d’événement vers des tables distinctes
• Un schéma plat, interrogeable en SQL, qui ne nécessite pas d’analyse JSON

Important

Le connecteur Braze Currents Streaming est en version bêta. Contactez le support Treasure Data pour l’activer sur votre compte Treasure Data. Pour les détails de configuration côté partenaire, consultez l’intégration d’importation Braze Currents de Treasure Data.

Conditions préalables

Intégration

Étape 1 : Configurer le connecteur dans Treasure Data

1. Dans la console Treasure Data, accédez à Connections > New Connection.
2. Sélectionnez Braze Currents Streaming.
3. Sous Authentication, saisissez votre clé API d’écriture Treasure Data.
4. Sous Source Settings, configurez les éléments suivants :

1. Une fois la configuration enregistrée, copiez l’Unique ID (task_id). Vous aurez besoin de cette valeur à l’étape suivante.

Étape 2 : Créer un Custom Currents Export dans Braze

L’option Treasure Data Export dans l’interface Braze Currents utilise la méthode héritée Postback API et n’est plus recommandée. Utilisez plutôt Custom Currents Export.

1. Dans Braze, accédez à Partner Integrations > Data Export.
2. Sélectionnez Create New Current > Custom Currents Export.
3. Saisissez un nom d’intégration et une adresse e-mail de contact pour les notifications d’erreur.
4. Sous Credentials, saisissez l’URL de l’endpoint correspondant à votre région Treasure Data. Saisissez votre clé API d’écriture Treasure Data comme Bearer Token.

Remplacez {TASK_ID} par l’Unique ID que vous avez copié à l’étape 1.

1. Sélectionnez les types d’événements que vous souhaitez exporter. Les connexions Custom Currents peuvent envoyer des événements pour les utilisateurs identifiés et pour les utilisateurs sans external_user_id. Treasure Data ingère les deux.
2. Sélectionnez Launch Current.

Avertissement

Maintenez votre clé API d’écriture Treasure Data et l’URL de l’endpoint à jour. Si l’endpoint est inaccessible pendant plus de 5 jours, Braze abandonne les événements du connecteur et les données sont définitivement perdues.

Interroger vos données

Une fois les événements en cours de diffusion, interrogez-les avec SQL. Treasure Data aplatit le payload, vous n’avez donc pas besoin d’analyser du JSON.

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')

Remarque

Le champ time dans Treasure Data correspond à l’horodatage auquel Treasure Data a reçu et traité l’événement, et non à l’heure d’occurrence originale de l’événement dans Braze.

Si vous avez sélectionné Multiple Tables, chaque type d’événement est stocké dans sa propre table (par exemple, users_message_email_open ou users_behaviors_purchase).

Pour confirmer que les données arrivent, exécutez une requête de comptage quelques minutes après le lancement du Current :

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

Schéma des données

Treasure Data aplatit le JSON imbriqué jusqu’à deux niveaux de profondeur :

Les noms de colonnes utilisent uniquement des lettres minuscules et des underscores.

Limites

Détails de l’intégration

Braze prend en charge l’exportation de toutes les données répertoriées dans les glossaires d’événements Currents vers Treasure Data. Cela inclut toutes les propriétés des événements d’engagement des messages et de comportement des clients.

La structure du payload des données exportées est la même que celle des connecteurs HTTP personnalisés. Vous pouvez consulter des exemples de payloads dans le dépôt d’exemples de connecteurs HTTP personnalisés.

Migrer depuis la méthode héritée Postback

Si vous utilisiez précédemment Treasure Data Export (Postback) dans Braze :

1. Effectuez la configuration du Custom Currents Export décrite dans cet article.
2. Confirmez que les événements arrivent dans la nouvelle table.
3. Désactivez l’ancien Current basé sur Postback dans Braze.

Les données héritées stockées sous forme de tableaux JSON bruts peuvent toujours être interrogées avec JSON_PARSE et UNNEST. Les nouvelles données ingérées via le connecteur de streaming utilisent le schéma plat décrit dans Schéma des données.