Name and Content Requirements for ID Synchronization Files

Descrive i campi, la sintassi e le convenzioni di denominazione richiesti per la sincronizzazione ID basata su file. Denominate e organizzate i contenuti dei file in base alle seguenti specifiche.

NOTA

Gli stili di testo (monospaced text, corsivo, parentesi [ ] ( ), ecc.) in questo documento indicano gli elementi e le opzioni del codice. Per ulteriori informazioni, consulta le convenzioni di stile per codice ed elementi di testo.

Sintassi nome file ed esempi

I nomi dei file ID contengono i seguenti elementi obbligatori e facoltativi:

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

Parametro Descrizione

adobe_id

Un prefisso statico che identifica il file come file di sincronizzazione ID. Utilizzate questo prefisso quando gli ID dispositivo corrispondono ad altri ID dispositivo o ID cliente (DPUUID).

c2c_id

Prefisso statico che identifica il file come file di sincronizzazione ID per le destinazioni basate sulle persone. Utilizzate questo prefisso per far corrispondere gli ID cliente (DPUUID) agli indirizzi e-mail con hash per le destinazioni basate sulle persone.

MASTERDPID L'ID del provider di dati principale è l'ID padre dei DPID nel nome del file. Inoltre, il primo ID utente nel file di dati corrisponde all'ID principale. I DPID successivi sono altri identificatori appartenenti al master. La sincronizzazione mappa i DPID nel nome del file sugli UUID nel file.

DPID

ID del provider di dati. Questi ID rappresentano entità o origini dati associate al DPID principale. La sincronizzazione mappa i DPID nel nome del file sugli UUID nel file.

Il numero di DPID nel nome del file deve corrispondere al numero di UUID nel file di dati. Ad esempio, supponiamo che il nome del file contenga un DPID principale e 3 DPID. Il file di dati deve includere 4 colonne corrispondenti di UUID, formattate come descritto nella sezione del contenuto del file di seguito.

timestamp

Marca temporale UNIX di 10 cifre, in secondi. La marca temporale consente di rendere univoco ciascun nome file.

.sync

Indica una sincronizzazione normale e completa.

[.SPLIT_NUMBER]

Un numero intero. Utilizzato quando si suddividono file di grandi dimensioni in più file più piccoli. Questo consente di migliorare i tempi di elaborazione. Il numero indica quale parte del file originale viene inviata. Vedere gli esempi di nome file riportati di seguito.

[.gz]

Specifica che il file viene compresso con la compressione gzip facoltativa.

Esempi di nomi file

Gli esempi seguenti mostrano i nomi dei file formattati correttamente. I nomi dei file potrebbero essere simili.

  • 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
NOTA

Per la denominazione dei file di sincronizzazione ID (prefisso c2c) per le destinazioni basate sulle persone, vedere Flusso di lavoro A - Personalizzazione basata su tutte le attività online combinate con dati offline o Flusso di lavoro B - Personalizzazione basata su dati solo offline.

Sintassi contenuto file ed esempi

Il contenuto di un file ID include i seguenti elementi:

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

Il file contiene gli ID utente (UUID). In ogni riga, separa gli ID con una scheda. L'esempio seguente mostra un file ID formattato correttamente. Il contenuto potrebbe essere simile.

abc123 def456 ghi789 xyz987

Sincronizzazione con DPUUID corrispondenti agli UUID

Lo scopo di un file di sincronizzazione ID è quello di sincronizzare i DPUUID dalle origini dati con gli UUUID Audience Manager. La sincronizzazione mappa i DPUUIDs dal master DPID e i relativi DPIDs agli Audience Manager UUIDs. La posizione in cui gli ID vengono inseriti nel nome e nel corpo del file determina in che modo questi identificatori vengono mappati l'uno sull'altro. Ad esempio, prendete i due file di esempio seguenti:

  • File 1: adobe_id_0_12345_1476312152.sync

  • File 2: adobe_id_12345_67890_1476312876.sync


Dati il nome e il contenuto dell’esempio, gli ID vengono mappati in questo modo:

File 1 ( Scarica file di esempio)

DPID 0 = Adobe Audience Manager UUID DPID 12345
68079982765673198504052656074456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR.38
67412682083411995725538770443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
8915902479676034373311707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
6618477822667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Passaggio 1: il processo di sincronizzazione ID sincronizzerà i DPUUIDs da DPID 12345 con i Audience Manager UUIDs nella colonna sinistra. Tenere presente che la DPID "0" nel nome del file rappresenta Audience Manager UUIDs.

File 2 ( Scarica file di esempio)

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

Passaggio 2: i DPUUIDs di DPID 12345 sono stati sincronizzati al punto 1 con il Audience Manager UUIDs. Questa sincronizzazione ID consente di sincronizzare DPUUIDs da DPID 67890 con il Audience Manager UUIDs dal passaggio 1.


Altri requisiti di formato

Gli ID utente non possono:

  • Avere schede nell'ID stesso. Le schede vengono utilizzate solo per separare i singoli ID nel file di dati.
  • Contiene informazioni personali identificabili (PII).
  • Utilizzare la codifica URL. Trasmettere solo ID non codificati.

Tutte le righe che terminano con tabulazioni o spazi non verranno elaborate o realizzate. Come regola, accertatevi di mantenere la fine delle righe pulita.

In questa pagina