Destination de Data Landing Zone

Exportez les fichiers de données des applications Adobe CX Enterprise vers votre emplacement d’espace de stockage dans le cloud Data Landing Zone.

Applications Adobe CX Enterprise prises en charge supported-applications

Cette destination est disponible dans les applications Adobe CX Enterprise suivantes :

Fonctionnement de Data Landing Zone overview

Data Landing Zone est une interface de stockage dans le cloud fournie par Adobe Experience Platform. Utilisez-le pour exporter des fichiers d’Experience Platform vers un emplacement de stockage de fichiers sécurisé dans le cloud. Experience Platform et ses applications, telles que Customer Journey Analytics, Journey Orchestration, Intelligent Services et Real-Time Customer Data Platform, fournissent un conteneur Data Landing Zone par sandbox. Le volume total de données sur tous les conteneurs est limité au total des données fournies avec votre licence Produits et Services Experience Platform.

Experience Platform supprime automatiquement tous les fichiers d’un conteneur Data Landing Zone après sept jours. Vous pouvez également supprimer manuellement les fichiers exportés avant la fin des sept jours.

Le connecteur de destination Data Landing Zone est disponible pour Experience Platform s’exécutant sur Azure ou Amazon Web Services (AWS). Le mécanisme d’authentification dépend du cloud dans lequel la destination est configurée. Tout le reste concernant la destination et ses cas d’utilisation est identique. Pour en savoir plus sur les deux mécanismes d’authentification, consultez les sections Authentification à la zone d’atterrissage de données configurée dans Azure Blob et Authentification à la zone d’atterrissage de données configurée par AWS.

{modal="regular"}

Connexion à votre stockage Data Landing Zone 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. 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 :

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.

Authentification à la zone d’atterrissage de données configurée dans Azure Blob authenticate-dlz-azure

Vous pouvez lire et écrire des fichiers dans votre conteneur via Azure Storage Explorer ou votre interface de ligne de commande.

Data Landing Zone prend en charge l’authentification SAS. Les mécanismes de sécurité du stockage Azure Blob standard protègent ses données au repos et en transit. SAS signifie signature d’accès partagé.

Pour protéger vos données sur une connexion Internet publique, utilisez l’authentification SAS pour accéder en toute sécurité à votre conteneur Data Landing Zone. Vous n’avez pas besoin d’apporter de modifications au réseau pour accéder à votre conteneur Data Landing Zone. Cela signifie que vous n’avez pas besoin de configurer de places sur la liste autorisée ou de configurations inter-régions pour votre réseau.

Connecter votre conteneur Data Landing Zone à Azure Storage Explorer connect-container-to-storage-explorer

Utilisez l’Explorateur de stockage Azure 🔗 pour gérer le contenu de votre conteneur de Data Landing Zone. Pour commencer à utiliser Data Landing Zone, commencez par récupérer vos informations d’identification. Ensuite, saisissez-les dans le Azure Storage Explorer pour connecter votre conteneur Data Landing Zone.

Dans Azure Storage Explorer, ouvrez la boîte de dialogue de connexion. La fenêtre Sélectionner la ressource s’affiche, répertoriant les ressources auxquelles vous pouvez vous connecter. Sélectionnez Blob container pour vous connecter à votre espace de stockage Data Landing Zone.

Ensuite, sélectionnez URL de signature d’accès partagé (SAS) comme méthode de connexion, puis sélectionnez Suivant.

Après avoir sélectionné votre méthode de connexion, indiquez un nom d’affichage et l’URL SAS du conteneur de Blob qui correspond à votre conteneur de Data Landing Zone.

Récupérer les informations d’identification pour votre Data Landing Zone retrieve-dlz-credentials

Utilisez les API d’Experience Platform pour récupérer vos informations d’identification Data Landing Zone, comme décrit dans cette section. Pour plus d’informations sur l’obtention des valeurs requises pour vos en-têtes, consultez le guide Prise en main des API Adobe Experience Platform.

