Show Menu
SUJETS×

Paires clé-valeur standard et de série

Une paire clé-valeur se compose d’éléments connexes : Une clé, qui est une constante qui définit l'ensemble de données (par exemple, sexe, couleur, prix) et une valeur, qui est une variable qui appartient à l'ensemble (par exemple, mâle/femelle, vert, 100). Destination Builder envoie des données formatées en paires clé-valeur.

Paires de valeurs clés de base

Entièrement formé, un ensemble de base de paires clé-valeur peut ressembler à ceci :
  • gender = male
  • color = green
  • price > 100

Paires clé-valeur standard et de série

Les destinations acceptent les données de valeur clé dans standard ou serialized le format.
  • Paires clé-valeur standard : Formate les données de destination en paires clé-valeur distinctes. Chaque clé est explicitement indiquée, même si elle est utilisée de nouveau pour définir une autre valeur.
  • Paires clé-valeur sérialisées : Condense plusieurs valeurs en une seule paire clé-valeur. Dans une paire clé-valeur sérialisée, un indicateur spécial sépare les valeurs de l’ensemble clé-valeur.
Les valeurs clés standard et sérialisées peuvent contenir une ou plusieurs valeurs. Le tableau suivant fournit des exemples de formats de valeur de clé standard et de série.
Formatage Paires à valeur clé unique Paires de valeurs clés multiples
Standard
x = 1 & x = 2
x = 1 & x = 2 & y = 3 & y = 4
Sérialisé
x = 1 ; 2
x = 1 ; 2 & y = 3 ; 4

Délimiteurs et séparateurs

Les caractères qui séparent des valeurs dans et entre des clés et des valeurs sont appelés delimiters et separators . Elles deviennent particulièrement importantes lorsque vous envoyez des segments à une destination au format série. La sérialisation vous permet de transmettre plusieurs valeurs à l’aide d’une seule clé et de combiner des paires clé-valeur. Les délimiteurs et les séparateurs sont définis comme suit :
  • Séparateur de valeur de clé : Sépare une clé et une valeur dans une paire clé-valeur.
  • Délimiteur de valeur de clé : Sépare les ensembles de paires clé-valeur.
  • Séparateur de série : Sépare plusieurs valeurs dans des ensembles de paires clé-valeur sérialisées.

Exemples

Vous Destination Builder pouvez formater les données clé-valeur de plusieurs manières différentes. Examinons quelques exemples de chaque type.
Exemples de paires clé-valeur Exemple Description
Clé unique standard
X = 1 & X = 2
Un ensemble simple de paires clé-valeur. L’exemple contient les éléments suivants :
  • Clé : X
  • Valeurs : 1, 2
  • Séparateur : =
  • Délimiteur de valeur de clé : &
Plusieurs paires clé-valeur (non série)
X = 1 & X = 2 & Y = 3 & Y = 4
Ensemble de plusieurs paires clé-valeur qui transmettent des valeurs avec des ensembles clé-valeur distincts. L’exemple contient les éléments suivants :
  • Clés : X, Y
  • Valeurs : 1, 2, 3, 4
  • Séparateur : =
  • Délimiteur de valeur de clé : &
Clé unique série
X = 1 ; 2 ; 3
Ensemble clé-valeur qui transmet plusieurs valeurs à l’aide d’une seule clé. Comme cette clé possède plusieurs valeurs, elle est connue sous le nom de paire clé-valeur sérialisée. L’exemple contient les éléments suivants :
  • Clé : X
  • Valeurs : 1, 2, 3
  • Séparateur : =
  • Séparateur de série : point-virgule
Plusieurs paires clé-valeur (série)
X = 1 ; 2 & Y = 3 ; 4
Ensemble de plusieurs paires clé-valeur qui transmettent plusieurs valeurs sur des clés distinctes. L’exemple contient les éléments suivants :
  • Clés : X, Y
  • Valeurs : 1, 2, 3, 4
  • Séparateur : =
  • Délimiteur: &
  • Séparateur de série : point-virgule

Sérialisation de destination

Une destination sérialisée combine plusieurs caractéristiques en une seule chaîne et envoie ces informations à une destination.
La transmission de données sérialisées permet d’améliorer l’efficacité car plusieurs caractéristiques se déclenchent de manière séquentielle, plutôt qu’en parallèle. Le serveur de destination dispose ainsi de suffisamment de temps pour recevoir, traiter et renvoyer des données avant de répondre à d’autres requêtes.

Destinations prises en charge

Dans Audience Manager, vous pouvez sérialiser et envoyer des données vers n’importe quelle destination que vous souhaitez utiliser. Cependant, avant d'utiliser cette fonctionnalité, vous devez connaître la destination URL et l'endroit où placer certaines macros obligatoires ou facultatives. Récupérez les informations sur l'emplacement des macros auprès de votre partenaire de destination. Voir Définition des macros de destination pour plus d’informations.