Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Synchroniser les objets de données avec l’ingestion de données cloud

Utilisez cette page pour synchroniser les enregistrements d’objets de données et leurs relations depuis votre source vers Braze avec l’ingestion de données cloud (CDI). Les objets de données vous permettent de stocker des enregistrements métier, comme des comptes, et de les associer à vos utilisateurs. Pour en savoir plus sur le modèle d’objet sous-jacent et les endpoints d’API, consultez Objets de données.

Types de synchronisation

Les objets de données utilisent trois types de synchronisation. Chacun correspond à une synchronisation distincte dans Braze, avec sa propre table ou requête source et sa propre planification.

Type de données	Ce que représente chaque ligne	Identifiants requis
Objets de données	Un enregistrement d’objet de données, par exemple un compte.	`OBJECT_ID`
Relations entre objets de données et utilisateurs	Un lien entre un enregistrement et un utilisateur.	`OBJECT_ID` et au moins un identifiant utilisateur
Relations entre objets de données	Un lien entre deux enregistrements de types identiques ou différents.	`OBJECT_ID` et `RELATED_OBJECT_ID`

Synchronisez les enregistrements avant les relations qui y font référence. Une ligne de relation dont l’enregistrement n’existe pas encore est mise en attente et réessayée plutôt qu’appliquée.

Avant de créer une synchronisation

La CDI ne crée ni ne modifie les champs des objets de données pendant une synchronisation : configurez-les donc au préalable.

Dans Paramètres des données > Comptes, ajoutez chaque champ et chaque champ de relation que vous prévoyez d’envoyer. Ne marquez un champ comme obligatoire que si chaque ligne possède une valeur pour celui-ci.
Dans votre source, créez la table ou la vue pour chaque synchronisation, ou préparez la requête que vous écrirez directement depuis la CDI.

Créer la synchronisation

Accédez à Paramètres des données > Ingestion de données cloud > Synchronisations, puis sélectionnez Créer une synchronisation de données.
Saisissez un nom et sélectionnez votre source.
Pour Type de données, sélectionnez Objets de données, Relations entre objets de données et utilisateurs ou Relations entre objets de données.
Sélectionnez le Type d’objet de données pour une synchronisation d’enregistrements, ou le Nom de la relation pour l’une ou l’autre des synchronisations de relations. Les noms de relation affichent la relation suivie des deux types qu’elle relie, par exemple User (Account-User) ou Subaccount (Account-Account).
À l’étape Définition des données, choisissez un mode de synchronisation. Les synchronisations d’objets de données prennent en charge les modes Table et SQL sur les sources d’entrepôt de données. Le mappeur visuel n’est pas disponible pour les synchronisations d’objets de données.
Sélectionnez Prévisualiser et valider, puis poursuivez avec les notifications et la planification.

Colonnes sources

UPDATED_AT - L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.
OBJECT_ID - L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeur object_id utilisée dans Braze pour ce type d’objet de données.
payload - Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.
DELETED - Lorsque la valeur est true, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou à false pour les lignes que vous souhaitez créer ou mettre à jour.

Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.

Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.

Pour les définitions de colonnes et des exemples de DDL dans le dialecte SQL de votre source, consultez la page de votre source.

Identifiants des relations utilisateur

Une ligne de relation utilisateur nécessite OBJECT_ID ainsi qu’au moins un identifiant utilisateur : EXTERNAL_ID, la combinaison de ALIAS_NAME et ALIAS_LABEL, EMAIL ou PHONE.

Validation

Lorsque vous sélectionnez Prévisualiser et valider, Braze compare les colonnes renvoyées par votre table ou votre requête aux champs définis sur le type d’objet de données. Vous ne pouvez pas aller au-delà de l’étape Définition des données tant que la validation n’a pas réussi.

Erreur	Cause	Solution
Des champs obligatoires sont manquants ou nuls dans votre requête	Un champ marqué comme obligatoire sur le type n’a aucune colonne correspondante, ou cette colonne est nulle dans les lignes prévisualisées.	Ajoutez une colonne pour chaque champ obligatoire et assurez-vous que chaque ligne contient une valeur.
Le type d’objet de données ne définit pas les champs suivants	Une colonne ne correspond à aucun champ du type. Les champs sont sensibles à la casse : `TEAM_ID` ne correspond donc pas à `team_id`.	Corrigez le nom de la colonne pour qu’il corresponde exactement au champ, supprimez la colonne ou ajoutez le champ au type dans Braze.
Les champs attendent un type de données différent de celui de votre requête	Le type de données d’une colonne ne correspond pas à celui du champ, par exemple une chaîne de caractères alors que le champ attend un nombre.	Convertissez la colonne dans le type attendu dans votre table source ou votre requête.

Notez que la validation ne vérifie que les 10 premières lignes renvoyées par votre source. Les lignes qui échouent pendant une synchronisation sont signalées dans les journaux de synchronisation.

Supprimer des enregistrements et des relations

Incluez une colonne DELETED dans votre source pour supprimer des enregistrements ou des relations. Lorsque DELETED vaut true, Braze supprime cet enregistrement ou cette relation au lieu de le mettre à jour. La suppression d’un enregistrement ou d’une relation ne supprime pas les utilisateurs qui y étaient associés.

Configuration de la table pour connaître les colonnes requises et le formatage du payload
Bonnes pratiques pour la planification des synchronisations et l’utilisation efficace des points de données
Journaux de synchronisation et observabilité pour surveiller les exécutions de synchronisation
FAQ pour les questions fréquentes communes à toutes les sources

New Stuff!