Campi, sintassi e regole obbligatori da seguire per la formattazione di un file di dati con caratteristiche in entrata.
I campi nel file di dati in entrata devono essere visualizzati nell'ordine indicato di seguito. In questo esempio, sono stati aggiunti i simboli <
>
per aiutare a separare visivamente ciascun elemento. Non è necessario includerli nel file di dati.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Per altri formati di file di contenuto accettati, vedere Integrazioni partner personalizzate.
Abbiamo un limite di 200 righe che possiamo elaborare per ogni ID utente inviato nel file di dati in entrata. Ad esempio, se invii 300 righe per un ID utente, le prime 200 righe vengono mantenute e le altre 100 righe vengono eliminate. Nell'esempio seguente, l'utente è in grado di inviare 3 righe ciascuna per l'ID utente 1 e l'ID utente 2. Non viene applicato un limite al numero di caratteristiche o coppie chiave-valore incluse in una riga.
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
La tabella elenca e definisce le variabili utilizzate in un file di dati in entrata formattato correttamente. Il corsivo indica un segnaposto variabile.
Variabile | Descrizione |
---|---|
|
Un ID utente può essere:
Per gli ID mobili:
|
|
Separa ID utente e ID caratteristica con un singolo delimitatore di tabulazione. |
|
L'ID Audience Manager . Vi chiediamo di includere solo le caratteristiche registrate nei file di dati in entrata. Non vengono elaborati altri tipi di caratteristiche nel trasferimento dati in entrata.
Nota: L'ID caratteristica può essere trovato utilizzando il metodo GET che restituisce dettagli su tutte le caratteristiche. Per ulteriori informazioni, vedere Metodi API delle caratteristiche . |
Nella tabella seguente sono descritti i prefissi che identificano i nomi o gli ID trait in un file di dati in entrata. Vedere gli esempi file di esempio.
Prefisso | Descrizione |
---|---|
|
Il prefisso |
|
I dati con prefisso Il prefisso |
|
Le regole sulle caratteristiche consentono di impostare i criteri per la qualifica delle caratteristiche. Se formattate una regola di caratteristiche come Ad esempio, supponiamo di creare le seguenti 3 regole di caratteristiche:
Queste caratteristiche sono associate alla chiave
|
Coppie chiave-valore |
I dati delle caratteristiche possono essere formattati come coppie chiave-valore utilizzando stringhe alfanumeriche. Esistono diversi modi per formattare le coppie chiave-valore, come illustrato di seguito:
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sono tutti esempi di coppie chiave-valore formattate correttamente. |
Trait IDs sono costituiti solo da caratteri numerici. Vi chiediamo di includere solo onboarded traits nei file di dati in entrata. Non vengono elaborati altri tipi trait nel trasferimento dati in ingresso.
Tipo di ID | Requisito |
---|---|
DPUUID |
Non utilizzate due punti codificati ( |
ID dispositivo iOS (IDFA) mobile o Android |
Gli ID dispositivo mobile devono essere formattati in modo rigoroso come illustrato di seguito:
|
Anche i nomi di valori formattati in modo errato in una coppia chiave-valore causano problemi. Per creare o denominare il valore in una coppia chiave-valore, effettuate le seguenti operazioni:
Carattere | Requisito |
---|---|
Citazione carattere (") |
È possibile utilizzare il carattere della citazione nella chiave e nella parte del valore della coppia chiave-valore, come segue:
|
Carattere trattino (-) |
Ignoriamo i segni di tratteggio all'inizio delle chiavi. Ad esempio, |
|
Nelle coppie chiave-valore non utilizzate valori |
|
Non utilizzare i nuovi caratteri di riga o di tabulazione ( |
Formato file dati | Descrizione ed esempio |
---|---|
Con |
Questo file di dati mostra un utente qualificato per le caratteristiche 24, 26, 27 ed è stato rimosso dalla caratteristica 28 e 29.
Nota: Invece di utilizzare d_unsid, potete anche rimuovere le caratteristiche dai profili utente utilizzando la sintassi seguente:
|
Utilizzate |
Queste caratteristiche sono state aggiunte a una regola delle caratteristiche con il prefisso ID numerici
ID stringa
|
Con coppie chiave-valore |
I dati di questo file utilizzano coppie chiave-valore per trasmettere i dati a Audience Manager .
|
[Scaricate ] (assets/ftp_dpm_1234_1445374061.overwrite) il file di dati di esempio se avete bisogno di ulteriori esempi. Il file di download ha un'estensione .overwrite
. Potete aprirlo con un semplice editor di testo.
Il grafico seguente mostra alcuni esempi del modo corretto di formattare i file in entrata, a seconda del tipo di ID e del metodo con cui si desidera aggiungere traits ai profili.
Tipo di ID / Funzionamento | Utilizzare d_sid per aggiungere caratteristiche a un profilo utente | Usa d_unsid per rimuovere le caratteristiche da un profilo utente | Invio di coppie chiave-valore per aggiungere caratteristiche a un profilo utente | Utilizzate il prefisso ic per aggiungere caratteristiche a un profilo utente |
---|---|---|---|---|
UUID Audience Manager |
||||
Google Advertising ID per dispositivi Android |
||||
Apple IDFA per dispositivi iOS |
||||
Il tuo ID CRM (DPUUID) |
Utilizzare trait IDs per inviare trait informazioni sulle qualifiche per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Utilizzare trait IDs per inviare trait le informazioni relative all'interdizione Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
oppure
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
oppure
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
Inviate coppie chiave-valore per aggiungere informazioni trait relative alla qualifica per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
oppure
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Utilizzare il prefisso ic
per inviare le informazioni relative alla qualifica trait per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
oppure
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Utilizzate trait IDs per inviare le informazioni trait relative alla qualifica per i dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs per inviare le informazioni trait relative all'esclusione per i dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
Inviate coppie chiave-valore per aggiungere informazioni trait relative alla qualifica per i dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Utilizzate il prefisso ic
per inviare le informazioni di qualifica trait per i dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Utilizzate trait IDs per inviare le informazioni trait relative alla qualifica per i dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs per inviare le informazioni trait relative all'esclusione per i dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oppure
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
oppure
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
Inviate coppie chiave-valore per aggiungere informazioni trait relative alla qualifica per i dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
oppure
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Utilizzate il prefisso ic
per inviare le informazioni di qualifica trait per i dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
oppure
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Utilizzare trait IDs per inviare le informazioni relative alla qualifica trait per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs per inviare trait le informazioni relative all'esclusione per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
Inviate coppie chiave-valore per aggiungere informazioni trait relative alla qualifica per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Utilizzare il prefisso ic
per inviare le informazioni relative alla qualifica di trait per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55