Format d’API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Requête

L’exemple de requête suivant récupère les informations d’identification d’une zone d’atterrissage existante.

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Réponse

La réponse suivante renvoie les informations d’identification de votre zone d’atterrissage, y compris votre SASToken et votre SASUri actuels, ainsi que la storageAccountName correspondant à votre conteneur de zone d’atterrissage.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Mettre à jour les informations d’identification Data Landing Zone update-dlz-credentials

Vous pouvez actualiser vos informations d’identification à tout moment. Pour mettre à jour votre SASToken, envoyez une requête POST au point d’entrée /credentials de l’API Connectors.

Format d’API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

Requête

La requête suivante met à jour vos informations d’identification de zone d’atterrissage.

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Réponse

La réponse suivante renvoie des valeurs mises à jour pour vos SASToken et SASUri.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

Indiquez votre nom d’affichage (containerName) et Data Landing Zone URL SAS, tel que renvoyé dans l’appel API décrit ci-dessus, puis sélectionnez Suivant.

La fenêtre Résumé s’affiche, vous donnant ainsi une présentation de vos paramètres, y compris des informations sur votre point d’entrée et vos autorisations Blob. Quand vous avez terminé, sélectionnez Se connecter.

Une connexion réussie met à jour l’interface utilisateur Azure Storage Explorer avec votre conteneur Data Landing Zone.

Une fois votre conteneur Data Landing Zone connecté à Azure Storage Explorer, vous pouvez commencer à exporter des fichiers d’Experience Platform vers votre conteneur Data Landing Zone. Pour exporter des fichiers, connectez-vous à la destination Data Landing Zone dans l’interface utilisateur d’Experience Platform, comme décrit dans la section ​ Se connecter à la destination ​.

Authentification à la zone d’atterrissage de données configurée par AWS authenticate-dlz-aws

Suivez les étapes de cette section pour obtenir des informations d’identification pour votre instance Data Landing Zone configurée sur AWS. Ensuite, utilisez un client de votre choix pour vous connecter à votre instance Data Landing Zone.

Récupérer les informations d’identification pour votre Data Landing Zone retrieve-dlz-credentials-aws

Utilisez les API d’Experience Platform pour récupérer vos informations d’identification Data Landing Zone, comme décrit dans cette section. Pour plus d’informations sur l’obtention des valeurs requises pour vos en-têtes, consultez le guide Prise en main des API Adobe Experience Platform.

Format d’API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Requête

L’exemple de requête suivant récupère les informations d’identification d’une zone d’atterrissage existante.

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

Réponse

La réponse suivante renvoie les informations d’identification de votre zone d’atterrissage, y compris votre awsAccessKeyId actuelle, votre awsSecretAccessKey et d’autres informations.

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

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

Si votre Data Landing Zone est configuré dans Azure, assurez-vous d’avoir connecté votre conteneur de Data Landing Zone à Azure Storage Explorer, comme décrit dans la section Connecter votre conteneur de zone d’atterrissage de données à l’explorateur de stockage Azure. Étant donné que Data Landing Zone est un stockage configuré par Adobe, vous n’avez pas besoin d’effectuer d’autres étapes dans l’interface utilisateur d’Experience Platform pour vous authentifier auprès de la destination.

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.

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 pour vous abonner et recevoir 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

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

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 Data Landing Zone 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 la réussite de l’export des données exported-data

Pour vérifier que l’exportation a réussi, vérifiez le stockage Data Landing Zone et assurez-vous que les fichiers exportés contiennent les populations de profils attendues.

Supprimer les fichiers exportés delete-exported-files

Experience Platform supprime automatiquement les fichiers exportés de votre conteneur Data Landing Zone au bout de sept jours. Vous pouvez également supprimer manuellement des fichiers de votre conteneur avant l’expiration de la période de sept jours. La suppression manuelle est disponible pour les conteneurs Data Landing Zone configurés dans Azure et AWS.