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.
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.
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
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
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)
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.
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.
UUID
<SPACE>
SEGMENT_N
REMOVED_SEGMENT_N
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