Show Menu
ARGOMENTI×

Contenuto file dati in entrata: Sintassi, caratteri non validi, variabili ed esempi

Campi, sintassi e regole obbligatori da seguire per la formattazione di un file di dati con caratteristiche in entrata.

Sintassi contenuto file

I campi nel file di dati in entrata devono essere visualizzati nell'ordine indicato di seguito. In questo esempio, i < > simboli sono stati aggiunti per aiutare a separare visivamente ogni elemento. Non è necessario includerli nel file di dati.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

Per gli altri formati di contenuto file accettati, consulta 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>

Variabili file definite

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
User ID
Un ID utente può essere:
  • Un ID utente univoco assegnato da Audience Manager (UUID Audience Manager ).
  • Un ID utente univoco assegnato nel sistema CRM ( DPUUID, in Audience Manager ).
  • Un ID dispositivo mobile Android o iOS nel modulo originale e non modificato come esposto dal sistema operativo mobile.
Per gli ID mobili:
  • Formato IDFA: Gli ID devono essere in lettere maiuscole e non con hash. Ad esempio, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: Gli ID devono essere in lettere maiuscole e non con hash. Ad esempio, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Separa ID utente e ID caratteristica con un singolo delimitatore di tabulazione.
trait ID
L’ID caratteristica di 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, consulta Metodi API per le caratteristiche .

Formattazione degli ID caratteristica

Nella tabella seguente sono descritti i prefissi che identificano i nomi o gli ID delle caratteristiche in un file di dati in entrata. Per esempi, consultate i file di esempio.
Prefisso Descrizione
d_sid=
Il d_sid prefisso indica al sistema che l’ID è un ID di caratteristica Audience Manager. Si tratta dello stesso ID mostrato nell'interfaccia utente. Potete inoltre restituire gli ID caratteristica con il GET metodo API. Consulta Metodi API per le caratteristiche .
d_unsid=
I dati con prefisso d_unsid rimuovono gli utenti da tale caratteristica. Il d_unsid prefisso viene ignorato in un overwrite file.
Il d_unsid= prefisso indica al sistema che l’ID è un ID di caratteristica Audience Manager. Si tratta dello stesso ID mostrato nell'interfaccia utente. Potete inoltre restituire gli ID caratteristica con il GET metodo API. Consulta Metodi API per le caratteristiche .
ic=
Le regole sulle caratteristiche consentono di impostare i criteri per la qualifica delle caratteristiche. Se formattate una regola di caratteristiche come ic == trait ID , potete inviare le caratteristiche in un semplice elenco in formato virgola.
Ad esempio, supponiamo di creare le seguenti 3 regole di caratteristiche:
  • ic == "123"
  • ic == "456"
  • ic == "789"
Tali caratteristiche sono associate alla ic chiave. Questo consente di creare un elenco di caratteristiche più semplice nel file di dati. Inoltre, non è necessario includere il ic prefisso. Di conseguenza, il contenuto del file di dati potrebbe essere simile al seguente:
                 user ID  <TAB> 123,456,789
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:
  • key = value
  • "key" = value
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sono tutti esempi di coppie chiave-valore formattate correttamente.

Caratteri non validi negli ID caratteristica, negli ID utente e nelle coppie chiave-valore

ID caratteristica

Gli ID caratteristica sono costituiti solo da caratteri numerici. 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.

ID utente

Tipo di ID Requisito
DPUUID
Non usate due punti codificati ( %3A ) o due punti non codificati ( : ) in DPUUID.
ID dispositivo iOS (IDFA) mobile o Android
Gli ID dispositivo mobile devono essere formattati in modo rigoroso come illustrato di seguito:
  • Formato IDFA: Gli ID devono essere in lettere maiuscole e non con hash. Ad esempio, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: Gli ID devono essere in lettere maiuscole e non con hash. Ad esempio, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Coppie chiave-valore

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:
  • d_city = "New York", d_city = "San Francisco"
  • "d_city" = "New York", "d_city" = "San Francisco"
