Transmettre des collections dans des paramètres d’actions personnalisées passing-collection

Collections simples

Vous pouvez utiliser des collections simples pour les listes de valeurs de base, telles que des chaînes, des nombres ou des booléens. Elles s’avèrent utiles lorsque vous n’avez besoin de transmettre qu’une liste d’éléments sans propriétés supplémentaires.

Par exemple, une liste de types d’appareils :

{
 "deviceTypes": [
     "android",
     "ios"
 ]
}

Collections d’objets

Vous pouvez utiliser des collections d’objets lorsque chaque élément comprend plusieurs champs ou propriétés. Elles servent habituellement à transmettre des données structurées, telles que des détails de produit, des enregistrements d’événement ou des attributs d’élément.

Par exemple :

{
"products":[
   {
      "id":"productA",
      "name":"A",
      "price":20.1
   },
   {
      "id":"productB",
      "name":"B",
      "price":10.0
   },
   {
      "id":"productC",
      "name":"C",
      "price":5.99
   }
 ]
}

Prise en charge des tableaux imbriqués dans les actions personnalisées

Adobe Journey Optimizer prend en charge les tableaux d’objets imbriqués dans les payloads de réponse des actions personnalisées, mais cette prise en charge est limitée dans les payloads de requête.

Dans les payloads de requête, les tableaux imbriqués ne sont pris en charge que s’ils contiennent un nombre fixe d’éléments, comme défini dans la configuration de l’action personnalisée. Par exemple, si un tableau imbriqué comprend toujours exactement trois éléments, il peut être configuré comme une constante. Lorsque le nombre d’éléments doit être dynamique, seuls les tableaux non imbriqués (tableaux au niveau inférieur) peuvent être définis comme variables.

Exemple :

1. L’exemple suivant illustre un cas d’utilisation non pris en charge.

   Dans cet exemple, le tableau « products » comprend un tableau imbriqué (locations) avec un nombre dynamique d’éléments, qui n’est pas pris en charge dans les payloads de requête.

   code language-json
   { "products": [ { "id": "productA", "name": "A", "price": 20, "locations": [ { "name": "Paris" }, { "name": "London" } ] } ] }

2. Exemple pris en charge, avec des éléments fixes définis comme des constantes.

   Dans ce cas, les emplacements imbriqués sont remplacés par des champs fixes (location1, location2), ce qui permet à la payload de rester valide dans la configuration prise en charge.

   code language-json
   { "products": [ { "id": "productA", "name": "A", "price": 20, "location1": { "name": "Paris" }, "location2": { "name": "London" } } ] }

Test des collections : pour tester des collections à l’aide du mode test, vous devez utiliser le mode d’affichage du code. Notez que le mode d’affichage du code n’est pas pris en charge pour les événements métier. Dans ce cas, vous ne pouvez donc envoyer qu’une collection contenant un seul élément.