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 le jeu 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 de clé au format standard ou serialized.

  • 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 les valeurs entre clés et 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 clé-valeur : Sépare une clé et une valeur dans une paire clé-valeur.
  • Délimiteur clé-valeur : 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

Avec Destination Builder, vous 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 avec laquelle vous souhaitez travailler. Cependant, avant d'utiliser cette fonctionnalité, vous devez connaître la destination URL et l'emplacement de certaines macros obligatoires ou facultatives. Récupérez les informations sur l'emplacement des macros auprès de votre partenaire de destination. Voir Macros de destination définies pour plus d'informations.

Sur cette page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now