Coppie chiave-valore standard e seriali

Ultimo aggiornamento: 2023-05-20

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.

In questa pagina