Extensions de segments CDI
Avec Braze Cloud Data Ingestion (CDI), vous pouvez configurer une connexion directe depuis votre entrepôt de données ou votre système de stockage de fichiers vers Braze pour synchroniser les données utilisateur ou de catalogue pertinentes de manière récurrente.
Les extensions de segments CDI interrogent directement votre entrepôt de données. Par conséquent, vous devrez assumer tous les coûts associés à l’exécution de ces requêtes dans votre entrepôt de données. Les extensions de segments CDI n’utilisent pas de crédits de segment SQL, ne sont pas prises en compte dans votre limite d’extension de segments et n’enregistrent pas de points de données.
Conditions préalables
Pour utiliser les données de votre entrepôt de données pour la segmentation dans votre espace de travail Braze, vous devrez créer une source connectée, puis créer un segment CDI dans vos Extensions de segment. Les extensions de segments CDI vous permettent d’écrire du code SQL qui interroge directement votre propre entrepôt de données à l’aide des données mises à disposition via vos connexions CDI, et de créer un groupe d’utilisateurs pouvant être ciblés dans Braze.
Création d’un segment CDI
Étape 1 : Configurez votre source
Avant de créer votre première extension de segment CDI, veuillez configurer une nouvelle source connectée à votre entrepôt de données en suivant les étapes décrites dans la section Sources connectées.
Étape 2 : Créer un segment
Tout d’abord, créez une nouvelle Extension de segment, puis sélectionnez Actualisation complète.
Pour votre source de données, choisissez Tables de données CDI.
Dans le cadre de votre configuration CDI, vous avez la possibilité de choisir parmi différentes connexions à utiliser dans les extensions de segments CDI. Chaque connexion dispose d’un ensemble spécifique de tables de données. Votre équipe de développement peut configurer vos connexions et vos tables de données lors de la configuration de CDI.
Pour consulter les tableaux de données disponibles, y compris leur schéma et les descriptions disponibles, veuillez sélectionner Référence. Lorsque vous êtes prêt, sélectionnez une connexion.
Ensuite, écrivez le SQL pour votre segment en utilisant la syntaxe SQL de Braze.
Veuillez noter que toutes les extensions de segments CDI doivent utiliserexternal_user_id comme colonne sélectionnée, et votreexternal_user_id doit correspondre à celui défini dans Braze pour les utilisateurs.
external_user_id doit être une valeur de chaîne de caractères. Si votre ID source est stocké sous forme de nombre (par exemple,client_idun entier), veuillez le convertir en chaîne de caractères dans votre SQL afin qu’il corresponde auexternal_idtype utilisé dans Braze.
Si les résultats de votre requête incluent des utilisateurs qui n’existent pas dans Braze, ces utilisateurs seront ignorés. Braze ne crée pas de nouveaux utilisateurs sur la base des résultats de vos extensions de segments CDI.
Pour découvrir comment prévisualiser vos extensions de segments, les gérer et actualiser automatiquement l’adhésion, veuillez consulter Extensions de segments SQL.
Enfin, vous pouvez utiliser cette extension de segment dans un segment Braze pour envoyer une campagne ou un Canvas à ce public.
Considérations
- Une extension de segment peut référencer des données provenant d’une seule connexion, pas de plusieurs.
- Une extension de segment peut utiliser l’un des éléments suivants comme source de données : Données CDI ou données Braze Snowflake (Currents). Vous ne pouvez pas mélanger les sources de données dans une extension de segment, mais vous pouvez créer plusieurs extensions de segment à référencer ensemble dans un segment.
Résolution des problèmes
- Votre requête peut expirer lorsqu’elle atteint votre temps d’exécution maximum, lequel est configuré pour chaque synchronisation de connexion sur la page Cloud Data Ingestion. La durée maximale autorisée est de 60 minutes.
- Assurez-vous que votre SQL est écrit en utilisant une syntaxe appropriée pour votre entrepôt de données.
Modifier cette page sur GitHub