Coppie chiave-valore standard e seriali

Una coppia chiave-valore è costituita da elementi correlati: Una chiave, che è una costante che definisce il set di dati (ad esempio, genere, colore, prezzo) e un valore, che è una variabile che appartiene al set (ad esempio, maschio/femmina, verde, 100). Destination Builder invia dati formattati come coppie chiave-valore.

Coppie chiave-valore di base

Completamente formato, un set di base di coppia chiave-valore potrebbe essere simile al seguente:

gender = male
color = green
price > 100

Coppie chiave-valore standard e seriali

Le destinazioni accettano dati chiave-valore in standard o serialized formato.

Coppie chiave-valore standard: Formatta i dati di destinazione in coppie chiave-valore separate. Ogni chiave viene dichiarata esplicitamente, anche se utilizzata di nuovo per definire un valore diverso.
Coppie chiave-valore serializzate: Limita più valori in una singola coppia chiave-valore. In una coppia chiave-valore serializzata, un indicatore speciale separa i valori all’interno dell’insieme chiave-valore.

I valori chiave standard e serializzati possono contenere uno o più valori. Nella tabella seguente vengono forniti esempi di formati chiave-valore standard e seriali.

Formattazione	Coppie chiave-valore singole	Più coppie chiave-valore
Standard	`x = 1 & x = 2`	`x = 1 & x = 2 & y = 3 & y = 4`
Serializzato	`x = 1 ; 2`	`x = 1 ; 2 & y = 3 ; 4`

Delimitatori e separatori

I caratteri che separano i valori all’interno e tra le chiavi e i valori sono noti come delimiters e separators. Questi diventano particolarmente importanti quando invii segmenti a una destinazione in formato seriale. La serializzazione consente di trasmettere più valori con una singola chiave e di combinare coppie chiave-valore. I delimitatori e i separatori sono definiti come segue:

Separatore chiave-valore: Separa una chiave e un valore all'interno di una coppia chiave-valore.
Delimitatore chiave-valore: Separa gli insiemi di coppie chiave-valore.
Separatore seriale: Separa più valori all'interno di insiemi di coppie chiave-valore serializzate.

Esempi

Con Destination Builder puoi formattare i dati chiave-valore in diversi modi. Diamo un'occhiata ad alcuni esempi di ciascun tipo.

Esempi di coppie chiave-valore	Esempio	Descrizione
Chiave singola standard	`X = 1 & X = 2`	Un semplice set di coppie chiave-valore. L’esempio contiene i seguenti elementi: Chiave: X Valori: 1, 2 Separatore: = Delimitatore chiave-valore: e
Più coppie chiave-valore (non seriale)	`X = 1 & X = 2 & Y = 3 & Y = 4`	Un insieme di più coppie chiave-valore che trasmettono valori con insiemi chiave-valore separati. L’esempio contiene i seguenti elementi: Tasti: X, Y Valori: 1, 2, 3, 4 Separatore: = Delimitatore chiave-valore: e
Chiave seriale singola	`X = 1 ; 2 ; 3`	Set chiave-valore che trasmette più valori con una singola chiave. Poiché questa chiave ha più valori, è nota come coppia chiave-valore serializzata. L’esempio contiene i seguenti elementi: Chiave: X Valori: 1, 2, 3 Separatore: = Separatore seriale: punto e virgola
Più coppie chiave-valore (seriale)	`X = 1 ; 2 & Y = 3 ; 4`	Un insieme di più coppie chiave-valore che passano più valori su chiavi separate. L’esempio contiene i seguenti elementi: Tasti: X, Y Valori: 1, 2, 3, 4 Separatore: = Delimitatore: & Separatore seriale: punto e virgola

Serializzazione della destinazione

Una destinazione serializzata combina più caratteristiche in una singola stringa e invia tali informazioni a una destinazione.

La trasmissione serializzata dei dati aiuta a migliorare l’efficienza perché più caratteristiche si attivano in sequenza, anziché in parallelo. In questo modo il server di destinazione dispone di tempo sufficiente per ricevere, elaborare e restituire i dati prima di rispondere a richieste aggiuntive.

Destinazioni supportate

In entrata Audience Manager, puoi serializzare e inviare dati a praticamente qualsiasi destinazione con cui desideri lavorare. Tuttavia, prima di utilizzare questa funzione, è necessario conoscere la destinazione URL e dove inserire alcune macro obbligatorie o facoltative. Ottenere le informazioni sul posizionamento delle macro dal partner di destinazione. Consulta Definizione delle macro di destinazione per ulteriori informazioni.