DocumentazioneAudience ManagerGuida utente di Audience Manager

Contenuti dei file di dati in entrata: sintassi, caratteri non validi, variabili ed esempi inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

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, sono stati aggiunti i simboli < > per aiutare a 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, vedere Integrazioni partner personalizzate.

NOTE
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.
code language-none 
<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>

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.

Variabile
Descrizione
User ID

Un ID utente può essere:

  • ID utente univoco assegnato da Audience Manager ( Audience Manager UUID).
  • Un ID utente univoco assegnato nel sistema CRM ( DPUUID, in Audience Manager).
  • Un ID dispositivo mobile Android o iOS nella sua forma originale non modificata come esposta 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
Separa l’ID utente e gli ID caratteristica con un singolo delimitatore di tabulazione.
trait ID

L'ID caratteristica di Audience Manager . 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, vedere Metodi API delle caratteristiche.

Formattazione di Trait IDs in corso formatting-trait-ids

Nella tabella seguente sono descritti i prefissi che identificano i nomi o gli ID trait in un file di dati in entrata. Per esempi, vedi file di esempio.

Prefisso
Descrizione
d_sid=
Il prefisso d_sid indica al sistema che l'ID è un ID caratteristica di Audience Manager . Questo è lo stesso ID visualizzato nell’interfaccia utente di. È inoltre possibile restituire gli ID delle caratteristiche con il metodo API GET . Vedere Metodi delle caratteristiche API.
d_unsid=

I dati con prefisso d_unsid rimuovono gli utenti da tale caratteristica. Il prefisso d_unsid viene ignorato in un file overwrite .

Il prefisso d_unsid= indica al sistema che l'ID è un ID caratteristica di Audience Manager . Questo è lo stesso ID visualizzato nell’interfaccia utente di. È inoltre possibile restituire gli ID delle caratteristiche con il metodo API GET . Vedere Metodi delle caratteristiche API.

ic=

Le regole delle caratteristicheti consentono di impostare i criteri per la qualifica delle caratteristiche. Se si formatta una regola di caratteristiche come ic == trait ID , è possibile 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 alla chiave ic . Questo consente di creare un elenco di caratteristiche più semplice nel file di dati. Non è necessario includere il prefisso ic . 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 in Trait IDs, User IDs e coppie chiave-valore invalid-chars

Trait IDs

Trait IDs è costituito solo da caratteri numerici. È necessario includere soloonboarded traits nei file di dati in entrata. Non vengono elaborati altri tipi trait nel trasferimento di dati in entrata.

User IDs

Tipo di ID
Requisito
DPUUID
Non utilizzare i due punti ( %3A ) o i due punti ( : ) non codificati nei DPUUID.
ID dispositivo Mobile iOS (IDFA) o Android

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:

Carattere
Requisito
Virgoletta (")

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"

Carattere trattino (-)
Ignoriamo i segni di trattino all'inizio delle chiavi. -product = camera , ad esempio, viene interpretato come product = camera .
TAB
Non utilizzare TAB invece di valori vuoti nelle coppie chiave-valore. Utilizzare TAB solo per separare le variabili nel file di dati in entrata.
\n, \t
Non utilizzare i nuovi caratteri di riga o di tabulazione ( \n, \t ) nelle chiavi o nei valori.

Esempi di file di dati data-file-examples

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 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

Con ic==

Queste caratteristiche sono state aggiunte a una regola di caratteristiche con il prefisso ic . 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 prefisso ic non è obbligatorio nel file.

ID numerici

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

ID stringa

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

Con coppie chiave-valore

I dati del file utilizzano coppie chiave-valore per passare i dati a Audience Manager .

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

Se hai bisogno di ulteriori esempi, scarica il file di dati di esempio. Il file di download ha l'estensione .overwrite. 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 del tipo di ID e del metodo con cui desideri 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 di Audience Manager
Esempio 1
Esempio 2
Esempio 3
Esempio 4
Google Advertising ID per dispositivi Android
Esempio 5
Esempio 6
Esempio 7
Esempio 8
Apple IDFA per dispositivi iOS
Esempio 9
Esempio 10
Esempio 11
Esempio 12
Il tuo ID CRM (DPUUID)
Esempio 13
Esempio 14
Esempio 15
Esempio 16

Esempio 1 example-1

Utilizzare trait IDs per 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 per inviare trait informazioni di esclusione 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 per aggiungere informazioni sulla qualifica trait per Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

oppure

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

Esempio 4 example-4

Utilizzare il prefisso ic per inviare informazioni sulla qualifica di trait 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 per 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 per inviare trait informazioni di esclusione 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 per aggiungere informazioni di qualificazione trait 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

Utilizzare il prefisso ic per inviare informazioni sulla qualifica di 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

Esempio 9 example-9

Utilizzare trait IDs per 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 per inviare trait informazioni di esclusione 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 per aggiungere informazioni di qualificazione trait 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

Utilizzare il prefisso ic per inviare informazioni sulla qualifica di 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

Esempio 13 example-13

Utilizzare trait IDs per 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 per inviare trait informazioni di 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

Esempio 15 example-15

Inviare coppie chiave-valore per aggiungere informazioni sulla qualifica di trait per DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

oppure

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

Esempio 16 example-16

Utilizzare il prefisso ic per inviare le informazioni sulla qualifica di trait per DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

oppure

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695