Importation des conversions via le transfert de fichiers
En tant qu'alternative à l'intégration avec le Web SDK, l'utilisation de l'API d'événements, ou la réalisation d'une 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, veuillez contacter 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
.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 les événements de conversion doivent être placés dans le chemin de fichier suivant:
| Chemin du fichier | Objectif |
|---|---|
| /upload/conversion | Télécharger les données de conversion dans 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 vous recommandons de tester votre intégration en utilisant un fichier d'échantillon 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
.csvou.txt - Jeu de caractères UTF-8 (UTF-16 ou UTF-32 avec un marqueur d'ordre de byte approprié)
- La liste des adresses e-mail doit être formatée comme suit :
- Dans une seule colonne
- Sans en-tête de colonne
- Les adresses e-mail peuvent être du texte brut ou hachées
- Si vous hachez les adresses e-mail, veuillez vous assurer qu'elles respectent les critères suivants :
- Utilisez l'algorithme de hachage SHA256
- Sont en minuscules et sans espaces avant le hachage
- Sont toutes hachées de la même manière - ne mélangez pas les adresses e-mail en texte brut et hachées dans le même 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.