Transfert de fichiers sécurisé
Comme alternative à l'intégration avec le Web SDK, à l'utilisation de l'Event API, ou à l'importation manuelle, vous pouvez automatiser le téléchargement des données de conversion dans la plateforme Rokt via le Rokt Secure FTP. Si vous n'avez pas encore accès au SFTP de Rokt, contactez votre gestionnaire de compte avant de suivre les instructions ci-dessous.
Connexion au SFTP de Rokt
Établir une connexion depuis un ordinateur hôte (par exemple, votre ordinateur portable) à un serveur FTP sécurisé nécessite un logiciel client tiers. Ce tutoriel suggère le client populaire et gratuit FileZilla, disponible pour les systèmes d'exploitation Windows, Mac et Linux.
- Dans votre navigateur, allez sur https://filezilla-project.org/ et cliquez sur Download FileZilla Client.
- Installez FileZilla sur votre ordinateur. Si vous avez déjà FileZilla installé, assurez-vous que vous utilisez la dernière version.
- Contactez votre gestionnaire de compte Rokt pour demander l'accès au SFTP de Rokt. Une fois l'accès accordé, vous devriez recevoir un email de Rokt avec le sujet "Vous avez été autorisé à accéder au serveur SFTP de Rokt."
- Téléchargez le fichier joint et décompressez le fichier crypté en utilisant le mot de passe fourni dans un second email "Email pour le mot de passe du fichier avec instructions."
- Le fichier crypté que vous venez de décompresser contient un fichier
.pem
qui est votre clé pour accéder au dossier SFTP de Rokt.
Les étapes suivantes sont les mêmes pour les systèmes d'exploitation Windows, Mac et Linux et sont basées sur la dernière version de FileZilla.
- Ouvrez FileZilla et allez à
Fichier > Gestionnaire de sites
- À gauche, cliquez sur Nouveau site et remplissez les champs suivants :
Protocole : SFTP – SSH File Transfer Protocol
Hôte : ftp.rokt.com
Port : 22
Fichier clé : Parcourez votre fichier clé local (
.pem
) et sélectionnez-le depuis votre disque local (voir image ci-dessous).
- Cliquez sur Connecter. Vous devriez être connecté et pouvoir voir vos dossiers accessibles pour télécharger des fichiers.
Chemin du fichier et exigences
Les fichiers contenant des événements de conversion doivent être placés dans le chemin de fichier suivant :
Chemin du fichier | Objectif |
---|---|
/upload/conversions | Télécharger les données de conversion sur la plateforme Rokt |
Quelques notes supplémentaires :
- Les fichiers téléchargés sont automatiquement supprimés du dossier une fois traités par le système.
- Nous recommandons de tester votre intégration en utilisant un fichier d'exemple préparé selon le format de fichiers requis.
Format de fichier requis
Les fichiers téléchargés sur le serveur SFTP doivent respecter les normes suivantes pour être traités correctement dans la plateforme de données Rokt.
- Le format de fichier doit être
.csv
ou.txt
- Jeu de caractères UTF-8 (UTF-16 ou UTF-32 avec une marque d'ordre d'octets appropriée)
- La liste des adresses e-mail doit être formatée :
- Dans une seule colonne
- Sans en-tête de colonne
- Les adresses e-mail peuvent être en texte brut ou hachées
- Si vous hachez les adresses e-mail, veuillez vous assurer qu'elles :
- Utilisent l'algorithme de hachage SHA256
- Sont en minuscules et sans espaces avant le hachage
- Sont toutes hachées dans le même format—ne mélangez pas les adresses e-mail en clair et hachées par fichier (les e-mails doivent être tous en clair, ou tous en SHA256)
Tout fichier ne correspondant pas au format ci-dessus sera rejeté par le système de Rokt.