[Disponibilité limitée]{class="badge informative"}
Configuration des Google Cloud Storage pour l’approvisionnement des audiences
Suivez les étapes de ce guide pour connecter votre compartiment Google Cloud Storage (GCS) à Adobe Real-Time CDP Collaboration et commencer à sourcer les données d’audience propriétaires via l’interface utilisateur.
Connectez un compartiment GCS à Collaboration pour ingérer directement des données d’audience propriétaires sans assistance technique. Une fois connecté, Collaboration extrait les audiences de votre compartiment selon un planning récurrent et les rend disponibles pour l’activation et l’analyse de chevauchement dans vos projets de collaboration. L’approvisionnement de vos audiences est une étape obligatoire avant de pouvoir les activer ou de les utiliser dans une analyse de chevauchement avec des collaborateurs.
Ce guide couvre le workflow de configuration de bout en bout : préparation des conditions préalables, authentification de votre compartiment GCS, révision des champs d’identité mappés automatiquement, planification de l’actualisation des données et confirmation que l’approvisionnement s’est terminé avec succès.
Les audiences provenant de Google Cloud Storage suivent les mêmes règles de gouvernance et de gestion des données que les audiences provenant de Adobe Experience Platform.
D’autres méthodes de source disponibles incluent 🔗, Amazon S3, Snowflake et le chargement de fichier CSV.
Conditions préalables prerequisites
Terminez tous les éléments de cette section avant de démarrer le workflow de configuration. Les prérequis incomplets sont la raison la plus courante de l’échec de la configuration ou de l’absence d’audiences après sourcing. Avant de suivre ce guide, vous devez avoir terminé intégration et configuration du compte.
Certaines étapes de cette section nécessitent l’intervention d’un administrateur Google Cloud. Si vous n’êtes pas l’administrateur Google Cloud de votre organisation, identifiez la personne appropriée avant de commencer.
Accès et autorisations GCS gcs-access-permissions
Avant de poursuivre, vérifiez les points suivants auprès de votre administrateur Google Cloud :
- Adobe a reçu les autorisations requises pour s’authentifier par rapport à votre compartiment GCS et lire les fichiers d’audience.
- Google Cloud Storage’approvisionnement des audiences est disponible dans votre région. La disponibilité varie selon les régions (NA, EMEA, ANZ). Si l’approvisionnement GCS n’est pas encore disponible dans votre région, contactez votre représentant de compte Adobe pour confirmer un calendrier.
Préparation des données d’audience prepare-audience-data
Vos fichiers d’audience doivent être conformes à la Spécification d’approvisionnement de l’audience (v1.2) avant que l’approvisionnement ne commence. Consultez la spécification pour la définition de schéma complète et les exemples au niveau du champ. Les principales exigences sont les suivantes :
- Format de fichier : CSV, en utilisant des virgules comme délimiteurs de champ et des barres verticales (
|) comme séparateurs pour plusieurs valeurs dans un seul champ. - Champs obligatoires : chaque enregistrement doit inclure une colonne
AUDIENCE_IDet au moins une colonne clé de correspondance prise en charge. - Clés de correspondance prises en charge :
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_ID. - Exigences de hachage : toutes les valeurs de clé correspondantes doivent être tronquées, mises en minuscules et hachées SHA256 avant le chargement. Collaboration ne hache ni ne normalise les données avant l’ingestion.
- Cohérence des colonnes : si votre compartiment contient plusieurs fichiers d’audience, tous les fichiers doivent utiliser des structures de colonnes identiques.
Toutes les clés de correspondance présentes dans vos fichiers d’audience doivent également être activées pour votre compte Collaboration. Pour ajouter ou activer des clés de correspondance, voir Configurer des clés de correspondance.
Valeurs requises avant de commencer required-values
Préparez les valeurs suivantes avant de démarrer l’assistant de configuration.
sourcing/testdata/path1/).Configurer votre connexion Google Cloud Storage configure-gcs-connection
Le workflow de configuration est un assistant à plusieurs étapes dans l’espace de travail Configuration. Effectuez chaque étape dans l’ordre. Vous pouvez revenir à n’importe quelle étape à l’aide de l’icône en forme de crayon sur l’écran de révision final avant de créer la connexion.
Ajouter une nouvelle connexion de données add-data-connection
Dans l’onglet Mes audiences de l’espace de travail Configuration, sélectionnez l’icône d’ajout (
) puis sélectionnez Audience.
S’il s’agit de votre première audience, vous pouvez également sélectionner l’option Ajouter.
Le workflow Ajouter une audience s’affiche. Sélectionnez Ajouter une nouvelle connexion de données puis sélectionnez Suivant.
{modal="regular"}
Sélectionnez Google Cloud Storage comme source de données select-gcs
L’écran de sélection de la source de données répertorie tous les types de connexion disponibles. Sélectionnez Google Cloud Storage puis sélectionnez Suivant.
Une boîte de dialogue prérequise décrivant les étapes de configuration requises (par exemple, la configuration du compartiment GCS et l’affectation de rôle IAM) s’affiche et indique que les données doivent être conformes à la Spécification d’approvisionnement d’audience. Sélectionnez Démarrer l’intégration pour confirmer la conformité avant de continuer.
Saisissez les détails de votre connexion Google Cloud Storage authenticate-gcs-connection
Fournissez les détails requis pour permettre à Collaboration d’accéder à votre compartiment Google Cloud Storage. Après avoir saisi les informations requises, sélectionnez Suivant.
Confirmer le consentement et la confirmation d’utilisation des données confirm-consent
Vous devez confirmer que les désinscriptions au consentement ont été supprimées des données d’audience avant que Collaboration puisse les traiter. Si vous ne savez pas si vos données répondent à cette exigence, consultez le guide politique de gouvernance et mesures d’application avant de continuer. Cochez la case de confirmation, puis sélectionnez OK pour continuer.
Fournir les détails de la connexion provide-connection-details
Saisissez un nom et une description facultative pour cette connexion de données. Le nom que vous indiquez apparaît dans l’onglet Mes connexions de données et permet de distinguer cette source si vous gérez plusieurs connexions de données.
- Nom de la connexion de données (obligatoire)
- Description de la connexion de données (facultatif).
Sélectionnez Suivant pour continuer.
Vérifier les champs d’identité mappés automatiquement auto-mapped-fields
L’écran Mappage est en lecture seule. Collaboration mappe automatiquement les champs d’identité source de vos fichiers d’audience aux champs cibles en fonction des noms de colonne définis dans la spécification d’origine d’audience . À ce stade, vous ne pouvez pas ajouter, supprimer ou appliquer de transformations aux champs mappés.
Vérifiez que les mappages affichés reflètent les champs de vos fichiers d’audience. Dans le cas contraire, arrêtez et corrigez vos fichiers pour qu’ils soient conformes à la Spécification d’approvisionnement de l’audience avant de continuer. Sélectionnez Suivant pour continuer.
Planifier l’actualisation des données schedule-data-refresh
Dans la vue Planifier, définissez la fréquence à laquelle Collaboration récupère les données d’audience mises à jour de votre intervalle GCS et définissez la période active pour l’approvisionnement.
Utilisez le menu déroulant Fréquence pour sélectionner la fréquence à laquelle Collaboration récupère les données d’audience mises à jour de votre compartiment GCS. Les intervalles disponibles vont de quotidien à tous les 6 jours.
Saisissez une période dans le champ de saisie ou sélectionnez l’icône de calendrier pour définir la date de début et la date de fin pour la période d’origine active. Lorsque la date de fin est atteinte, le sourcing cesse et les audiences précédemment sourcées expirent et ne sont plus disponibles pour une utilisation dans les projets de collaboration.
Sélectionnez Suivant pour continuer.
Vérifier et terminer la connexion review-and-complete
Consultez le résumé de la configuration avant de créer la connexion. L’écran de résumé affiche les sections suivantes :
- Connexion aux données : informations d’identification du compartiment GCS et chemin d’accès au dossier que vous avez configuré.
- Détails : le nom et la description facultative de cette connexion de données.
- Mapping : champs d’identité source et cible mappés automatiquement.
- Planification : fréquence d’actualisation et période active.
Sélectionnez l’icône en forme de crayon (
) en regard d’une section pour revenir à cette étape et apporter des modifications. Lorsque toutes les sections sont correctes, sélectionnez Terminer.
Une boîte de dialogue de confirmation s’affiche, indiquant que Collaboration a créé la connexion de données et que l’approvisionnement de l’audience est en cours.
Vérifier les audiences sources review-sourced-audiences
Une fois que vous avez terminé l’assistant de configuration, Collaboration commence à sourcer les audiences de votre compartiment GCS de manière asynchrone. Accédez à Configuration > Mes audiences pour surveiller la progression. L’approvisionnement ne se termine pas immédiatement ; le temps requis dépend de la taille de vos données et de la fréquence d’actualisation configurée.
Surveiller la progression de l’approvisionnement des audiences monitor-sourcing-progress
Pendant que Collaboration récupère vos données d’audience, une bannière en haut de l’espace de travail Mes audiences indique que le sourcing est en cours. Les audiences individuelles apparaissent dans la liste uniquement une fois l’approvisionnement terminé pour chaque audience.
Afficher les détails de l’audience source view-audience-details
Une fois le sourcing terminé, vos audiences Google Cloud Storage apparaissent dans l’onglet Mes audiences à côté des audiences provenant d’autres connexions. Sélectionnez un élément de ligne ou Afficher l’audience pour ouvrir la vue détaillée d’une audience spécifique.
La vue détaillée affiche le statut de l’audience, la source et le nom de la connexion aux données, ainsi que les panneaux suivants :
- Identités : nombre total d’identités et répartition de l’audience, une fois que les données sont disponibles.
- Catégories : toutes les balises appliquées pour organiser ou filtrer l’audience.
- Accès de connexion : indique si l’audience est privée, publique ou partagée avec des collaborateurs spécifiques.
- Visibilité des métadonnées : informations sur l’audience telles que le nombre d’identités, le pourcentage de chevauchement et l’index, visibles par les collaborateurs.
Consultez ces paramètres avant d’utiliser l’audience dans un projet de collaboration. Pour mettre à jour les catégories, l’accès aux connexions ou la visibilité des métadonnées, consultez Affichage et gestion des audiences individuelles.
Modifier les paramètres d’audience edit-audience-settings
Vous pouvez modifier les métadonnées d’audience directement à partir de la vue liste Mes audiences sans ouvrir la vue détaillée. Cochez la case d’une audience pour afficher la barre d’outils d’actions, puis sélectionnez une action : Modifier la visibilité des métadonnées, Modifier l’accès à la connexion, Modifier le nom et la description, Modifier les catégories ou Supprimer.
Affichage de la connexion aux données GCS view-gcs-connection
Pour vérifier ou gérer la connexion elle-même, y compris ses clés de correspondance et sa planification, accédez à Configuration > Mes connexions de données. Votre nouvelle connexion GCS y est immédiatement disponible. La source de l’audience s’affiche sous la forme Google Cloud Storage.
Limites connues known-limitations
Tenez compte des contraintes suivantes lors de la configuration et de l’utilisation de l’approvisionnement des audiences Google Cloud Storage :
- Contraintes de clé de correspondance : une fois qu’une clé de correspondance est activée pour une connexion de données, elle ne peut pas être supprimée. Vous pouvez ajouter des clés de correspondance à une connexion existante, mais vous ne pouvez pas les désactiver ni les supprimer. Pour modifier les clés de correspondance actives, vous devez supprimer la connexion de données et en créer une nouvelle.
- Une connexion de données active par source : une seule connexion de données Google Cloud Storage active est prise en charge à la fois. Si vous devez sourcer des audiences à partir d’un autre compartiment, supprimez la connexion existante et créez-en une qui pointe vers le nouveau compartiment.
- Prise en charge des sous-dossiers : les fichiers d’audience doivent se trouver directement dans le chemin d’accès au dossier spécifié. Collaboration ne parcourt pas les sous-dossiers de ce chemin d’accès.
Dépannage troubleshooting
Utilisez cette section pour résoudre les problèmes qui se produisent après l’établissement de la connexion initiale. Pour les erreurs qui se produisent pendant l’authentification, vérifiez vos informations d’identification et vos autorisations de compartiment ou contactez votre administrateur.
Les audiences n’apparaissent pas ou l’approvisionnement prend plus de temps que prévu
- La durée de l’approvisionnement est fonction du volume des données et de la fréquence d’actualisation configurée. Un temps de traitement étendu est attendu pour les jeux de données volumineux.
- Si les audiences ne se sont pas affichées dans les 24 heures, vérifiez que les fichiers d’audience existent dans le chemin de dossier spécifié lors de la configuration et qu’ils sont conformes aux spécifications d’approvisionnement des audiences.
- Vérifiez l’onglet Mes connexions de données pour connaître les indicateurs d’erreur sur la connexion.
- Si le problème persiste après avoir suivi ces étapes, contactez l’assistance clientèle d’Adobe et fournissez le nom de la connexion de données et les détails du compartiment.
La connexion de données affiche le statut En échec après le succès initial
- Vérifiez que les autorisations et informations d’identification de l’intervalle GCS n’ont pas changé depuis que vous avez créé la connexion. Toute modification qui supprime l’accès d’Adobe au compartiment entraîne l’échec des exécutions de sourcing suivantes.
- Vérifiez que les fichiers d’audience existent toujours au niveau du chemin d’accès au dossier configuré et sont conformes aux spécifications d’approvisionnement de l’audience.
- Si le problème persiste après avoir confirmé les autorisations et la disponibilité des fichiers, supprimez la connexion et créez-en une nouvelle, ou contactez l’assistance clientèle d’Adobe.
Des erreurs de format de fichier d’audience se produisent lors d’une actualisation planifiée
- Vérifiez que les fichiers mis à jour dans l’intervalle sont conformes à la structure des colonnes et aux exigences des champs dans la Spécification d’origine d’audience.
- Assurez-vous que tous les fichiers du chemin d’accès au dossier configuré utilisent des structures de colonnes identiques. Des fichiers de formats différents situés dans le même chemin d’accès peuvent provoquer des échecs de sourcing partiel.
Étapes suivantes next-steps
Vous avez configuré Google Cloud Storage comme source de données dans Collaboration. Une fois l’approvisionnement terminé, vos audiences sont disponibles dans l’espace de travail Mes audiences et prêtes à être utilisées dans des projets de collaboration.
Plusieurs possibilités sʼoffrent alors à vous :
Pour d’autres méthodes d’approvisionnement d’audience, voir :