Connexion SFTP
Journal des modifications de destination changelog
Avec la version Experience Platform de juillet 2023, la destination SFTP offre 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
Créez une connexion sortante active à votre serveur SFTP afin d’exporter périodiquement des fichiers de données délimités à partir d’Adobe Experience Platform.
Connexion à SFTP via l’API ou l’interface utilisateur connect-api-or-ui
- Pour vous connecter à votre emplacement de stockage SFTP à l’aide de l’interface utilisateur de Platform, lisez les sections Connexion à la destination et Activer les audiences vers cette destination ci-dessous
- Pour vous connecter à votre emplacement de stockage SFTP par programmation, lisez le Activation des audiences vers des destinations basées sur des fichiers à l’aide du tutoriel 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 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 .
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.
Informations d’authentification authentication-information
Si vous sélectionnez l’option SFTP avec mot de passe type d’authentification pour se connecter à votre emplacement SFTP :
-
Domaine: l’adresse de votre emplacement de stockage SFTP ;
-
Nom d’utilisateur : nom d’utilisateur pour se connecter à l’emplacement de stockage de votre SFTP ;
-
Port : le port utilisé par votre emplacement de stockage SFTP ;
-
Mot de passe : mot de passe pour se connecter à l’emplacement de stockage de votre SFTP.
-
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.
Si vous sélectionnez le type d’authentification SFTP avec clé SSH pour vous connecter à votre emplacement SFTP :
-
Domaine : indiquez l’adresse IP ou le nom de domaine de votre compte SFTP ;
-
Port : le port utilisé par votre emplacement de stockage SFTP ;
-
Nom d’utilisateur : nom d’utilisateur pour se connecter à l’emplacement de stockage de votre SFTP ;
-
Clé SSH : clé SSH privée utilisée pour se connecter à l’emplacement de stockage de votre SFTP. La clé privée doit être une chaîne codée en Base64 au format RSA et ne doit pas être protégée par un mot de passe.
-
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.
Détails de la destination destination-details
Après avoir établi la connexion d’authentification à l’emplacement SFTP, fournissez les informations suivantes pour la destination :
-
Nom: saisissez un nom qui vous aide à identifier cette destination dans l’interface utilisateur de l’Experience Platform ;
-
Description: saisissez une description pour cette destination.
-
Chemin du dossier: saisissez le chemin d’accès au dossier dans votre emplacement SFTP où les fichiers seront 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 des audiences vers cette destination activate
- Pour activer les données, vous avez besoin de l’événement Affichage des destinations, Activation des destinations, Afficher les profils, et Affichage de segments 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 identités, vous avez besoin de la fonction Affichage du graphique des identités autorisation de contrôle d’accès.
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.
Valider l’exportation des données avec succès exported-data
Pour vérifier si les données ont bien été exportées, vérifiez votre stockage SFTP 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.