Guide d'intégration des audiences SFTP

L'intégration SFTP de Rokt Ads permet aux annonceurs et partenaires technologiques d'envoyer en toute sécurité des segments d'audience à Rokt par lots formatés sous forme d'un ou plusieurs fichiers .csv, en gardant les données utilisateur synchronisées pour une utilisation dans le ciblage et la suppression des campagnes. Garder les audiences synchronisées avec Rokt Ads conduit à diffuser moins de publicités aux mauvais utilisateurs, ce qui réduit les dépenses inutiles et améliore les performances globales des campagnes.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Accès à un client SFTP (par exemple, FileZilla, WinSCP, ou en ligne de commande sftp)
• Un compte Keybase pour l'échange sécurisé de références

1. Créer des fichiers CSV

Pour garantir que vos données d'audience puissent être envoyées avec succès à Rokt, formatez-les sous forme de fichier CSV selon les directives suivantes :

Exigences de 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 chiffrés PGP avec extension .gpg (par exemple, .csv.gpg ou .csv.gz.gpg). Contactez votre gestionnaire de compte Rokt pour obtenir 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 la ligne : 80 KB.
• Tous les noms de colonnes doivent être uniques.
• Ne pas utiliser de sous-dossiers lors du téléchargement.

Nomination des fichiers

Utilisez la convention de nommage suivante pour vos fichiers :

Modèle de nom de fichier	Exemple
<name>-audience.csv	premium_users-audience.csv

attention

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

Exigences de 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 de niveau racine

Nom de la colonne	Valeur d'exemple	Remarques
environment	production	Identifiant d'environnement (par exemple, development, production).

Identités des utilisateurs

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

Attributs utilisateur

Incluez autant que possible des attributs 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. Mettre en minuscules et supprimer 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. Mettre en minuscules et supprimer 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.

Identités des appareils

Nom de la colonne	Valeur d'exemple	Remarques
device_info.android_advertising_id	38400000-8cf0-11bd-b23e-10b96e40000d	Google Advertising ID (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 pour le vendeur iOS (IDFV).

Attributs d'audience

Pour les données d'audience, incluez les colonnes suivantes :

Nom de la colonne	Valeur d'exemple	Requis	Remarques
external_audience_id	premium_users	Oui	Nom de l'audience.
action	add	Oui	Valeurs acceptées : add ou remove. Utilisez add pour inclure l'utilisateur dans l'audience, ou remove pour l'exclure.
change_timestamp_ms	1713895200000	Non	Horodatage Unix du changement d'appartenance à l'audience (en millisecondes).

Fichiers CSV d'exemple

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

RoktSample-audience.csv

2. Obtenez les identifiants SFTP

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

Détails du serveur SFTP :

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

des clients SFTP (par exemple, FileZilla, WinSCP)

Lors de l'utilisation d'un client SFTP graphique, utilisez Host sftp.us2.mparticle.com, Protocol 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 fournis par votre gestionnaire de compte lorsque cela est demandé.

Pour obtenir vos identifiants :

1. Créez ou connectez-vous à votre compte Keybase sur keybase.io.
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éversez 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 premium_users-audience.csv

attention

Vérifiez qu'il n'y a pas d'espaces en fin dans les noms de dossiers. 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 devez vérifier le traitement réussi ou si vous rencontrez des problèmes.