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 coppie 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 formato standard o serialized .

Coppie chiave-valore standard: formatta i dati di destinazione in coppie chiave-valore separate. Ogni chiave è indicata esplicitamente, anche quando viene utilizzata di nuovo per definire un valore diverso.
Coppie chiave-valore serializzate: condensa 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 sono riportati alcuni esempi di formati chiave standard e seriali.

Formattazione	Coppie chiave-valore singole	Coppie chiave-valore multiple
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 sono particolarmente importanti quando invii segmenti a una destinazione in un 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 i set di coppie chiave-valore.
Separatore seriale: separa più valori all'interno di set di coppie chiave-valore serializzate.

Esempi

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

Esempi di coppia chiave-valore	Esempio	Descrizione
Chiave singola standard	`X = 1 & X = 2`	Un set semplice di coppie chiave-valore. L’esempio contiene i seguenti elementi: Chiave: X Valori: 1, 2 Separatore: = delimitatore chiave-valore: &
Più coppie chiave-valore (non seriali)	`X = 1 & X = 2 & Y = 3 & Y = 4`	Set di coppie chiave-valore multiple che trasmettono valori con set chiave-valore separati. L’esempio contiene i seguenti elementi: Chiavi: X, Y Valori: 1, 2, 3, 4 Separatore: = delimitatore chiave-valore: &
Chiave singola seriale	`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 (seriali)	`X = 1 ; 2 & Y = 3 ; 4`	Un set di coppie chiave-valore multiple che trasmettono più valori su chiavi separate. L’esempio contiene i seguenti elementi: Chiavi: X, Y Valori: 1, 2, 3, 4 Separatore: = Delimitatore: & Separatore seriale: punto e virgola

Serializzazione delle destinazioni

Una destinazione serializzata combina più caratteristiche in una singola stringa e le invia 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 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 il punto in cui collocare alcune macro obbligatorie o facoltative. Per ottenere informazioni sul posizionamento delle macro dal partner di destinazione, Per ulteriori informazioni, consulta Definizione delle macro delle destinazioni .