SUJETS×

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.

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 .

Processus de transfert de données par lots

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

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 des données hors ligne ou Workflow B - Personnalisation basée sur des 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 d’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

La synchronisation correspond aux DPUUID aux UUID

Un fichier de synchronisation des identifiants a pour but de synchroniser les DPUUID de vos propres sources de données avec Audience Manager des UUID. La synchronisation mappe les DPUUIDs du maître DPID et des DPIDs 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 d'Adobe Audience Manager	DPID 12345
68079982765673198504052656074456196039	XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
67412682083411995725538770443620307584	XYZ3017BBR4DAFJWfM6D4Gb4lN_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 à partir 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 ( Télécharger un exemple de fichier )

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 permettra de synchroniser les DPUUIDs à partir du DPID 67890 avec les Audiences Manager UUIDà partir de l’étape 1.

Autres formats requis

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 URL le codage. 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.