Comparer les options d’ingestion de données persistante et sans copie
Avant de concevoir vos pipelines d’ingestion, choisissez comment les données de votre entrepôt ou de vos applications parviennent à Braze : copiées sur les profils utilisateur, interrogées sur place pour la segmentation ou transmises de manière transitoire dans un Canvas.
À propos de cet exemple
MovieCanon est un service fictif de streaming de films. Il centralise les données clients, de billetterie et de visionnage dans un entrepôt de données. L’équipe data doit choisir 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 sont conservés sur les profils utilisateurs Braze.
- Création d’audience : Segments basés sur SQL à partir des tables de l’entrepôt, sans copier chaque colonne dans Braze.
- Envoi de messages déclenchés : Lignes de l’entrepôt qui doivent entrer dans un Canvas avec une personnalisation propre à chaque ligne, sans avoir besoin d’être stockées sur le profil.
Braze propose quatre principales méthodes d’ingestion. Les synchronisations standard de Cloud Data Ingestion (CDI) et l’API /users/track conservent toutes deux les données sur les profils. Les Segments CDI (Connected Sources) et les déclencheurs de Canvas CDI sont des options zéro copie : les données restent dans votre entrepôt et ne sont pas écrites dans les profils utilisateurs Braze.
Utilisez cette comparaison pour planifier votre architecture, dimensionner le débit ou expliquer les compromis aux parties prenantes en ingénierie et en marketing. Elle ne remplace pas les guides de configuration de l’intégration propres à chaque option.
Considérations
- Cloud Data Ingestion regroupe plusieurs fonctionnalités. Les synchronisations CDI standard copient les données dans les profils Braze (comme
/users/track). Les Segments CDI et les déclencheurs Canvas CDI laissent les données dans votre entrepôt, sans les écrire dans les profils utilisateurs Braze. - Les synchronisations récurrentes CDI peuvent s’exécuter jusqu’à toutes les 5 minutes, ou seulement une fois par mois. Par défaut, l’intervalle le plus court disponible dans le tableau de bord est de 15 minutes, ce qui vous aide à maîtriser les coûts de calcul de votre entrepôt et le volume de requêtes. Pour synchroniser 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 une fois le chargement de votre entrepôt terminé. Consultez Braze Cloud Data Ingestion.
- Les déclencheurs Canvas CDI partagent la limite de débit REST API de
/canvas/trigger/sendavec le reste du trafic vers cet endpoint./users/trackdispose 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. Les coûts de calcul de l’entrepôt sont à votre charge ; Braze n’enregistre pas de points de données pour ces requêtes. Consultez Sources connectées.
Configuration
Étape 1 : Associer votre cas d’usage à une méthode d’ingestion
Associez votre objectif à la méthode d’ingestion recommandée et vérifiez si cette méthode écrit des données dans les profils Braze.
| Votre objectif | Méthode recommandée | Écriture dans les profils ? |
|---|---|---|
| Conserver des attributs, des événements, des achats ou des éléments de catalogue provenant de l’entrepôt | Synchronisation CDI standard | Oui (les données sont copiées dans les profils ou catalogues Braze) |
| Créer des audiences à partir de SQL d’entrepôt sans copier les tables sources dans Braze | Segments CDI (sources connectées) | Non (appartenance uniquement) |
| Faire entrer des utilisateurs dans un Canvas avec un contexte de ligne d’entrepôt qui ne doit pas être conservé dans le profil | Déclencheurs Canvas CDI | Non (propriétés de contexte Canvas temporaires) |
| Envoyer des données depuis des applications, des serveurs ou des pipelines de streaming en temps quasi réel | /users/track (ou SDK) |
Oui (les données sont conservées dans les profils) |
Étape 2 : Comparer la persistance, la latence et le débit
Comparez la façon dont chaque méthode gère la résidence des données, la latence, le débit et la création d’utilisateurs.
| Dimension | Synchronisation CDI standard | Segments CDI | Déclencheurs Canvas CDI | /users/track |
|---|---|---|---|---|
| Fonctionnement | Lecture planifiée d’une table d’entrepôt ; écrit des attributs, des événements, des achats, des suppressions d’utilisateurs ou des catalogues | Braze interroge votre entrepôt pour les extensions de segments SQL | Les lignes de l’entrepôt déclenchent l’entrée dans un Canvas, avec le contexte de la ligne transmis sous forme de propriétés de contexte Canvas | Les applications, serveurs ou pipelines de streaming écrivent des attributs, des événements et des achats dans les profils |
| Résidence des données | Copiées et conservées dans les profils Braze | Restent dans votre entrepôt ; rien n’est écrit dans les profils | Les propriétés de contexte Canvas sont temporaires et ne sont pas conservées dans les profils | Copiées et conservées dans les profils Braze |
| Latence habituelle | S’exécute selon une planification (jusqu’à toutes les 5 minutes ; 15 minutes par défaut) ou à la demande via l’endpoint de déclenchement d’une synchronisation. La fraîcheur des données 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 au moment de la dernière actualisation. | S’exécute selon la planification de la synchronisation (jusqu’à toutes les 5 minutes ; 15 minutes par défaut). | Temps quasi réel (traitement asynchrone) |
| Remarques sur le débit | Résultat complet de la requête à chaque synchronisation ; Braze regroupe les données en lots en interne vers /users/track, /users/delete ou les endpoints de catalogue |
Durée d’exécution des requêtes limitée à 60 minutes par source connectée ; aucune limite d’objets par requête | Partage la limite de débit de /canvas/trigger/send ; environ 3,75 millions d’entrées Canvas par heure et par exécution de synchronisation |
Jusqu’à 75 objets combinés par requête ; consultez les limites de débit de l’API |
| Taille des lots | Aucune limite par objet côté CDI pour les lectures d’entrepôt | Sans objet (le résultat de la requête définit l’appartenance) | Une entrée Canvas par ligne d’entrepôt et 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 l’option de mise à jour des utilisateurs existants uniquement est activée | Non (les utilisateurs inconnus dans les résultats de la requête sont ignorés) | Non (utilisateurs Braze existants uniquement) | Oui, sauf si _update_existing_only est défini sur true |
Étape 3 : Comparer les exigences en matière de schéma et d’identifiants
Comparez les colonnes requises et les identifiants pris en charge pour chaque méthode. Configurez un seul 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 | Segments CDI | Déclencheurs Canvas CDI | /users/track |
|---|---|---|---|---|
| Colonnes requises / structure | Identifiant utilisateur + UPDATED_AT + payload (JSON) par ligne |
Le SQL doit renvoyer uniquement external_user_id |
Identifiant + UPDATED_AT + PROPERTIES (JSON ; utilisez {} si vide) |
Corps de requête /users/track standard |
| 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 : Mettre en œuvre la méthode choisie
- Synchronisation CDI standard : Créez une table ou une vue dans l’entrepôt, puis suivez les étapes de configuration de votre source d’ingestion de données cloud et de la configuration des tables.
- Segments CDI : Ajoutez une source connectée, puis créez une extension de segment CDI.
- Déclencheurs Canvas CDI : Configurez une table source avec
PROPERTIES, créez et lancez un Canvas de destination, puis créez une synchronisation en suivant Personnalisation zero-copy avec CDI. /users/track: Envoyez des requêtes depuis votre application ou votre middleware. Formatez les payloads conformément à POST : Créer et mettre à jour des utilisateurs.
Pour MovieCanon, une approche courante consiste à utiliser des synchronisations CDI standard pour l’enrichissement nocturne des profils, des Segments CDI pour les règles d’audience basées uniquement sur l’entrepôt, des déclencheurs Canvas pour les parcours liés au statut des billets ou au visionnage avec un contexte au niveau de la ligne, et /users/track pour les événements d’application en temps réel.