Inbound Data File Contents: Syntax, Invalid Characters, Variables, and Examples inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Campi obbligatori, sintassi e regole da seguire per la formattazione di un file di dati delle caratteristiche in entrata.
Sintassi del contenuto dei file file-content-syntax
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.
code language-none |
---|
|
File Variables Defined file-variables-defined
La tabella elenca e definisce le variabili utilizzate in un file di dati in entrata formattato correttamente. Il corsivo indica un segnaposto variabile.
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, nell’Audience Manager).
- Un ID dispositivo mobile Android o iOS nella sua forma originale, non modificata, come esposto dal sistema operativo mobile.
Per gli ID mobili:
- Formato IDFA: gli ID devono essere scritti in maiuscolo e non con hash. Ad esempio,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: gli ID devono essere minuscoli e non con hash. Ad esempio,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
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.
Formattazione Trait IDs formatting-trait-ids
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.
d_sid=
d_sid
il prefisso comunica al nostro sistema che l’ID è un Audience Manager ID caratteristica. Questo è lo stesso ID visualizzato nell’interfaccia utente di. Puoi anche restituire gli ID delle caratteristiche con l’API GET
metodo. Consulta Metodi API per le caratteristiche.d_unsid=
Dati con prefisso d_unsid
rimuove gli utenti da quella caratteristica. Il d_unsid
il prefisso viene ignorato in un overwrite
file.
Il d_unsid=
il prefisso comunica al nostro sistema che l’ID è un Audience Manager ID caratteristica. Questo è lo stesso ID visualizzato nell’interfaccia utente di. Puoi anche restituire gli ID delle caratteristiche con l’API GET
metodo. Consulta Metodi API per le caratteristiche.
ic=
Regole delle caratteristicheconsente di impostare i criteri per la qualifica delle caratteristiche. Se si formatta una regola di caratteristiche come ic == trait ID
, puoi inviare le caratteristiche in un semplice elenco formattato con virgole.
Ad esempio, supponiamo che tu crei queste 3 regole per le caratteristiche:
ic == "123"
ic == "456"
ic == "789"
Queste caratteristiche sono associate al ic
chiave. Questo consente di creare un elenco di caratteristiche più semplice nel file di dati. Inoltre, non è necessario includere ic
prefisso. Di conseguenza, il contenuto del file di dati potrebbe essere simile al seguente:
user ID <TAB> 123,456,789
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 in Trait IDs, User IDs e coppie chiave-valore invalid-chars
Trait IDs
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.
User IDs
%3A
) o due punti non codificati ( : ) nei DPUUID.Gli ID dispositivo mobile devono essere formattati rigorosamente come mostrato di seguito:
- Formato IDFA: gli ID devono essere scritti in maiuscolo e non con hash. Ad esempio,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: gli ID devono essere minuscoli e non con hash. Ad esempio,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Coppie chiave-valore
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:
Puoi utilizzare le virgolette nella chiave e nella parte valore della coppia chiave-valore, come segue:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
viene interpretato come product = camera
.TAB
TAB
invece di valori vuoti nelle coppie chiave-valore. Usa solo TAB
per separare le variabili nel file di dati in entrata.\n, \t
\n, \t
) nelle chiavi o nei valori.Esempi di file di dati data-file-examples
d_sid
o d_unsid
Questo file di dati mostra un utente qualificato per le caratteristiche 24, 26, 27 ed è stato rimosso dalle caratteristiche 28 e 29.
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Nota:
Invece di utilizzare d_unsid, puoi anche rimuovere le caratteristiche dai profili utente utilizzando la sintassi seguente:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Queste caratteristiche sono state aggiunte a una regola di caratteristiche con ic
prefisso. Di conseguenza, puoi aggiungerli al file di dati separati da virgole, come illustrato nella figura. Una scheda separa l’UUID e gli ID delle caratteristiche. Il ic
prefisso non richiesto nel file.
ID numerici
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
ID stringa
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Questi dati del file utilizzano coppie chiave-valore per trasmettere i dati a Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
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.
Matrice di esempi examples-matrix
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.
Esempio 1 example-1
Utilizzare trait IDs da inviare trait informazioni sulla qualifica per Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Esempio 2 example-2
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
Esempio 3 example-3
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"
Esempio 4 example-4
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
Esempio 5 example-5
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
Esempio 6 example-6
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
Esempio 7 example-7
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"
Esempio 8 example-8
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
Esempio 9 example-9
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
Esempio 10 example-10
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
Esempio 11 example-11
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"
Esempio 12 example-12
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
Esempio 13 example-13
Utilizzare trait IDs da inviare trait informazioni sulla qualifica per DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Esempio 14 example-14
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
Esempio 15 example-15
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"
Esempio 16 example-16
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