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

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

REMARQUE

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 comprennent :

  • FTP - Transfert via 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 cibles. Les clients peuvent avoir plusieurs destinations, en fonction des besoins de l’entreprise.

MASTER_DPID

Fournisseur de données ou ID de 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 :

  • 20914 - Identifiant Google Advertiser (brut, non haché)
  • 20915 - ID Apple pour annonceurs (brut, non haché)
  • ID fournisseur - ID utilisateur tiers (Web/cookie)

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

PID_ALIAS

Identificateur de client de la plateforme tierce.

SYNC_MODE

Le mode de synchronisation est un espace réservé de macro qui ajoute une étiquette au nom de fichier en fonction du type de synchronisation. Les types de synchronisation sont complets et incrémentiels. Ils apparaîtront dans le nom de 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é fractionnée en plusieurs parties afin d'améliorer les temps de traitement. Le numéro indique à quelle partie du fichier d’origine les données appartiennent.

L’entier doit contenir au moins 3 chiffres, précédés de zéros, si la taille de fractionnement est inférieure à 100 parties.

Le fichier d'origine n'aura pas de numéro partagé. Le premier fichier scindé se terminera 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, 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 à l'emplacement FTP, sans PID_ALIAS et avec Apple Advertiser IDs dans 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 avec 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. Mettez en forme vos données selon ces spécifications.

REMARQUE

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 liste des 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 segmentation 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 de 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 UUID ID de segment et les ID 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

Sur cette page