Campi obbligatori, sintassi e regole da seguire per la formattazione di un file di dati delle caratteristiche in entrata.
I campi nel file di dati in entrata devono essere visualizzati nell’ordine indicato di seguito. In questo esempio, la proprietà <
>
sono stati aggiunti dei simboli per separare visivamente ogni elemento. Non è necessario includerli nel file di dati.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Per altri formati di contenuto di file accettati, vedi Integrazioni di 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, sei a posto perché stai inviando 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 l’ID utente e gli ID caratteristica con un singolo delimitatore di tabulazione. |
|
Il Audience Manager ID caratteristica. Ti chiediamo di includere Solo caratteristiche onboarded nei file di dati in entrata. Non elaboriamo altri tipi di caratteristiche nel trasferimento di dati in entrata.
Nota: l’ID caratteristica può essere trovato utilizzando il metodo GET che restituisce i dettagli di tutte le caratteristiche. Per ulteriori informazioni, consulta Metodi API per le caratteristiche . |
Nella tabella seguente vengono descritti i prefissi che identificano trait nomi o ID in un file di dati in entrata. Consulta la file di esempio ad esempio.
Prefisso | Descrizione |
---|---|
|
Il |
|
Dati con prefisso Il |
|
Regole delle caratteristiche consente di impostare i criteri per la qualifica delle caratteristiche. Se si formatta una regola di caratteristiche come Ad esempio, supponiamo che tu crei queste 3 regole per le caratteristiche:
Queste caratteristiche sono associate al
|
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 costituite solo da caratteri numerici. Ti chiediamo di includere soloonboarded traits nei file di dati in entrata. Non elaboriamo nessun altro trait tipi nel trasferimento di dati in entrata.
Tipo di ID | Requisito |
---|---|
DPUUID |
Do not usa due punti codificati ( |
ID dispositivo mobile iOS (IDFA) o Android |
Gli ID dispositivo mobile devono essere formattati rigorosamente come mostrato di seguito:
|
Anche i nomi dei valori formattati in modo errato in una coppia chiave-valore causano problemi. Segui queste regole durante la creazione o la denominazione del valore in una coppia chiave-valore:
Carattere | Requisito |
---|---|
Carattere virgolette (") |
Puoi utilizzare le virgolette nella chiave e nella parte valore della coppia chiave-valore, come segue:
|
Carattere trattino (-) |
Ignoriamo i segni di trattino all'inizio delle chiavi. Ad esempio: |
|
Do not utilizzare |
|
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 dalle caratteristiche 28 e 29.
Nota: Invece di utilizzare d_unsid, puoi anche rimuovere le caratteristiche dai profili utente utilizzando la sintassi seguente:
|
Utilizzate |
Queste caratteristiche sono state aggiunte a una regola di caratteristiche con ID numerici
ID stringa
|
Con coppie chiave-valore |
Questi dati del file utilizzano coppie chiave-valore per trasmettere i dati a Audience Manager .
|
Scarica il file di dati di esempio, se sono necessari ulteriori esempi. Il file di download ha un .overwrite
estensione file. Puoi aprirlo con un semplice editor di testo.
Il grafico seguente mostra alcuni esempi del modo corretto di formattare i file in entrata, a seconda tipo di ID e il metodo da aggiungere traits ai profili.
Tipo ID / Operazione | Utilizzare d_sid per aggiungere caratteristiche a un profilo utente | Usa d_unsid per rimuovere caratteristiche da un profilo utente | Inviare coppie chiave-valore per aggiungere caratteristiche a un profilo utente | Utilizzare 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 da inviare trait informazioni sulla qualifica per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Utilizzare trait IDs da inviare trait informazioni sull’interdizione per 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
Inviare coppie chiave-valore da aggiungere trait informazioni sulla qualifica per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
oppure
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Utilizza il ic
prefisso da inviare trait informazioni sulla qualifica per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
oppure
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Utilizzare trait IDs da inviare trait informazioni sulla qualifica per Android dispositivi.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs da inviare trait informazioni sull’interdizione per Android dispositivi.
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
Inviare coppie chiave-valore da aggiungere trait informazioni sulla qualifica per Android dispositivi.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Utilizza il ic
prefisso da inviare trait informazioni sulla qualifica per Android dispositivi.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
oppure
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Utilizzare trait IDs da inviare trait informazioni sulla qualifica per iOS dispositivi.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs da inviare trait informazioni sull’interdizione per iOS dispositivi.
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
Inviare coppie chiave-valore da aggiungere trait informazioni sulla qualifica per iOS dispositivi.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
oppure
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Utilizza il ic
prefisso da inviare trait informazioni sulla qualifica per iOS dispositivi.
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 da inviare trait informazioni sulla qualifica per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Utilizzare trait IDs da inviare trait informazioni sull’interdizione 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
Inviare coppie chiave-valore da aggiungere trait informazioni sulla qualifica per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Utilizza il ic
prefisso da inviare trait informazioni sulla qualifica per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
oppure
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55