Connexion Google Cloud Storage
Connectez-vous à Google Cloud Storage pour exporter des fichiers de données des applications Adobe CX Enterprise dans vos propres compartiments.
Si vous êtes arrivé à cette page en provenance de 🔗, consultez Activer des audiences à partir de Real-Time CDP Collaboration pour les détails spécifiques à cette application.
Applications Adobe CX Enterprise prises en charge supported-applications
Cette destination est disponible dans les applications Adobe CX Enterprise suivantes :
Vue d’ensemble overview
Créez une connexion sortante active pour Google Cloud Storage à exporter régulièrement des fichiers de données de Adobe Experience Platform dans vos propres compartiments.
Connexion à votre stockage Google Cloud Storage via l’API ou l’interface utilisateur connect-api-or-ui
- Pour vous connecter à l’emplacement de stockage de votre Google Cloud Storage à l’aide de l’interface utilisateur d’Experience Platform, lisez les sections Se connecter à la destination et Activer des audiences vers cette destination ci-dessous.
- Pour vous connecter à votre emplacement de stockage Google Cloud Storage par programmation, lisez le tutoriel Activer des audiences vers des destinations basées sur des fichiers à l’aide de l’API Flow Service.
Audiences prises en charge supported-audiences
Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination. Les audiences prises en charge varient en fonction de l’application Adobe CX Enterprise à partir de laquelle vous les activez vers cette destination.
Real-Time CDP supported-audiences-rtcdp
Les audiences suivantes sont prises en charge lorsque vous activez à partir de Real-Time CDP :
Cette catégorie inclut toutes les origines d’audience en dehors des audiences générées par le Segmentation Service. Découvrez les différentes origines d’audience. Voici quelques exemples :
- audiences de chargement personnalisées importées dans Experience Platform à partir de fichiers CSV,
- les audiences semblables,
- les audiences fédérées,
- les audiences générées dans d’autres applications Experience Platform, telles que Adobe Journey Optimizer,
- et plus encore.
Audiences prises en charge par type de données d’audience :
Real-Time CDP Collaboration supported-audiences-collaboration
Dans Real-Time CDP Collaboration, vous pouvez audiences sources à partir de Adobe Experience Platform ou d’autres sources cloud. Dans Real-Time CDP Collaboration, les audiences sont composées de clés de correspondance . Vous pouvez utiliser ces audiences dans un Collaboration pour des activités de collaboration de données ou de médias achetés.
Type et fréquence d’exportation export-type-frequency
Consultez le tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
Exporter des jeux de données export-datasets
Cette destination prend en charge les exportations de jeux de données. Pour obtenir des informations complètes sur la configuration des exportations de jeux de données, consultez les tutoriels :
Format des données exportées file-format
Lors de l’exportation de données d’audience, Experience Platform crée un fichier .csv, parquet ou .json à l’emplacement de stockage indiqué. Pour plus d’informations sur les fichiers, consultez la section formats de fichiers pris en charge pour l’exportation dans le tutoriel sur l’activation des audiences.
Lors de l’exportation de jeux de données, Experience Platform crée un fichier .parquet ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, consultez la section vérifier la réussite de l’exportation du jeu de données dans le tutoriel sur l’exportation des jeux de données.
Configuration requise pour connecter votre compte Google Cloud Storage prerequisites
Pour connecter Experience Platform à Google Cloud Storage, vous devez d’abord activer l’interopérabilité pour votre compte Google Cloud Storage. Pour accéder au paramètre d’interopérabilité, ouvrez Google Cloud Platform et sélectionnez Paramètres dans l’option Espace de stockage du panneau de navigation.
La page Paramètres s’affiche. À partir de là, vous pouvez voir des informations relatives à votre ID de projet Google et les détails de votre compte Google Cloud Storage. Pour accéder aux paramètres d’interopérabilité, sélectionnez Interopérabilité dans l’en-tête supérieur.
La page Interopérabilité contient des informations sur l’authentification, les clés d’accès et le projet par défaut associé à votre compte de service. Pour générer un nouvel identifiant de clé d’accès et une clé d’accès secrète pour votre compte de service, sélectionnez Créer une clé de compte de service.
Vous pouvez utiliser votre identifiant de clé d’accès nouvellement généré et votre clé d’accès secrète pour connecter votre compte Google Cloud Storage à Experience Platform.
Se connecter à la destination connect
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.
S’authentifier auprès de la destination authenticate
Pour vous authentifier auprès de la destination, renseignez les champs requis et sélectionnez Se connecter à la destination.
-
ID de clé d’accès : chaîne alphanumérique de 61 caractères utilisée pour authentifier votre compte Google Cloud Storage auprès d’Experience Platform. Pour plus d’informations sur la manière d’obtenir cette valeur, lisez la section Conditions préalables ci-dessus.
-
Clé d’accès secrète : chaîne codée en base64 de 40 caractères utilisée pour authentifier votre compte Google Cloud Storage auprès d’Experience Platform. Pour plus d’informations sur la manière d’obtenir cette valeur, lisez la section Conditions préalables ci-dessus.
-
Clé de chiffrement : vous pouvez éventuellement joindre votre clé publique au format RSA pour ajouter un chiffrement à vos fichiers exportés. Vous pouvez voir un exemple de clé correctement formatée dans l’image ci-dessous.
Pour plus d’informations sur ces valeurs, consultez le guide sur les Clés HMAC de Google Cloud Storage. Pour savoir comment générer votre propre identifiant de clé d’accès et votre clé d’accès secrète, reportez-vous à la Google Cloud Storage présentation de la source.
Renseigner les détails de la destination destination-details
Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
-
Nom : renseignez le nom de votre choix pour cette destination.
-
Description : facultatif. Vous pouvez, par exemple, mentionner la campagne pour laquelle vous utilisez cette destination.
-
Nom du compartiment : saisissez le nom du compartiment Google Cloud Storage à utiliser par cette destination.
-
Chemin du dossier : saisissez le chemin du dossier de destination qui hébergera les fichiers exportés.
-
Type de fichier : sélectionnez le format qu’Experience Platform doit utiliser pour les fichiers exportés. Lors de la sélection de l’option CSV, vous pouvez également configurer les options de formatage des fichiers.
-
Format de compression : sélectionnez le type de compression qu’Experience Platform doit utiliser pour les fichiers exportés.
-
Inclure le fichier manifeste : activez cette option si vous souhaitez que les exportations incluent un fichier JSON de manifeste contenant des informations sur l’emplacement d’exportation, la taille d’exportation, etc. Le manifeste est nommé à l’aide du format
manifest-<<destinationId>>-<<dataflowRunId>>.json. Affichez un exemple de fichier de manifeste. Le fichier manifeste comprend les champs suivants :flowRunId: exécution flux de données qui a généré le fichier exporté.scheduledTime: heure en UTC à laquelle le fichier a été exporté.exportResults.sinkPath: chemin d’accès à l’emplacement de stockage où le fichier exporté est déposé.exportResults.name: nom du fichier exporté.size: taille du fichier exporté, en octets.
Activer les alertes enable-alerts
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Autorisations Google Cloud Storage nécessaires required-google-cloud-storage-permission
Pour établir une connexion et exporter des données vers votre emplacement de stockage Google Cloud Storage, vous avez besoin des autorisations Google Cloud Storage suivantes pour vos compartiments :
orgpolicy.policy.getresourcemanager.projects.getresourcemanager.projects.liststorage.managedFolders.createstorage.multipartUploads.abortstorage.multipartUploads.createstorage.multipartUploads.listPartsstorage.objects.createstorage.objects.list
Pour en savoir plus sur le contrôle d’accès et autorisations, consultez Google Cloud Storage.
Activer des audiences vers cette destination activate
Vous pouvez activer des audiences vers cette destination à partir de Real-Time CDP ou d’un projet Real-Time CDP Collaboration.
Activer des audiences depuis Real-Time CDP activate-rtcdp
- Pour activer les données, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
- Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès Afficher le graphique d’identités 🔗.
Consultez Activer les données d’audience vers des destinations d’exportation de profils par lots pour obtenir des instructions sur l’activation des audiences vers cette destination.
Planification scheduling
Dans l’étape Planification, vous pouvez configurer le planning d’exportation pour votre destination Google Cloud Storage et vous pouvez également configurer le nom de vos fichiers exportés.
Mapper les attributs et les identités map
À l’étape Mappage, vous pouvez sélectionner les champs d’attribut et d’identité à exporter pour vos profils. Vous pouvez également choisir de remplacer les en-têtes du fichier exporté par un nom convivial de votre choix. Pour plus d’informations, voir l’étape de mappage dans le tutoriel Activer l’interface utilisateur des destinations par lot.
Activer des audiences depuis Real-Time CDP Collaboration activate-collaboration
Pour obtenir des instructions sur l’activation des audiences vers cette destination à partir d’un projet Real-Time CDP Collaboration, consultez la présentation des destinations Real-Time CDP Collaboration 🔗.
Valider l’exportation des données avec succès exported-data
Pour contrôler que l’exportation des données a bien réussi, vérifiez votre compartiment Google Cloud Storage et assurez-vous que les fichiers exportés contiennent les populations de profils attendues.
Liste autorisée d’adresses IP ip-address-allow-list
Reportez-vous à l’article Adresse IP de la place sur la liste autorisée si vous devez ajouter des adresses IP Adobe à un place sur la liste autorisée.