Comparer les options d’ingestion de données persistante et sans copie
Choisissez comment les données de votre entrepôt ou de vos applications atteignent Braze — qu’elles soient copiées sur les profils utilisateur, interrogées sur place pour la segmentation, ou transmises de manière transitoire dans un Canvas — avant de concevoir vos pipelines d’ingestion.
À propos de cet exemple
MovieCanon est un service fictif de streaming de films. Il centralise les données clients, de tickets et de visionnage dans un entrepôt de données. L’équipe data doit décider comment alimenter Braze pour trois besoins courants :
- Données de profil : Niveau de fidélité, valeur vie client et attributs de préférence de genre ou de format qui persistent sur les profils utilisateur Braze.
- Construction d’audience : Segments pilotés par SQL à partir des tables de l’entrepôt, sans copier chaque colonne dans Braze.
- Communication déclenchée : Lignes de l’entrepôt qui doivent entrer dans un Canvas avec une personnalisation propre à chaque ligne, sans avoir besoin de stocker ces données sur le profil.
Braze propose quatre chemins principaux d’ingestion de données. Les synchronisations standard Cloud Data Ingestion (CDI) et l’API /users/track persistent les données sur les profils. Les CDI Segments (Connected Sources) et les déclencheurs CDI Canvas sont des options zero-copy : les données de l’entrepôt restent dans votre entrepôt et ne sont pas écrites sur les profils utilisateur Braze.
Utilisez cette comparaison lorsque vous planifiez votre architecture, dimensionnez le débit ou expliquez les compromis aux parties prenantes techniques et marketing. Elle ne remplace pas les guides de configuration d’intégration pour chaque option.
Considérations
- L’ingestion de données cloud est une fonctionnalité globale. Les synchronisations CDI standard copient les données sur les profils Braze (de façon similaire à
/users/track). Les CDI Segments et les déclencheurs CDI Canvas conservent les données de l’entrepôt en place sans les écrire sur les profils utilisateur Braze. - Les synchronisations récurrentes CDI peuvent s’exécuter aussi souvent que toutes les 5 minutes ou aussi rarement qu’une fois par mois. Par défaut, l’intervalle le plus court que vous pouvez définir dans le tableau de bord est de 15 minutes, ce qui permet de maîtriser vos coûts de calcul d’entrepôt et le volume de requêtes. Pour synchroniser aussi souvent que toutes les 5 minutes, contactez le support Braze ou votre gestionnaire de la satisfaction client. Pour synchroniser dès que vos données changent, appelez l’endpoint Déclencher une synchronisation lorsque le chargement de votre entrepôt est terminé. Consultez Ingestion de données cloud Braze.
- Les déclencheurs CDI Canvas partagent la limitation de débit de la REST API
/canvas/trigger/sendavec le reste du trafic vers cet endpoint./users/trackpossède ses propres limites et règles de traitement par lots. Les limites par défaut peuvent être augmentées. Accédez à Paramètres > API et identifiants > Limites d’API, et consultez Limites de débit de l’API. - Les sources connectées et les extensions de segments CDI exécutent des requêtes dans votre entrepôt. Vous supportez les coûts de calcul de l’entrepôt ; Braze ne comptabilise pas de points de donnée pour ces requêtes. Consultez Sources connectées.
Configuration
Étape 1 : Associer votre cas d’usage à un chemin d’ingestion
Associez votre objectif au chemin d’ingestion recommandé et déterminez si ce chemin écrit des données dans les profils Braze.
| Votre objectif | Chemin recommandé | Écriture sur les profils ? |
|---|---|---|
| Persister des attributs, événements, achats ou éléments de catalogue depuis l’entrepôt de données | Synchronisation CDI standard | Oui (les données sont copiées dans les profils Braze ou les catalogues) |
| Créer des audiences à partir de requêtes SQL dans l’entrepôt sans copier les tables sources dans Braze | CDI Segments (Connected Sources) | Non (appartenance uniquement) |
| Faire entrer des utilisateurs dans un Canvas avec un contexte de ligne d’entrepôt qui ne doit pas persister sur le profil | Déclencheurs CDI Canvas | Non (propriétés de contexte Canvas transitoires) |
| Envoyer des données depuis des applications, serveurs ou pipelines de streaming en quasi-temps réel | /users/track (ou SDK) |
Oui (les données persistent sur les profils) |
Étape 2 : Comparer la persistance, la latence et le débit
Comparez la manière dont chaque chemin gère la résidence des données, la latence, le débit et la création d’utilisateurs.
| Dimension | Synchronisation CDI standard | CDI Segments | Déclencheurs CDI Canvas | /users/track |
|---|---|---|---|---|
| Fonction | Lecture planifiée d’une table d’entrepôt ; écrit des attributs, événements, achats, suppressions d’utilisateurs ou catalogues | Braze interroge votre entrepôt pour des extensions de Segments SQL | Les lignes de l’entrepôt déclenchent l’entrée dans un Canvas avec le contexte de la ligne comme propriétés de contexte Canvas | Les applications, serveurs ou pipelines de streaming écrivent des attributs, événements et achats sur les profils |
| Résidence des données | Copiées et persistées sur les profils Braze | Restent dans votre entrepôt ; rien n’est écrit sur les profils | Les propriétés de contexte Canvas sont transitoires ; non persistées sur les profils | Copiées et persistées sur les profils Braze |
| Latence typique | S’exécute selon une planification (aussi souvent que toutes les 5 minutes ; 15 minutes par défaut) ou à la demande via l’endpoint Trigger a sync. La fraîcheur de l’entrepôt s’applique également. | S’actualise selon la planification de votre extension de Segment. L’appartenance reflète les données de l’entrepôt à partir du dernier rafraîchissement. | S’exécute selon la planification de la synchronisation (aussi souvent que toutes les 5 minutes ; 15 minutes par défaut). | Quasi-temps réel (traitement asynchrone) |
| Notes sur le débit | Résultat complet de la requête par synchronisation ; Braze regroupe en interne vers les endpoints /users/track, /users/delete ou Catalog |
Durée d’exécution de la requête plafonnée à 60 minutes par source connectée ; pas de limite d’objets par requête | Partage la limite de débit /canvas/trigger/send ; environ 3,75 millions d’entrées Canvas par heure par exécution de synchronisation |
Jusqu’à 75 objets combinés par requête ; voir Limites de débit de l’API |
| Taille des lots | Pas de limite d’objets côté CDI pour les lectures d’entrepôt | N/A (le résultat de la requête définit l’appartenance) | Une entrée Canvas par ligne d’entrepôt par exécution de synchronisation | 75 attributs, événements et achats combinés par requête (par défaut) |
| Création d’utilisateurs | Oui, sauf si le mode mise-à-jour-uniquement est activé | Non (les utilisateurs inconnus dans les résultats de la requête sont ignorés) | Non (uniquement les utilisateurs Braze existants) | Oui, sauf si _update_existing_only est true |
Étape 3 : Comparer les exigences de schéma et d’identifiant
Comparez les colonnes requises et les identifiants pris en charge pour chaque chemin. Configurez un type de données par synchronisation CDI standard (par exemple, les attributs dans une intégration et les événements dans une autre).
| Dimension | Synchronisation CDI standard | CDI Segments | Déclencheurs CDI Canvas | /users/track |
|---|---|---|---|---|
| Colonnes requises / format | Identifiant utilisateur + UPDATED_AT + payload (JSON) par ligne |
La requête SQL doit retourner uniquement external_user_id |
Identifiant + UPDATED_AT + PROPERTIES (JSON ; utilisez {} si vide) |
Corps de requête standard /users/track |
| Identifiants pris en charge | external_id, alias d’utilisateur, braze_id, e-mail ou téléphone |
external_user_id uniquement (chaîne de caractères) |
external_id ou alias d’utilisateur uniquement |
external_id, alias d’utilisateur, braze_id, e-mail ou téléphone |
Étape 4 : Implémenter le chemin sélectionné
- Synchronisation CDI standard : Créez une table ou vue dans l’entrepôt, puis suivez Intégrations Cloud Data Ingestion et Configuration des tables.
- CDI Segments : Ajoutez une source connectée, puis créez une extension de Segment CDI.
- Déclencheurs CDI Canvas : Configurez une table source avec
PROPERTIES, créez et lancez un Canvas de destination, puis créez une synchronisation en suivant Personnalisation sans copie avec CDI. /users/track: Envoyez des requêtes depuis votre application ou middleware. Formatez les payloads selon POST : Créer et mettre à jour des utilisateurs.
Pour MovieCanon, un schéma courant est le suivant : synchronisations CDI standard pour l’enrichissement nocturne des profils, CDI Segments pour les règles d’audience reposant uniquement sur l’entrepôt, déclencheurs Canvas pour les parcours de statut de billet ou de visionnage avec un contexte au niveau de la ligne, et /users/track pour les événements applicatifs en temps réel.