Connexion Azure Blob
Journal des modifications de destination changelog
Avec la version d’Experience Platform de juillet 2023, la destination Azure Blob fournit de nouvelles fonctionnalités, comme indiqué ci-dessous :
- Prise en charge de l’exportation des jeux de données.
- Options de dénomination de fichier supplémentaires.
- Possibilité de définir des en-têtes de fichier personnalisés dans vos fichiers exportés via l’étape de mappage améliorée.
- Possibilité de personnaliser le formatage des fichiers de données CSV exportés.
Présentation overview
Azure Blob (ci-après dénommé Blob) est la solution de stockage d’objets Microsoft pour le cloud. Ce tutoriel présente les étapes à suivre pour créer une destination Blob à l’aide de l’interface utilisateur de Experience Platform.
Se connecter à votre stockage Azure Blob via l’API ou l’interface utilisateur connect-api-or-ui
- Pour vous connecter à votre emplacement de stockage Azure Blob à 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 Azure Blob par programmation, lisez le tutoriel Activer des audiences vers des destinations basées sur des fichiers à l’aide de l’API Flow Service.
Prise en main
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
-
Experience Data Model (XDM) Système : Cadre normalisé selon lequel Experience Platform organise les données d’expérience client.
- Principes de base de la composition des schémas : découvrez les blocs de création de base des schémas XDM, y compris les principes clés et les bonnes pratiques en matière de composition de schémas.
- Tutoriel sur l’éditeur de schémas : découvrez comment créer des schémas personnalisés à l’aide de l’interface utilisateur de l’éditeur de schémas.
-
Real-Time Customer Profile : fournit un profil de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.
Si vous disposez déjà d’une destination de Blob valide, vous pouvez ignorer le reste de ce document et passer au tutoriel sur l’activation des audiences vers la destination.
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 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.
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.
-
Chaîne de connexion : la chaîne de connexion est requise pour accéder aux données de votre stockage Blob. Le modèle de chaîne de connexion Blob commence par :
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.- Pour plus d’informations sur la configuration de votre chaîne de connexion Blob, consultez Configurer une chaîne de connexion pour un compte de stockage Azure dans la documentation de Microsoft.
-
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.
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 : saisissez un nom qui vous aidera à identifier cette destination.
-
Description : saisissez une description de 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.
-
Conteneur : saisissez le nom du conteneur de Azure Blob Storage à utiliser par cette destination.
-
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.
Activer des audiences vers cette destination activate
-
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 lotspour obtenir des instructions sur l’activation des audiences vers cette destination.
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 Azure Blob et assurez-vous que les fichiers exportés contiennent les populations de profils attendues.