Exigences en matière de nom et de contenu pour les fichiers de synchronisation d’identifiants name-and-content-requirements-for-id-synchronization-files

Décrit les champs, la syntaxe et les conventions d’appellation requis utilisés pour la synchronisation des identifiants basée sur les fichiers. Nommez et organisez le contenu de vos fichiers en fonction de ces spécifications.

NOTE
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 file-name-syntax

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 identifiants d’appareil à d’autres identifiants d’appareil 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 des destinations basées sur les personnes.
MASTERDPID

L’identifiant du fournisseur de données principal est l’identifiant parent des DPID dans le nom de fichier. En outre, le premier identifiant utilisateur du fichier de données correspond à l’identifiant principal. Les DPID suivants sont d’autres identifiants appartenant au maître. La synchronisation mappe les DPID dans le nom de fichier aux UUID dans le fichier.

Ce DPID ne doit contenir que les identifiants d’appareil, tels qu’AAM UUID, GAID, IDFA, etc. Elle 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 mappe les DPID dans le nom de fichier aux UUID dans le fichier.

Le nombre de DPID dans le nom de fichier doit correspondre au nombre d’UUID dans le fichier de données. Supposons, par exemple, que votre nom de fichier contienne un DPID maître et 3 DPID. Votre fichier de données doit contenir 4 colonnes d’UUID correspondantes, au format décrit dans la section de contenu du 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 divisez 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 présentent des noms de fichiers correctement formatés. Vos noms de fichier peuvent ressembler à ceux-ci.

  • 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
NOTE
Pour l’affectation de nom de fichier de synchronisation des identifiants (préfixe c2c) pour les destinations basées sur les personnes, voir Workflow A - Personalization basé sur toutes les activités en ligne combinées avec les données hors ligne ou Workflow B - Personalization basé sur les données hors ligne uniquement.

Syntaxe du contenu du fichier et exemples file-content-syntax

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 identifiants par un onglet. L’exemple suivant illustre un fichier d’ID correctement formaté. Votre contenu pourrait ressembler à celui-ci.

abc123 def456 ghi789 xyz987

Considérations sur le contenu des fichiers considerations

Lors de la création de vos fichiers entrants, assurez-vous que la première colonne est uniquement remplie avec les identifiants d’appareil, tels que AAM UUID, GAID, IDFA, etc. Pour obtenir une explication détaillée des ID pris en charge par l’Audience Manager, reportez-vous à la section Index des ID en Audience Manager .

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

La synchronisation correspond aux DPUUID vers les UUID sync-matches-dpuuids-uuids

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 mappe les DPUUID du maître DPID et des DPID associés aux Audience Manager UUID. L’emplacement où vous placez les identifiants dans le nom de fichier et le corps détermine la façon dont ces identifiants sont mappés les uns aux autres. Par exemple, prenez les deux fichiers d’exemple présentés ici :

  • Fichier 1 : adobe_id_0_12345_1476312152.sync

  • Fichier 2 : adobe_id_12345_67890_1476312876.sync

Compte tenu de l’exemple de nom et de contenu, les identifiants sont mappés comme suit :

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

DPID 0 = UID Adobe Audience Manager
DPID 12345
68079982765673198504052656074456196039
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
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 UUID.

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

DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4lN_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 UUID. Cette synchronisation des identifiants synchronise les DPUUIDs de DPID 67890 avec l'Audience Manager UUID de l'étape 1.

Autres exigences de format other-format-reqs

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 identifiants individuels dans le fichier de données.
  • Contenir des informations d’identification personnelle (PII).
  • Utilisez l'encodage URL. Transmettez uniquement les identifiants non codés.

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695