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

Remarque

Le connecteur Braze Currents Streaming est disponible sur demande. 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.

Prérequis

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. Après avoir enregistré, copiez l’Unique ID (task_id). Vous aurez besoin de cette valeur à l’étape suivante.

Étape 2 : Créer un export Currents personnalisé dans Braze

L’option Treasure Data Export dans l’interface Braze Currents utilise l’ancienne méthode d’API Postback et n’est plus recommandée. Utilisez Custom Currents Export à la place.

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 en tant que 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 supprime les événements du connecteur et les données sont définitivement perdues.

Interroger vos données

Une fois que les événements circulent, 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 du moment où 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 enregistré 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 avoir lancé le Current :

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

Schéma de 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 par message et de comportement des clients.

La structure du payload des données exportées correspond à la structure du payload des connecteurs HTTP personnalisés. Vous pouvez consulter des exemples de payloads dans le dépôt d’exemples pour les connecteurs HTTP personnalisés.

Migrer depuis l’ancienne méthode Postback

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

1. Effectuez la configuration de l’exportation Currents personnalisée décrite dans cet article.
2. Confirmez que les événements sont bien transmis vers 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 de données.