Carattere trattino (-)
Ignoriamo i segni di tratteggio all'inizio delle chiavi. Ad esempio, -product = camera viene interpretato come product = camera .
TAB
Non utilizzare valori TAB invece di valori vuoti nelle coppie chiave-valore. Utilizzate solo TAB per separare le variabili nel file di dati in entrata.
\n, \t
Non utilizzare la nuova riga o i nuovi caratteri di tabulazione ( \n, \t ) nelle chiavi o nei valori.

Esempi di file di dati

Formato file dati Descrizione ed esempio
Con d_sid o d_unsid
Questo file di dati mostra un utente qualificato per le caratteristiche 24, 26, 27 ed è stato rimosso dalla caratteristica 28 e 29.
59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Nota:
Invece di utilizzare d_unsid, potete anche rimuovere le caratteristiche dai profili utente utilizzando la sintassi seguente:
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1
Utilizzate ic==
Queste caratteristiche sono state aggiunte a una regola delle caratteristiche con il ic prefisso . In questo modo, è possibile aggiungerli al file di dati separati da virgole come mostrato. Una scheda separa gli UUID e gli ID caratteristica. Il ic prefisso non è richiesto nel file.
ID numerici
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626
ID stringa
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55
Con coppie chiave-valore
Questi dati del file utilizzano coppie chiave-valore per trasmettere i dati ad Audience Manager .
59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”
Scaricate il file di dati di esempio se avete bisogno di ulteriori esempi. Il file di download ha un'estensione .overwrite file. Potete aprirlo con un semplice editor di testo.

Esempio di matrice

Il grafico seguente illustra 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 caratteristiche ai profili.
Tipo di ID / Funzionamento Utilizzare d_sid per aggiungere caratteristiche a un profilo utente Usa d_unsid per rimuovere 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 di Audience Manager
Google Advertising ID per dispositivi Android
Apple IDFA per dispositivi iOS
Il tuo ID CRM (DPUUID)

Example 1

Usate gli ID caratteristica per inviare informazioni sulla qualifica delle caratteristiche agli UUID di Audience Manager.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Usate gli ID caratteristica per inviare informazioni sull’esclusione delle caratteristiche agli UUID di Audience Manager.
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

Example 3

Inviate coppie chiave-valore per aggiungere informazioni sulla qualifica delle caratteristiche agli UUID di Audience Manager.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

 oppure 
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

Example 4

Usate il prefisso ic per inviare informazioni sulla qualifica delle caratteristiche agli UUID di Audience Manager.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

 oppure 
59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

Usate gli ID caratteristica per inviare informazioni sulla qualifica delle caratteristiche ai dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Usate gli ID caratteristica per inviare informazioni sulla squalifica delle caratteristiche ai 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

Example 7

Inviate coppie chiave-valore per aggiungere informazioni sulla qualifica delle caratteristiche 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"

Example 8

Usate il prefisso ic per inviare informazioni sulla qualifica delle caratteristiche ai dispositivi Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

 oppure 
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

Example 9

Utilizzate gli ID caratteristica per inviare informazioni sulla qualifica delle caratteristiche per i dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Utilizzate gli ID caratteristica per inviare informazioni sull'esclusione delle caratteristiche 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

Example 11

Invia coppie chiave-valore per aggiungere informazioni sulla qualifica delle caratteristiche 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"

Example 12

Usate il prefisso ic per inviare informazioni sulla qualifica delle caratteristiche ai dispositivi iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

 oppure 
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

Example 13

Usa gli ID caratteristica per inviare informazioni sulla qualifica delle caratteristiche per i DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Utilizzate gli ID caratteristica per inviare informazioni sulla qualificazione delle caratteristiche per i DPUUID.
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

Example 15

Invia coppie chiave-valore per aggiungere informazioni sulla qualifica delle caratteristiche per DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

 oppure 
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

Example 16

Utilizzate il prefisso ic per inviare informazioni sulla qualifica delle caratteristiche per i DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

 oppure 
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55