Nom du fichier de données sortant : syntaxe et exemples outbound-data-file-name-syntax-and-examples

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

NOTE
Les éléments de style (monospaced text, italique, crochets [ ] ( ), etc.) de ce document indiquent 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.

Éléments de syntaxe et de nom de fichier syntax-file-name

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.

Élément de 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 Amazon AWS
DID

Identifiant 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

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

  • 20914 - d’ID publicitaire Google (brut, non haché)
  • 20915 - Apple ID pour les annonceurs (brut, non haché)
  • ID de fournisseur - ID 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 les synchronisations complète et incrémentielle. Elles apparaissent 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 les anciennes données ainsi que 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

Nombre entier. Identifie la 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.

Le nombre 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 n'aura pas de numéro de division. Le premier fichier fractionné se termine par 001. Voir les exemples ci-dessous.

.gz (optional)
Compression GZIP.

Exemples de noms de fichier file-name-examples

Scénario 1

Fichiers envoyés à un emplacement Amazon S3, 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 emplacement, 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 emplacement, avec PID_ALIAS="XYZCustomer" et avec un ID d’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 sortant : syntaxe et paramètres outbound-contents-syntax

Décrit les champs obligatoires, la syntaxe et les conventions utilisées pour organiser les informations dans un fichier de données sortant. Formatez vos données en fonction de ces spécifications.

NOTE
Les éléments de style (monospaced text, italique, crochets [ ] ( ), etc.) de ce document indiquent 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 apparaissent dans cet ordre :

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 d’utilisateur unique attribué par ’ Audience Manager.
<SPACE>
Séparez l’UUID et les données de segment par un espace
SEGMENT_N
Identifiant de segment auquel appartient un visiteur ou une visiteuse. Séparez plusieurs segments par une virgule.
REMOVED_SEGMENT_N
Identifiant du segment dont 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 contient la liste complète des segments actuels pour l’utilisateur. En règle générale, vous souhaitez en savoir plus sur les segments auxquels appartient un utilisateur plutôt que sur ceux desquels il a été supprimé. Voir aussi nom du fichier de données sortant : 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 éligible aux segments 24, 26 et 27. Selon les besoins, un espace sépare les identifiants de UUID et de segment. Un autre espace sépare les ensembles 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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695