Guide d'intégration des événements SFTP

L'intégration SFTP de Rokt Ads permet aux annonceurs et partenaires technologiques d'envoyer en toute sécurité des données de conversion et d'événements à Rokt sous forme de lots formatés en tant qu'un ou plusieurs fichiers .csv. Envoyer vos données de conversion à Rokt boucle la boucle entre l'exposition publicitaire et les résultats en aval, permettant une meilleure optimisation des campagnes et une performance globale pour les annonceurs dans le réseau Rokt.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Accès à un client SFTP (par exemple, FileZilla, WinSCP, ou ligne de commande sftp)
• Un compte Keybase pour l'échange sécurisé de crédentiels
• Les coordonnées de votre gestionnaire de compte Rokt

1. Créer des fichiers CSV

Préparez des fichiers CSV en suivant ces directives.

Exigences du format de fichier

• Les fichiers doivent respecter les normes de format CSV RFC 4180.
• Formats de fichiers pris en charge :
  • CSV simple (.csv)
  • Archive ZIP contenant un ou plusieurs fichiers CSV (.zip)
  • CSV compressé en Gzip (.csv.gz)
  • Fichiers cryptés PGP avec extension .gpg (par exemple, .csv.gpg ou .csv.gz.gpg). Contactez votre gestionnaire de compte Rokt pour la clé publique de Rokt.
• Taille du fichier : 5 MB – 2 GB (optimal). Divisez les ensembles de données plus volumineux en plusieurs fichiers pour un traitement parallèle.
• Maximum 50 colonnes par fichier.
• Taille maximale de ligne : 80 KB.
• Tous les noms de colonnes doivent être uniques.
• N'utilisez pas de sous-dossiers lors du téléchargement.

Nommage des fichiers

Utilisez la convention de nommage suivante en fonction de votre type de données :

Modèle de nom de fichier	Exemple
<name>-custom_event.csv	purchases-custom_event.csv

attention

Évitez les tirets (-) et les points (.) dans la partie <name> de votre nom de fichier. Le tiret avant custom_event est requis.

Exigences des données

Chaque ligne doit inclure au moins un utilisateur valide.

remarque

Les lignes manquant de valeurs d'identité valides échoueront au traitement. Assurez-vous qu'au moins une colonne d'identité contient une valeur pour chaque ligne.

Champs au niveau racine

Nom de colonne	Valeur d'exemple	Notes
environment	production	Identifiant d'environnement (par exemple, development, production).
ip	8.8.8.8	Adresse IP de l'utilisateur.

Attributs d'événement

Pour les données de conversion/événement, incluez les colonnes suivantes :

Nom de colonne	Valeur d'exemple	Requis	Notes
events.data.timestamp_unixtime_ms	1699123456789	Oui	Horodatage de l'événement en millisecondes Unix.
events.data.event_name	conversion	Oui	Toujours défini sur conversion.
events.data.custom_event_type	transaction	Oui	Toujours défini sur transaction.
events.data.custom_attributes.conversiontype	purchase	Oui	Le type d'action effectuée par l'utilisateur (par exemple, signup, purchase, install).
events.data.custom_attributes.confirmationref	ORD-54321	Oui	Référence unique pour la déduplication.
events.data.custom_attributes.amount	99.99	Non	Montant de la transaction (numérique). Inclure si applicable.

Identités des utilisateurs

Nom de colonne	Valeur d'exemple	Notes
user_identities.email	j.smith@example.com	Adresse e-mail de l'utilisateur (en clair).
user_identities.other	fab1e2e699b3b927cbf875046a64f222	E-mail haché ou autre identifiant. Utilisez SHA-256. Mettez en minuscules et supprimez les espaces de fin avant de hacher.

Attributs utilisateur

Incluez autant que possible des attributs parmi les suivants pour améliorer la correspondance :

