Synchroniser et supprimer des données de catalogue

Cette page explique comment synchroniser des données de catalogue avec l’ingestion de données cloud (CDI). Les synchronisations de catalogue sont prises en charge pour toutes les sources CDI, et le format de la table ou du fichier source propre à chacune est documenté sur la page de cette source.

Étape 1 : Créer un nouveau catalogue

Avant de créer une nouvelle intégration CDI pour les catalogues, vous devez créer un nouveau catalogue ou identifier un catalogue existant à utiliser pour l’intégration. Il existe plusieurs façons de créer un nouveau catalogue, et chacune d’entre elles fonctionne pour l’intégration CDI :

• Téléchargez un fichier CSV
• Créez un catalogue dans le tableau de bord de Braze ou pendant la configuration de CDI.
• Créez un catalogue à l’aide de l’endpoint Créer un catalogue

Toute modification du schéma du catalogue (par exemple, l’ajout de nouveaux champs ou le changement de type d’un champ) doit être effectuée dans le tableau de bord du catalogue avant que les données mises à jour ne soient synchronisées via CDI. Braze recommande d’effectuer ces mises à jour lorsque la synchronisation est en pause ou n’est pas planifiée, afin d’éviter les conflits entre les données de votre entrepôt de données et le schéma dans Braze.

Étape 2 : Configurer la synchronisation du catalogue

La configuration d’une synchronisation de catalogue suit de près le processus de synchronisation des données utilisateur pour la même source. Ouvrez la page de votre source et sélectionnez l’onglet Articles du catalogue pour la table source ou le format de fichier, puis terminez la configuration sur cette page.

Quelle que soit la source utilisée, les règles suivantes s’appliquent :

• Sélectionnez le type de synchronisation Catalogues lors de la création de la synchronisation.
• Le nom de l’intégration doit correspondre exactement au nom du catalogue que vous avez créé précédemment.
• Si vous disposez déjà d’identifiants issus d’une synchronisation existante, vous pouvez les réutiliser, mais veillez à étendre l’accès à la table source du catalogue.

Colonnes requises

Fonctionnement de l’intégration

Remarque

Le comportement de synchronisation décrit dans cette section s’applique uniquement aux intégrations d’entrepôt de données. Pour le stockage de fichiers, Braze traite les nouveaux fichiers au fur et à mesure de leur chargement dans votre compartiment ou conteneur.

À chaque exécution de la synchronisation, Braze récupère toutes 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.

Braze recommande de créer une vue dans votre entrepôt de données à partir de vos données de catalogue afin de configurer une table source qui s’actualise entièrement à chaque exécution de la synchronisation. Avec les vues, vous n’avez pas besoin de réécrire la requête à chaque fois. Pour un exemple concret dans le dialecte SQL de votre entrepôt, consultez l’onglet Articles du catalogue sur la page de votre source.

Quelle que soit la source utilisée :

• Les données récupérées par l’intégration servent à créer ou à mettre à jour des articles dans le catalogue cible en fonction de l’id fourni.
• Si DELETED est défini sur true, l’article de catalogue correspondant est supprimé.
• La synchronisation ne consomme pas de points de données, mais toutes les données synchronisées sont comptabilisées dans l’utilisation totale de votre catalogue. Cette utilisation est mesurée en fonction du volume total de données stockées : vous n’avez donc pas à vous soucier de ne synchroniser que les données modifiées.