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

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.

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 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
REMARQUE

Pour l’attribution d’un nom de fichier de synchronisation des identifiants (préfixe c2c) pour les destinations basées sur les personnes, voir Processus A - Personnalisation basée sur toutes les activités en ligne combinées avec les données hors ligne ou Processus 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 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

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. Voir Index des ID en Audience Manager pour une explication détaillée des ID 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 vers les UUID

Un fichier de synchronisation des identifiants a pour objectif de synchroniser les DPUUIDs de vos propres sources de données avec les Audience Manager UUID. La synchronisation mappe les DPUUIDs du DPID maître et les DPIDs associés aux Audience Manager UUIDs. 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 UUIDdans la colonne de gauche. Notez que la valeur DPID "0" dans le nom de fichier représente Audience Manager UUIDs.

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 UUIDs. Cette synchronisation des identifiants effectue une synchronisation des DPUUIDs de DPID 67890 avec les UUIDAudiences Manager 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 identifiants individuels dans le fichier de données.
  • Contenir des informations d’identification personnelle (PII).
  • Utilisez le codage 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.

Sur cette page