Nom de la colonne	Valeur d'exemple	Remarques
user_attributes.FirstName	John	Prénom du client.
user_attributes.FirstNameSha256	fab1e2e699b3b927cbf875046a64f222	Hachage SHA-256 du prénom. Minuscule et supprimez les espaces avant le hachage.
user_attributes.LastName	Doe	Nom de famille du client.
user_attributes.LastNameSha256	fab1e2e699b3b927cbf875046a64f222	Hachage SHA-256 du nom de famille. Minuscule et supprimez les espaces avant le hachage.
user_attributes.Mobile	3125551515	Numéro de téléphone. Accepte les formats 1112345678 ou +1 (222) 345-6789.
user_attributes.MobileSha256	fab1e2e699b3b927cbf875046a64f222	Hachage SHA-256. Format comme 5551234567 (chiffres uniquement, sans indicatif de pays).
user_attributes.Age	33	Âge du client.
user_attributes.Dob	19900717	Date de naissance au format YYYYMMDD.
user_attributes.Gender	M	Genre du client : M, Male, F, ou Female.
user_attributes.City	Brooklyn	Ville du client.
user_attributes.State	NY	État du client (code à deux lettres pour les États-Unis).
user_attributes.Zip	11201	Code postal du client.
user_attributes.Title	Mr	Titre du client : Mr, Mrs, Ms, etc.
user_attributes.Language	en	Code de langue ISO 639-1.
user_attributes.Value	52.25	Valeur monétaire du client.
user_attributes.PredictedLtv	136.23	Valeur à vie prédite du client.

Identités des appareils

Nom de la colonne	Valeur d'exemple	Remarques
device_info.http_header_user_agent	Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X)	Chaîne de l'agent utilisateur du navigateur ou de l'appareil.
device_info.android_advertising_id	38400000-8cf0-11bd-b23e-10b96e40000d	ID publicitaire Google (GAID) pour Android.
device_info.android_uuid	550e8400-e29b-41d4-a716-446655440000	UUID de l'appareil Android.
device_info.ios_advertising_id	38400000-8cf0-11bd-b23e-10b96e40000d	ID publicitaire iOS (IDFA).
device_info.ios_idfv	550e8400-e29b-41d4-a716-446655440000	Identifiant iOS pour le fournisseur (IDFV).

Fichiers CSV d'exemple

Téléchargez un fichier d'exemple à utiliser comme modèle :

RoktSample-custom_event.csv

2. Obtenez les identifiants SFTP

Rokt utilise Keybase pour l'échange sécurisé d'identifiants.

Détails du serveur SFTP :

• Hôte : sftp://sftp.us2.mparticle.com
• Port : 4422

Clients SFTP (par exemple FileZilla, WinSCP)

Lorsque vous utilisez un client SFTP graphique, utilisez Hôte sftp.us2.mparticle.com, Protocole SFTP, et Port 4422 (ou collez sftp://sftp.us2.mparticle.com si votre client accepte une URL complète). Entrez le nom d'utilisateur et le mot de passe de votre gestionnaire de compte lorsque vous y êtes invité.

Pour obtenir vos identifiants :

1. Créez un compte Keybase sur keybase.io en utilisant votre email professionnel.
2. Partagez votre nom d'utilisateur Keybase avec votre gestionnaire de compte Rokt.
3. Votre gestionnaire de compte vous enverra vos identifiants SFTP via le chat chiffré de Keybase.

astuce

Gardez vos identifiants sécurisés. Ne les partagez pas par email ou d'autres canaux non chiffrés.

3. Téléversement des fichiers CSV

1. Connectez-vous au serveur SFTP :

sftp -P 4422 your_username@sftp.us2.mparticle.com

2. Naviguez vers ou créez la structure de dossier de dépôt :

cd drop
mkdir US2-123456789123456789  # Use the folder name provided by your Account Manager
cd US2-123456789123456789

3. Téléversez vos fichiers CSV :

put purchases-custom_event.csv

attention

Vérifiez qu'il n'y a pas d'espaces en fin de nom de dossier. Le nom du dossier est sensible à la casse.

Ce qui se passe ensuite

Les fichiers sont ajoutés à la file d'attente de traitement immédiatement après le téléversement. Contactez votre gestionnaire de compte Rokt si vous avez besoin de vérifier le traitement réussi ou si vous rencontrez des problèmes.