Destination de Data Landing Zone
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 de ses applications telles que Customer Journey Analytics, Journey Orchestration, Intelligent Services et Real-Time Customer Data Platform sont configurés avec un conteneur Data Landing Zone par environnement de test. 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. SAS signifie signature d’accès partagé.
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.
Connectez-vous à votre stockage Data Landing Zone via l’API ou l’interface utilisateur. connect-api-or-ui
- Pour vous connecter à l’emplacement de stockage Data Landing Zone à l’aide de l’interface utilisateur de Platform, lisez les sections Se connecter à la destination et Activer les audiences vers cette destination ci-dessous.
- Pour vous connecter par programmation à votre emplacement de stockage Data Landing Zone, lisez le tutoriel Activation 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.
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.
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 de fichier des données exportées file-format
Lors de l’exportation de données d’audience, Platform crée un fichier .csv, parquet ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, consultez la section Formats de fichiers pris en charge pour l’exportation du tutoriel sur l’activation de l’audience.
Lors de l’exportation de jeux de données, 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érification de l’exportation des jeux de données réussie du 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 destination Data Landing Zone.
Connectez votre conteneur Data Landing Zone à Azure Storage Explorer
Vous pouvez utiliser Azure Storage Explorer pour gérer le contenu de votre conteneur Data Landing Zone. Pour commencer à utiliser Data Landing Zone, vous devez d’abord récupérer vos informations d’identification, les entrer dans Azure Storage Explorer et connecter votre conteneur Data Landing Zone à 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.
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, vous devez fournir un nom d’affichage et l’URL du conteneur SAS Blob qui correspond à votre conteneur Data Landing Zone.
Récupérez les informations d’identification de votre Data Landing Zone retrieve-dlz-credentials
Vous devez utiliser les API de Platform pour récupérer vos informations d’identification Data Landing Zone. 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, consultez le guide Prise en main des API Adobe Experience Platform .
Format d’API
GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
dlz_destinationdlz_destination 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 vos SASToken et SASUri actuels, et l’ storageAccountName correspondant au conteneur de votre zone d’entrée.
{
"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"
}
containerNameSASTokenSASUriMise à jour des informations d’identification Data Landing Zone 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 au point de terminaison /credentials de l’API Connectors.
Format d’API
POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
dlz_destinationdlz_destination permet à l’API de distinguer un conteneur de destination de zone d’entrée des autres types de conteneurs disponibles.refreshrefresh vous permet de réinitialiser les informations d’identification de votre zone d’entrée et de générer automatiquement un nouveau 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 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 l’URL SAS Data Landing Zone, comme indiqué 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.
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 à la destination Data Landing Zone dans l’interface utilisateur de l’Experience Platform, comme décrit dans la section ci-dessous.
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
Assurez-vous d’avoir connecté votre conteneur Data Landing Zone à Azure Storage Explorer comme décrit dans la section conditions préalables . É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 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 l’option CSV , vous pouvez également configurer les 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 d’exportation, la taille de l’exportation, etc. Le manifeste est nommé au format
manifest-<<destinationId>>-<<dataflowRunId>>.json. Affichez un exemple de fichier manifeste. Le fichier de manifeste comprend les champs suivants :flowRunId: exécution de 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
-
Pour activer les données, vous avez besoin des , Activer les destinations, et autorisations de contrôle d’accès. 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 avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
Voir Activation des données d’audience vers des destinations d’exportation de profil de lot 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.