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 :

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.

IMPORTANT
Bien qu’Experience Platform prenne en charge les exportations de données vers des serveurs SFTP, les emplacements de stockage dans le cloud recommandés pour exporter les données sont Amazon S3 et Azure Blob.

Connexion à SFTP 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 de votre choix (par exemple : adresse électronique, numéro de téléphone, nom), tel que sélectionné 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.

Type d’exportation SFTP basé sur un profil mis en surbrillance dans le catalogue 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.

Se connecter à la destination connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des ​et des 🔗 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.

Informations d’authentification authentication-information

Si vous sélectionnez le type d'authentification SFTP avec mot de passe pour vous connecter à votre emplacement SFTP :

Authentification de base de destination SFTP avec mot de passe.

  • Domaine : adresse de l’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.

    Image montrant un exemple de clé PGP correctement formatée dans linterface utilisateur.

Si vous sélectionnez le type d’authentification SFTP avec clé SSH pour vous connecter à votre emplacement SFTP :

Authentification par clé SSH de destination 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.

    Image montrant un exemple de clé PGP correctement formatée dans linterface utilisateur.

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 :

Champs de détails de la destination pour la destination SFTP.

  • Nom : saisissez un nom qui vous aide à identifier cette destination dans l’interface utilisateur de l’Experience Platform ;

  • Description : entrez 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 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 des audiences vers cette destination activate

IMPORTANT
  • 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 🔗.
    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations. {width="100" modal="regular"}

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.

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

Reportez-vous à l’article liste autorisée d’adresses IP si vous devez ajouter des adresses IP d’Adobe à une liste autorisée.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6