Exigences en matière de nom et de contenu pour les fichiers de synchronisation d’identifiants

Décrit les champs obligatoires, la syntaxe et les conventions d’attribution de noms utilisées pour la synchronisation des identifiants basée sur des fichiers. Nommez et organisez le contenu de votre fichier selon ces spécifications.

REMARQUE

Les styles de texte (monospaced text, italiques, 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 du nom de fichier et exemples

Les noms de fichiers d’ID contiennent les éléments obligatoires et facultatifs suivants :

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Paramètre	Description
`adobe_id`	Préfixe statique qui identifie le fichier comme fichier de synchronisation des identifiants. Utilisez ce préfixe lorsque vous faites correspondre des ID de périphérique à d’autres ID de périphérique ou de client (DPUUID).
`c2c_id`	Préfixe statique qui identifie le fichier comme fichier de synchronisation des identifiants pour les destinations basées sur les personnes. Utilisez ce préfixe lorsque vous faites correspondre des ID de client (DPUUID) à des adresses électroniques hachées pour les destinations basées sur les personnes.
`MASTERDPID`	L’ID de fournisseur de données maître est l’ID parent des DPID dans le nom de fichier. En outre, le premier ID utilisateur du fichier de données correspond à l’ID maître. Les DPID suivants sont d’autres identifiants qui appartiennent au maître. La synchronisation fait correspondre les DPID du nom de fichier aux UUID du fichier. Ce DPID ne doit contenir que des ID de périphérique, tels que AAM UUID, GAID, IDFA, etc. Il ne peut pas contenir de DPUUID. Cela peut entraîner une synchronisation incorrecte.
`DPID`	ID de fournisseur de données. Ces identifiants représentent des entités ou des sources de données associées au DPID maître. La synchronisation fait correspondre les DPID du nom de fichier aux UUID du fichier. Le nombre de DPID dans le nom de fichier doit correspondre au nombre d’UUID dans le fichier de données. Par exemple, supposons que votre nom de fichier contient un DPID maître et 3 DPID. Votre fichier de données doit inclure 4 colonnes correspondantes d’UUID, au format décrit dans la section de contenu de fichier ci-dessous.
`timestamp`	Horodatage UNIX à 10 chiffres en secondes. L’horodatage permet de rendre chaque nom de fichier unique.
`.sync`	Indique une synchronisation normale complète.
`[.SPLIT_NUMBER]`	Entier. Utilisé lorsque vous séparez des fichiers volumineux en plusieurs fichiers plus petits. Cela permet d’améliorer les temps de traitement. Le numéro indique la partie du fichier d'origine que vous envoyez. Consultez les exemples de noms de fichier ci-dessous.
`[.gz]`	Indique que votre fichier est compressé avec la compression gzip facultative.

Exemples de noms de fichier

Les exemples suivants montrent les noms de fichiers correctement formatés. Vos noms de fichier peuvent ressembler.

adobe_id_111_222_333_444_1454442149.sync
adobe_id_123_898_456_1454442149.sync.1.gz
adobe_id_123_898_456_1454442149.sync.2.gz
c2c_id_123_898_1454442149.sync.gz

REMARQUE

Pour la dénomination des fichiers de synchronisation des identifiants (préfixe c2c) pour les destinations basées sur les personnes, voir Workflow A - Personnalisation basée sur toutes les Activités en ligne combinées avec les données hors ligne ou Workflow B - Personnalisation basée sur les données hors ligne uniquement.

Syntaxe du contenu du fichier et exemples

Le contenu d’un fichier d’ID comprend les éléments suivants :

UUID <tab>UUID<tab>UUID<tab>UUID

Le fichier contient des ID utilisateur (UUID). Dans chaque ligne, séparez les ID par un onglet. L’exemple suivant montre un fichier d’ID correctement formaté. Votre contenu pourrait avoir l'air similaire.

abc123 def456 ghi789 xyz987

Considérations sur le contenu des fichiers

Lors de la création de vos fichiers entrants, assurez-vous que la première colonne est uniquement remplie avec les ID de périphérique, tels que AAM UUID, GAID, IDFA, etc. Voir Index des identifiants dans Audience Manager pour une explication détaillée des identifiants pris en charge par l'Audience Manager.

IMPORTANT

N’utilisez pas DPUUIDs dans la première colonne. Cela peut entraîner une synchronisation incorrecte.

La synchronisation correspond aux DPUUID aux UUID

Un fichier de synchronisation des identifiants a pour but de synchroniser les DPUUIDs de vos propres sources de données avec les Audience Manager UUIDs. La synchronisation fait correspondre les DPUUIDs du DPID maître et les DPIDs qui lui sont associés aux Audience Manager UUIDs. L’emplacement des identifiants dans le nom et le corps du fichier détermine la manière dont ces identifiants sont mappés les uns aux autres. Par exemple, prenez les deux fichiers d’exemple suivants :

Fichier 1 : adobe_id_0_12345_1476312152.sync
Fichier 2 : adobe_id_12345_67890_1476312876.sync

Compte tenu du nom et du contenu de l’exemple, les identifiants correspondent comme suit :

Fichier 1 ( Télécharger un exemple de fichier)

DPID 0 = UUID Adobe Audience Manager	DPID 12345
68079982765673198504052656074456196039	XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
6741268208341199572553870443620307584	XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
8915902479676034373311707646026765593	XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094	XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506	XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Étape 1 : le processus de synchronisation des identifiants synchronise les DPUUIDs de DPID 12345 avec les Audience Manager UUIDs dans la colonne de gauche. Notez que le DPID "0" dans le nom de fichier représente Audience Manager UUIDs.

Fichier 2 (fichier d’exemple Télécharger)

DPID 12345	DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38	4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70	4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM	4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M	2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw	4601584763

Étape 2 : les DPUUIDs de DPID 12345 ont été synchronisés à l'étape 1 avec l'Audience Manager UUIDs. Cette synchronisation des identifiants permet de synchroniser les DPUUIDs de DPID 67890 avec l'Audience Manager UUIDs de l'étape 1.

Autres exigences de format

Les ID utilisateur ne peuvent pas :

Posséder des onglets dans l’identifiant lui-même. Les onglets ne sont utilisés que pour séparer les ID individuels dans le fichier de données.
Contenir des informations d’identification personnelle (PII).
Utilisez le codage URL. Transmettez uniquement des ID non codés.

Les lignes qui se terminent par des tabulations ou des espaces ne seront pas traitées ni réalisées. En règle générale, assurez-vous que la fin des lignes reste claire.