Importer des conversions via transfert de fichiers
En alternative à l'intégration avec le Web SDK, à l'utilisation de l'Event API ou à la réalisation d'un import manuel, vous pouvez automatiser le téléchargement des données de conversion sur 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) 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
.pemqui 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 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 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 afin d'être traités correctement dans la plateforme de données Rokt.
- Le format du fichier doit être
.csvou.txt - Charset UTF-8 (UTF-16 ou UTF-32 avec une marque d'ordre d'octets appropriée)
- La liste des adresses email doit être formatée :
- Dans une seule colonne
- Sans en-tête de colonne
- Les adresses email peuvent être soit en texte brut soit hachées
- Si vous hachez les adresses email, veuillez vous assurer qu'elles :
- Utilisent l'algorithme de hachage SHA256
- Sont en minuscules et épurées (espace blanc supprimé) avant que le hachage ait lieu
- Sont toutes hachées dans le même format—ne mélangez pas les adresses email en texte brut et hachées par fichier (les emails 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 temporaires de 'staging' peuvent être téléchargés, par exemple, depuis l’intégration SFTP de HighTouch.
Tous les fichiers nommés avec un préfixe "." seront traités comme des fichiers temporaires et ne seront pas traités.