Descrive i campi obbligatori, la sintassi e le convenzioni di denominazione utilizzati per la sincronizzazione ID basata su file. Assegna un nome e organizza il contenuto del file in base a queste specifiche.
Gli stili di testo (monospaced text
, corsivo, parentesi [ ]
( )
, ecc.) in questo documento indicare gli elementi di codice e le opzioni. Per ulteriori informazioni, consulta le convenzioni di stile per codice ed elementi di testo.
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 |
---|---|
|
Prefisso statico che identifica il file come file di sincronizzazione ID. Usa questo prefisso quando gli ID dispositivo corrispondono ad altri ID dispositivo o ID cliente (DPUUID). |
|
Prefisso statico che identifica il file come file di sincronizzazione ID per Destinazioni basate su persone. Usa questo prefisso quando gli ID cliente (DPUUID) vengono associati agli indirizzi e-mail con hash per le destinazioni basate su persone. |
MASTERDPID |
L’ID del provider di dati master è l’ID principale degli DPID nel nome del file. Inoltre, il primo ID utente nel file di dati corrisponde all’ID principale. Gli identificatori DPID successivi sono altri identificatori che appartengono al master. La sincronizzazione associa gli identificatori DPID nel nome del file agli identificatori UUID nel file. Questo DPID deve contenere solo ID dispositivo, come AAM UUID, GAID, IDFA e così via. Non può contenere DPUUID. Questa operazione può causare una sincronizzazione errata. |
|
ID dei fornitori di dati. Questi ID rappresentano entità o origini dati associate al DPID principale. La sincronizzazione associa gli identificatori DPID nel nome del file agli identificatori 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 seguente, relativa al contenuto del file. |
timestamp |
Timestamp UNIX a 10 cifre in secondi. La marca temporale consente di rendere univoco ogni nome di file. |
|
Indica una sincronizzazione normale e completa. |
|
Un numero intero. Utilizzato quando si dividono file di grandi dimensioni in più file di dimensioni inferiori. Questo consente di migliorare i tempi di elaborazione. Il numero indica quale parte del file originale si sta inviando. Consulta gli esempi di nomi di file riportati di seguito. |
|
Specifica che il file è compresso con compressione gzip opzionale. |
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
Per la denominazione dei file di sincronizzazione ID (prefisso c2c) per le destinazioni basate sulle persone, vedi 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.
Il contenuto di un file ID include i seguenti elementi:
UUID
<tab>
UUID
<tab>
UUID
<tab>
UUID
Il file contiene 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
Quando crei i file in entrata, assicurati che la prima colonna sia compilata solo con gli ID dispositivo, ad esempio AAM UUID, GAID, IDFAe così via. Consulta Indice degli ID in Audience Manager per una spiegazione dettagliata degli ID supportati da Audience Manager.
Non usi DPUUID nella prima colonna. Questa operazione può causare una sincronizzazione errata.
Un file di sincronizzazione ID ha lo scopo di sincronizzare DPUUID dalle tue origini dati con Audience Manager UUID. La sincronizzazione mappa DPUUIDs dal master DPID e relative DPIDs al Audience Manager UUIDs. Il punto in cui inserisci gli ID nel nome e nel corpo del file determina il modo in cui questi identificatori vengono mappati l’uno sull’altro. Ad esempio, prendi i due file di esempio mostrati qui:
File 1: adobe_id_0_12345_1476312152.sync
File 2: adobe_id_12345_67890_1476312876.sync
Dati il nome e il contenuto di esempio, gli ID vengono mappati in questo modo:
File 1 ( Scarica file di esempio)
DPID 0 = UUID di Adobe Audience Manager | 12345 DPID |
---|---|
68079982765673198504052656074456196039 | XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38 |
67412682083411995725538770443620307584 | XYZ3017BBR4DAFJWfM6D4Gb4LN_T5jk_f7rdEcqNs9wfnA7h70 |
89159024796760343733111707646026765593 | XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM |
66552757407517449462805881945288602094 | XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M |
66184778222667870903738139438735041506 | XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw |
Passaggio 1: il processo di sincronizzazione ID sincronizzerà DPUUIDs da DPID 12345 con Audience Manager UUIDs nella colonna sinistra. Tieni presente che DPID "0" nel nome del file rappresenta Audience Manager UUIDs.
File 2 ( Scarica file di esempio)
DPID 12345 | DPID 67890 |
---|---|
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38 | 4598060374 |
XYZ3017BBR4DAFJWfM6D4Gb4LN_T5jk_f7rdEcqNs9wfnA7h70 | 4581274262 |
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM | 4392434426 |
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M | 2351382994 |
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw | 4601584763 |
Passaggio 2: DPUUIDs da DPID 12345 stati sincronizzati nel passaggio 1 con l’Audience Manager UUIDs. Questa sincronizzazione ID eseguirà la sincronizzazione di DPUUIDs da DPID 67890 con l’Audience Manager UUIDs dal passaggio 1.
Gli ID utente non possono:
Le righe che terminano con tabulazioni o spazi non vengono elaborate o realizzate. Di regola, assicurati di mantenere pulita la fine delle righe.