Importer des conversions via transfert de fichier
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 Rokt SFTP, contactez votre gestionnaire 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) vers 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, accédez à https://filezilla-project.org/ et cliquez sur Télécharger FileZilla Client.
- Installez FileZilla sur votre ordinateur. Si vous avez déjà FileZilla installé, assurez-vous d'utiliser la dernière version.
- Contactez votre gestionnaire de compte Rokt pour demander l'accès au SFTP de Rokt. Une fois que vous aurez obtenu l'accès, vous devriez recevoir un e-mail de Rokt avec pour objet "Vous avez obtenu l'accès au serveur SFTP de Rokt".
- Téléchargez le fichier joint et décompressez le fichier chiffré à l'aide du mot de passe fourni dans un deuxième e-mail intitulé "E-mail contenant le mot de passe pour le fichier avec les 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 depuis votre disque local (voir l'image ci-dessous).
- Cliquez sur Connexion. Vous devriez être connecté et pouvoir voir les dossiers accessibles pour télécharger des fichiers.
Chemin de fichier et exigences
Les fichiers contenant des événements de conversion doivent être placés dans le chemin de fichier suivant :
Chemin de fichier | Objectif |
---|---|
/upload/conversions | Télécharger des 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 des 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 (espaces supprimés) avant le hachage
- Sont toutes hachées dans le même format—ne mélangez pas les adresses e-mail en texte brut et 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.