Transfert de fichiers sécurisé
En alternative à l'intégration avec le Web SDK, à l'utilisation de l'Event API, ou à un import manuel, 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 Rokt SFTP, contactez votre responsable de compte avant de suivre les instructions ci-dessous.
Connexion au Rokt SFTP
É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, qui est disponible pour les systèmes d'exploitation Windows, Mac et Linux.
- Dans votre navigateur, accédez à https://filezilla-project.org/ et cliquez sur Télécharger le client FileZilla.
- Installez FileZilla sur votre ordinateur. Si vous avez déjà installé FileZilla, assurez-vous d'exécuter la dernière version.
- Contactez votre responsable de compte Rokt pour demander l'accès au Rokt SFTP. Une fois que vous avez obtenu l'accès, vous devriez recevoir un e-mail de Rokt avec l'objet "Vous avez été accordé l'accès au serveur SFTP de Rokt."
- Téléchargez le fichier joint et décompressez le fichier chiffré en utilisant le mot de passe fourni dans un deuxième e-mail "E-mail pour le mot de passe pour le fichier avec instructions."
- Le fichier chiffré que vous venez de décompresser contient un fichier
.pem
qui est votre fichier 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 accédez à
Fichier > Gestionnaire de sites
- À gauche, cliquez sur Nouveau site et remplissez les informations suivantes :
Protocole : SFTP – Protocole de Transfert de Fichiers SSH
Hôte : ftp.rokt.com
Port : 22
Fichier clé : Parcourez votre fichier clé local (
.pem
) et sélectionnez-le sur votre disque local (voir l'image ci-dessous).
- Cliquez sur Se connecter. Vous devriez être connecté et capable de voir vos dossiers accessibles pour télécharger des fichiers.
Chemin des fichiers et exigences
Les fichiers contenant des événements de conversion doivent être placés dans le chemin de fichier suivant :
Chemin des fichiers | 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 exemple préparé selon le format requis.
Format de fichier requis
Les fichiers téléchargés sur le serveur SFTP doivent respecter les normes suivantes afin d'être traités correctement dans la plateforme de données Rokt.
- Le format de fichier doit être
.csv
ou.txt
- Charset UTF-8 (UTF-16 ou UTF-32 avec une marque d'ordre d'octet 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 espace (les espaces ont été supprimés) avant que le hachage n'ait lieu
- Sont toutes hachées dans le même format - ne mélangez pas les adresses e-mail en texte brut et les adresses e-mail hachées par fichier (les e-mails doivent être tous en texte brut ou tous en SHA256)
Tout fichier ne correspondant pas au format ci-dessus sera rejeté par le système de Rokt.
Fichiers Temporaires
Des fichiers 'staging' temporaires peuvent être téléchargés. Tous les fichiers nommés avec un préfixe "." seront considérés comme des fichiers temporaires et ne seront pas traités tant qu'ils ne seront pas renommés sans préfixe ".".