Destination de Data Landing Zone

IMPORTANT
Cette page de documentation fait référence au Data Landing Zone destination. Il y a également un Data Landing Zone source dans le catalogue des sources. Pour plus d’informations, consultez la section Data Landing Zone source la documentation.

Présentation overview

Data Landing Zone est une interface de stockage Azure Blob fournie par Adobe Experience Platform et qui vous permet d’accéder à une fonctionnalité de stockage de fichiers sécurisée basée sur le cloud pour exporter des fichiers hors de Platform. Vous avez accès à un conteneur Data Landing Zone par sandbox et le volume total de données sur tous les conteneurs est limité au total des données fournies avec votre licence Produits et Services Platform. Tous les clients de Platform et ses services d’application tels que Customer Journey Analytics, Journey Orchestration, Intelligent Services et Real-Time Customer Data Platform sont configurés avec un conteneur Data Landing Zone par sandbox. 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 et ses données sont protégées par des mécanismes de sécurité du stockage Azure Blob standard au repos et en transit. L’authentification SAS vous permet d’accéder en toute sécurité à votre conteneur Data Landing Zone via une connexion Internet publique. Aucune modification réseau n’est requise pour accéder à votre conteneur Data Landing Zone, ce qui signifie que vous n’avez pas besoin de configurer de listes autorisées ou de configurations inter-régions pour votre réseau.

Platform applique une durée de vie (TTL) stricte de sept jours sur tous les fichiers chargés dans un conteneur Data Landing Zone. Tous les fichiers sont supprimés au bout de sept jours.

Se connecter à Zone d’entrée des données 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 (par exemple votre PPID), tels que choisis 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 .

Conditions préalables prerequisites

Notez les conditions préalables suivantes qui doivent être remplies pour pouvoir utiliser la variable Data Landing Zone destination.

Connectez-vous à Data Landing Zone conteneur à Azure Storage Explorer

Vous pouvez utiliser Azure Storage Explorer pour gérer le contenu de votre Data Landing Zone conteneur. Pour commencer à Data Landing Zone, vous devez d’abord récupérer vos informations d’identification, puis les entrer dans Azure Storage Explorer, puis connectez vos Data Landing Zone conteneur à Azure Storage Explorer.

Dans l’interface utilisateur Azure Storage Explorer, sélectionnez l’icône de connexion dans la barre de navigation de gauche. La fenêtre Sélectionner la ressource s’affiche, vous permettant d’accéder à des options de connexion. Sélectionnez Blob container pour vous connecter à votre espace de stockage Data Landing Zone.

Sélectionnez la ressource mise en surbrillance dans l’interface utilisateur Azure.

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

Sélectionnez la méthode de connexion mise en surbrillance dans l’interface utilisateur Azure.

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

recommendation-more-help

Récupérez les informations d’identification de vos Data Landing Zone retrieve-dlz-credentials

Vous devez utiliser les API Platform pour récupérer vos Data Landing Zone informations d’identification. L’appel API pour récupérer vos informations d’identification est décrit ci-dessous. Pour plus d’informations sur l’obtention des valeurs requises pour vos en-têtes, reportez-vous à la section Prise en main des API Adobe Experience Platform guide.

Format d’API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
Paramètres de requête
Description
dlz_destination
La variable dlz_destination type permet à l’API de distinguer un conteneur de destination de zone d’entrée des autres types de conteneurs disponibles.

Requête

L’exemple de requête suivant récupère les informations d’identification d’une zone d’entrée 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 pour votre zone d’entrée, y compris votre SASToken et SASUri, et la variable storageAccountName qui correspond au conteneur de votre zone d’entrée.

{
    "containerName": "dlz-user-container",
    "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-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
Propriété
Description
containerName
Le nom de votre zone d’entrée.
SASToken
Jeton de signature d’accès partagé pour votre zone d’entrée. Cette chaîne contient toutes les informations nécessaires pour autoriser une requête.
SASUri
URI de signature d’accès partagé pour votre zone d’entrée. Cette chaîne est une combinaison de l’URI de la zone d’entrée pour laquelle vous êtes authentifié et de son jeton SAS correspondant,

Mettre à jour Data Landing Zone informations update-dlz-credentials

Vous pouvez également actualiser vos informations d’identification si vous le souhaitez. Vous pouvez mettre à jour votre SASToken en envoyant une requête de POST à la variable /credentials point d’entrée du Connectors API.

Format d’API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Paramètres de requête
Description
dlz_destination
La variable dlz_destination type permet à l’API de distinguer un conteneur de destination de zone d’entrée des autres types de conteneurs disponibles.
refresh
La variable refresh vous permet de réinitialiser les informations d’identification de votre zone d’entrée et de générer automatiquement une nouvelle SASToken.

Requête

La requête suivante met à jour les informations d’identification de votre zone d’entrée.

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 les valeurs mises à jour pour votre SASToken et SASUri.

{
    "containerName": "dlz-user-container",
    "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-user-container?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, comme renvoyée dans l’appel API décrit ci-dessus, puis sélectionnez Suivant.

Saisissez les informations de connexion mises en surbrillance dans l’interface utilisateur Azure.

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.

Résumé des paramètres affichés dans l’interface utilisateur Azure.

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

Résumé du conteneur utilisateur DLZ mis en surbrillance dans l’interface utilisateur Azure.

Avec votre conteneur Data Landing Zone connecté à Azure Storage Explorer, vous pouvez maintenant commencer à exporter des fichiers d’Experience Platform vers votre conteneur Data Landing Zone. Pour exporter des fichiers, vous devez établir une connexion au Data Landing Zone destination dans l’interface utilisateur de l’Experience Platform, comme décrit dans la section ci-dessous.

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

Assurez-vous que vous avez connecté votre Data Landing Zone conteneur à Azure Storage Explorer comme décrit dans la section conditions préalables . Parce que Data Landing Zone est un stockage configuré par Adobe. Il n’est pas nécessaire d’effectuer d’autres étapes dans l’interface utilisateur de l’Experience Platform pour vous authentifier à 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.

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

  • Chemin d’accès au dossier  : saisissez le chemin d’accès au dossier de destination qui héberge 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 Data Landing Zone 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 vérifier si l’exportation des données a réussi, vérifiez le stockage Data Landing Zone et assurez-vous que les fichiers exportés contiennent les populations de profils attendues.

7f4d1967-bf93-4dba-9789-bb6b505339d6