Nom du fichier de données sortantes : syntaxe et exemples

Décrit les champs, la syntaxe et les conventions requis pour nommer un fichier de données sortant.

REMARQUE

Les éléments de style (monospaced text, italics, 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 et éléments de nom de fichier

Les noms des 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 du fichier Description

SYNC_TYPE

Fait référence aux méthodes de transfert de données. Les méthodes de transfert incluent :

  • FTP : transfert par SFTP
  • Amazon S3 - Transfert vers Amazon AWS

DID

ID de destination.

Dans Audience Manager , une destination est l’instance de l’intégration où vous pouvez mapper vos segments ciblés. Les clients peuvent avoir plusieurs destinations, en fonction des besoins de l’entreprise.

MASTER_DPID

Identifiant du fournisseur de données ou de la source de données. Cet identifiant identifie le type d’ID utilisateur présent dans le contenu du fichier. Les clés d’ID utilisateur les plus courantes sont les suivantes :

  • 20914 - Identifiant Google Advertiser (brut, haché)
  • 20915 - ID Apple pour les annonceurs (brut, non haché)
  • Identifiant du fournisseur - identifiants d’utilisateur tiers (web/cookie)

Consultez les sources de données globales pour en savoir plus.

PID_ALIAS

Identifiant client de la plateforme tierce.

SYNC_MODE

Le mode de synchronisation est un espace réservé de macro qui ajoute un libellé au nom du fichier en fonction du type de synchronisation. Les types de synchronisation incluent complète et incrémentielle. Ils apparaissent dans le nom de fichier sous la forme iter ou full .

  • iter : Indique une synchronisation "itérative" ou incrémentale. 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 appartiennent les données.

L’entier doit contenir 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 comportera aucun numéro partagé. 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 emplacement Amazon S3, avec PID_ALIAS="XYZCustomer" et Google Advertiser IDs dans le contenu du fichier.

Par exemple, les 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, des fichiers complets :

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Scénario 2

Fichiers envoyés à l’emplacement FTP, sans PID_ALIAS et avec Apple Advertiser IDs dans le contenu du fichier :

Par exemple, les fichiers incrémentiels :

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

Par exemple, des fichiers complets :

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

Scénario 3 : Fichiers envoyés à l’ FTP emplacement, avec PID_ALIAS="XYZCustomer" et un identifiant utilisateur tiers dans le contenu du fichier ( Vendor ID=45454) :

Par exemple, les 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, des 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 pour organiser les informations dans un fichier de données sortant. Mettez en forme vos données en fonction de ces spécifications.

REMARQUE

Les éléments de style (monospaced text, italics, 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

Identifiant utilisateur unique attribué par l’Audience Manager .

<SPACE>

Séparez l’UUID et les données de segment par un espace.

SEGMENT_N

Identifiant du segment auquel appartient un visiteur. Séparez plusieurs segments par une virgule.

REMOVED_SEGMENT_N

Identifiant du 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 en cours pour l’utilisateur. En règle générale, vous souhaitez connaître les segments auxquels appartient un utilisateur 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. Au besoin, un espace sépare les UUID et les identifiants de segment. Un autre espace sépare les jeux d’identifiants 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

Sur cette page