Show Menu
SUJETS×

Nom du fichier de données sortant : Syntaxe et exemples

Décrit les champs, la syntaxe et les conventions requis utilisés pour nommer un fichier de données sortant.
Les éléments de style ( monospaced text , italique , crochets [ ] ( ) , etc.) dans ce document, indiquez les éléments de code et les options. Pour plus d’informations, voir les conventions de style relatives aux éléments de code et de texte .

Eléments de syntaxe et de nom de fichier

Les noms de fichiers sortants contiennent les éléments suivants. Tous les éléments ci-dessous sont facultatifs.
[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Paramètres

Le tableau définit les éléments d’un nom de fichier de données sortant.
Elément Nom de fichier Description
SYNC_TYPE
Fait référence aux méthodes de transfert de données. Les méthodes de transfert incluent :
  • FTP - Transfert via SFTP
  • Amazon S3 - Transfert vers AWS Amazon
DID
ID de destination.
Dans Audience Manager , une destination est l’instance de l’intégration où vous pouvez mapper vos segments cibles. Les clients peuvent avoir plusieurs destinations, selon les besoins de l’entreprise.
MASTER_DPID
Fournisseur de données ou ID de source de données. Cet ID identifie le type d’ID utilisateur présent dans le contenu du fichier. Les clés d’ID utilisateur les plus courantes sont :
  • 2014 - Identifiant publicitaire Google (brut, non haché)
  • 20915 - ID Apple pour les annonceurs (brut, non haché)
  • ID fournisseur - ID utilisateur tiers (Web/cookie)
Voir Sources de données globales pour en savoir plus.
PID_ALIAS
Identifiant du client de la plateforme tierce.
SYNC_MODE
Le mode de synchronisation est un espace réservé de macro qui ajoute une étiquette au nom du fichier en fonction du type de synchronisation. Les types de synchronisation sont complets et incrémentiels. Ils apparaîtront dans le nom du fichier sous la forme iter ou full .
  • iter : Indique une synchronisation "itérative" ou incrémentielle. Un fichier incrémentiel contient uniquement les nouvelles données collectées depuis la dernière synchronisation.
  • full : Indique une synchronisation "complète". Un fichier entièrement synchronisé contient d’anciennes données et toutes les nouvelles données collectées depuis la dernière synchronisation.
TIMESTAMP
Horodatage UNIX à 13 chiffres en millisecondes, dans le fuseau horaire UTC.
SPLITNUM
Entier. Identifie une partie d’un fichier qui a été divisée en plusieurs parties afin d’améliorer les temps de traitement. Le nombre indique à quelle partie du fichier d’origine les données appartiennent.
L’entier doit comporter au moins 3 chiffres, précédés de zéros, si la taille de division est inférieure à 100 parties.
Le fichier d’origine ne comporte aucun numéro de division. Le premier fichier partagé se termine par 001. Voir les exemples ci-dessous.
.gz (optional)
Compression GZIP.

Exemples de noms de fichier

Scénario 1

Fichiers envoyés à un Amazon S3 emplacement, avec PID_ALIAS="XYZCustomer" et avec Google Advertiser IDs dans le contenu du fichier.
Par exemple, fichiers incrémentiels :
  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz
Par exemple, fichiers complets :
  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Scénario 2

Fichiers envoyés à FTP l’emplacement, sans PID_ALIAS et avec Apple Advertiser IDs le contenu du fichier :
Par exemple, fichiers incrémentiels :
  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz
Par exemple, fichiers complets :
  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz
Scénario 3 : Fichiers envoyés à FTP l’emplacement, avec PID_ALIAS="XYZCustomer" et un ID utilisateur tiers dans le contenu du fichier ( Vendor ID=45454 ) :
Par exemple, fichiers incrémentiels :
  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
Par exemple, fichiers complets :
  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Contenu du fichier de données sortantes : Syntaxe et paramètres

Décrit les champs, la syntaxe et les conventions requis utilisés pour organiser les informations dans un fichier de données sortant. Formatez vos données en fonction de ces spécifications.
Les éléments de style ( monospaced text , italique , crochets [ ] ( ) , etc.) dans ce document, indiquez les éléments de code et les options. Pour plus d’informations, voir les conventions de style relatives aux éléments de code et de texte .

Syntaxe

Les champs du fichier de données s’affichent dans l’ordre suivant :
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Paramètres

Le tableau répertorie les variables qui définissent le contenu d’un fichier de données.
Paramètre Description
UUID
ID utilisateur unique attribué par Audience Manager .
<SPACE>
Séparez les données UUID et de segment par un espace
SEGMENT_N
ID de segment auquel appartient un visiteur. Séparez plusieurs segments par une virgule.
REMOVED_SEGMENT_N
ID de segment à partir duquel l’utilisateur a été disqualifié. Séparez plusieurs segments par une virgule. Avec une synchronisation complète, vous pouvez ignorer les segments supprimés, car le fichier de données contiendra la liste complète des segments actuels pour l’utilisateur. En règle générale, vous souhaitez connaître les segments auxquels un utilisateur appartient plutôt que ceux dont il a été supprimé. Voir aussi Nom du fichier de données sortantes : Syntaxe et exemples .

Exemple : Format de fichier de base

Un fichier de données correctement formaté peut ressembler à l’exemple suivant. Cette entrée de fichier indique qu’un utilisateur est admissible pour les segments 24, 26 et 27. Selon les besoins, un espace sépare les ID de segment UUID et de segment. Un autre espace sépare les jeux d’ID de segment. Dans cet exemple, un utilisateur appartient aux segments 24, 26 et 27. Ils ont été supprimés des segments 25 et 28.
59767559181262060060278870901087098252  24,26,27  25,28