Connexion Google Cloud Storage

Présentation overview

Créez une connexion sortante active vers Google Cloud Storage pour exporter régulièrement des fichiers de données depuis Adobe Experience Platform dans vos propres compartiments.

Se connecter à Google Cloud Storage stockage via l’API ou l’interface utilisateur connect-api-or-ui

Audiences prises en charge supported-audiences

Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.

Origine de l’audience
Pris en charge
Description
Segmentation Service
Audiences générées par l’Experience Platform Segmentation Service.
Chargements personnalisés
Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation export-type-frequency

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Élément
Type
Notes
Type d’exportation
Basé sur les profils
Vous exportez tous les membres d’un segment, ainsi que les champs de schéma applicables, tel que sélectionné dans l’écran de sélection des attributs de profil du workflow d’activation de destination.
Fréquence des exportations
Lot
Les destinations par lots exportent des fichiers vers des plateformes en aval par incréments de trois, six, huit, douze ou vingt-quatre heures. En savoir plus sur les destinations basées sur des fichiers par lots.

Exportation de 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 de fichier des données exportées file-format

Lors de l’exportation données d'audience, Platform crée une .csv, parquet, ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, voir Formats de fichiers pris en charge pour l’exportation dans le tutoriel sur l’activation de l’audience.

Lors de l’exportation jeux de données, Platform crée une .parquet ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, voir vérification de l’exportation réussie 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 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 depuis les options de l’espace de stockage dans le panneau de navigation.

Tableau de bord de Google Cloud Platform avec l’espace de stockage et les paramètres mis en surbrillance.

La page des 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.

Onglet Interopérabilité mis en surbrillance dans le tableau de bord de Google Cloud Platform.

Le 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.

Commande Créer une clé de compte de service mise en surbrillance dans le tableau de bord de Google Cloud Platform.

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 à Platform.

Se connecter à la destination connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin de l’événement Affichage des destinations et Gestion des destinations autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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 de 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 de 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.

    Image montrant un exemple de clé PGP correctement formatée dans l’interface utilisateur

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 section 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 que cette destination doit utiliser.

  • Chemin d’accès au dossier  : saisissez le chemin d’accès au dossier de destination qui hébergera les fichiers exportés.

  • Type de fichier: sélectionnez le format que l’Experience Platform doit utiliser pour les fichiers exportés. Lorsque vous sélectionnez la variable CSV , vous pouvez également configuration des options de formatage de fichier.

  • Format de compression: sélectionnez le type de compression que l’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 manifeste contenant des informations sur l’emplacement de l’exportation, la taille de l’exportation, etc. Le manifeste est nommé au format manifest-<<destinationId>>-<<dataflowRunId>>.json. Afficher un exemple de fichier manifeste. Le fichier de manifeste comprend les champs suivants :

    • flowRunId: la variable exécution du 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 dans 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.

Activer des audiences vers cette destination activate

IMPORTANT

Voir Activation des 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

Dans l’étape Planifier, 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

Dans 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.

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

Voir LISTE AUTORISÉE d’adresses IP article si vous devez ajouter des adresses IP d’Adobe à une liste autorisée.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6