Sur cette page : découvrez comment transmettre des collections d’objets simples et dans des paramètres d’action personnalisés afin qu’elles soient renseignées dynamiquement au moment de l’exécution.
Vous pouvez transmettre une collection dans des paramètres d’actions personnalisées qui seront renseignés dynamiquement au moment de l’exécution.
Deux types de collections sont pris en charge :
-
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 :
code language-json { "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 :
code language-json { "products":[ { "id":"productA", "name":"A", "price":20.1 }, { "id":"productB", "name":"B", "price":10.0 }, { "id":"productC", "name":"C", "price":5.99 } ] }
Procédure générale general-procedure
Dans cette section, nous utiliserons l’exemple de payload JSON ci-après. Il s’agit d’un tableau d’objets avec un champ qui est une collection simple.
{
"ctxt": {
"products": [
{
"id": "productA",
"name": "A",
"price": 20.1,
"color":"blue",
"locations": [
"Paris",
"London"
]
},
{
"id": "productB",
"name": "B",
"price": 10.99
}
]
}
}
Vous pouvez voir que products est un tableau de deux objets. Vous devez avoir au moins un objet.
-
Créez votre action personnalisée. En savoir plus sur cette page.
-
Dans la section Paramètres d’action, collez l’exemple JSON. La structure affichée est statique : lorsque vous collez la payload, tous les champs sont définis comme des constantes.
-
Si nécessaire, ajustez les types de champs. Les types de champs suivants sont pris en charge pour les collections : listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly, listObject
note NOTE Le type de champ est automatiquement déduit en fonction de l’exemple de payload. -
Si vous souhaitez transmettre des objets de façon dynamique, vous devez les définir en tant que variables. Dans cet exemple, nous définissons
productscomme variable. Tous les champs d’objet inclus dans l’objet sont automatiquement définis sur des variables.note NOTE Le premier objet de l’exemple de payload est utilisé pour définir les champs. -
Pour chaque champ, définissez le libellé qui sera affiché dans la zone de travail du parcours.
-
Créez votre parcours et ajoutez l’action personnalisée que vous avez créée. En savoir plus sur cette page.
-
Dans la section Paramètres d’action, définissez le paramètre de tableau (
productsdans notre exemple) à l’aide de l’éditeur d’expression avancé.
-
Pour chacun des champs d’objet suivants, saisissez le nom de champ correspondant à partir du schéma XDM source. Si les noms sont identiques, cela n’est pas nécessaire. Dans notre exemple, il nous suffit de définir
product idet « color ».
Pour le champ de tableau, vous pouvez également utiliser l’éditeur d’expression avancé pour effectuer une manipulation de données. Dans l’exemple suivant, nous utilisons les fonctions filter et intersect :
Limites limitations
Bien que les collections dans les actions personnalisées offrent la flexibilité nécessaire pour transmettre des données dynamiques, certaines contraintes structurelles doivent être prises en compte :
-
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 actions personnalisées payloads de réponse, 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 :
-
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" } ] } ] } -
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.
Cas particuliers examples
Pour les types et les tableaux de tableaux hétérogènes, le tableau est défini avec le type listAny. Vous pouvez uniquement mapper des éléments individuels, mais ne pouvez pas modifier le tableau en variable.
Exemple de type hétérogène :
{
"data_mixed-types": [
"test",
"test2",
null,
0
]
}
Exemple de tableau de tableaux :
{
"data_multiple-arrays": [
[
"test",
"test1",
"test2"
]
]
}
Ressources supplémentaires
Parcourez les sections suivantes pour en savoir plus sur la configuration des actions personnalisées, l’utilisation de celles-ci et la résolution des problèmes liés à celles-ci :
- Commencer avec les actions personnalisées : découvrez en quoi consiste une action personnalisée et comment elle vous permet de vous connecter à vos systèmes tiers.
- Configurer vos actions personnalisées : découvrez comment créer et configurer une action personnalisée.
- Utiliser des actions personnalisées : découvrez comment utiliser des actions personnalisées dans vos parcours.
- Dépanner une action personnalisée : découvrez comment dépanner une action personnalisée.
- Itérer sur les données contextuelles - Découvrez comment utiliser des tableaux dans les expressions de Parcours et effectuer une itération sur les réponses d’action personnalisée, les données d’événement et les recherches de jeux de données dans la personnalisation des messages
Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.
Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.
- TL;DR: Cette page explique comment transmettre dynamiquement des collections d’objets simples et dans des paramètres d’action personnalisés dans Journey Optimizer, y compris les types de champs pris en charge, la procédure de configuration et les limites connues autour des tableaux imbriqués.
Intentions:
- Configurez une action personnalisée pour accepter une collection (simple ou objet) comme paramètre dynamique
- Définissez les paramètres de tableau comme variables dans l’éditeur d’expression avancé lors de la création d’un parcours
- Appliquez des fonctions filter et intersect pour manipuler les données de tableau dans l’éditeur d’expression
- Comprendre et travailler dans les limites des tableaux imbriqués pour les payloads de requêtes d’action personnalisées
- Test des paramètres de collection à l’aide du mode Affichage du code en mode test parcours
Glossaire:
- Collection simple : liste de valeurs scalaires de base (chaînes, nombres, booléens) transmises en tant que paramètre d’action personnalisé (spécifique au produit)
- Collection d’objets : liste d’objets structurés comportant chacun plusieurs champs, transmis en tant que paramètre d’action personnalisé (spécifique au produit)
- listObject : type de champ utilisé dans la configuration d’une action personnalisée pour représenter un tableau d’objets (spécifique au produit)
- listAny : type de champ utilisé pour les tableaux hétérogènes ou les tableaux de tableaux dans lesquels les éléments ont des types mixtes (spécifiques au produit)
- Variable (vs. constante) : dans la configuration du paramètre d’action, un champ défini sur « variable » est renseigné dynamiquement au moment de l’exécution à partir du contexte de parcours, tandis qu’une « constante » est une valeur fixe définie au moment de la configuration (spécifique au produit)
Mécanismes de sécurisation :
- Les tableaux imbriqués dans les payloads de requête ne sont pris en charge que s’ils contiennent un nombre fixe d’éléments (définis comme des constantes) ; les tableaux imbriqués dynamiques ne sont pas pris en charge
- Le mode Affichage du code est requis pour tester les collections en mode test ; l’affichage du code n’est pas pris en charge pour les événements métier, de sorte que seules les collections à un seul élément peuvent être envoyées dans ce cas
- Au moins un objet doit être présent dans l’exemple de payload utilisé pour définir les champs de collection
- Le premier objet de l’exemple de payload définit les champs pour l’ensemble de la collection
Terminologie:
- Nom canonique : Collection — Acronyme : none — variantes : tableau, liste, collection dynamique
- Synonymes : « collection simple » = « liste de valeurs scalaires » ; « collection d’objets » = « tableau d’objets »
- Ne les confondez pas : « listAny » ≠ « listObject » (listAny gère des tableaux hétérogènes ou imbriqués ; listObject gère des tableaux uniformes d’objets structurés)
FAQ:
- Q : Quelle est la différence entre une collection simple et une collection d’objets ? — Une collection simple contient des valeurs scalaires de base (chaînes, nombres, booléens), tandis qu’une collection d’objets contient des objets structurés ayant chacun plusieurs champs nommés.
- Q : Comment rendre un paramètre de collection dynamique au moment de l’exécution ? — Dans la section Paramètres d’action de l’action personnalisée, définissez le champ de tableau sur « variable » ; tous les champs d’objet qu’il contient sont alors automatiquement définis sur des variables.
- Q : Les tableaux imbriqués sont-ils pris en charge dans les payloads de requête d’action personnalisée ? — En partie seulement. Les tableaux imbriqués avec un nombre fixe connu d’éléments peuvent être définis comme des constantes. Les tableaux imbriqués avec un nombre dynamique d’éléments ne sont pas pris en charge dans les payloads de requête.
- Q : Comment tester une collection en mode parcours ? — Utilisez le mode Affichage du code dans l’interface de test. Notez que les événements métier ne prennent pas en charge l’affichage du code. Par conséquent, seules les collections à un seul élément peuvent être testées dans ce contexte.
- Q : Quels types de champs sont pris en charge pour les collections ? — listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly et listObject sont tous pris en charge.