�۶���Ƶ

Simple collections

Use simple collections for lists of basic values, such as strings, numbers, or booleans. These are useful when you only need to pass a list of items without additional properties.

For example, a list of device types:

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

Object collections

Use object collections when each item includes multiple fields or properties. These are typically used to pass structured data, such as product details, event records, or item attributes.

For example:

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

Support for Nested Arrays in Custom Actions

�۶���Ƶ Journey Optimizer supports nested arrays of objects in custom action response payloads, but this support is limited in request payloads.

In request payloads, nested arrays are only supported when they contain a fixed number of items, as defined in the custom action configuration. For example, if a nested array always includes exactly three items, it can be configured as a constant. When the number of items needs to be dynamic, only non-nested arrays (arrays at the bottom level) can be defined as variables.

Example:

1. The following example illustrates a non-supported use case.

   In this example, the products array includes a nested array (locations) with a dynamic number of items, which is not supported in request payloads.

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

2. Supported example, with fixed items defined as constants.

   In this case, the nested locations are replaced by fixed fields (location1, location2), allowing the payload to remain valid within the supported configuration.

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

Testing collections: To test collections using test mode, you must use code view mode. Note that code view mode is not supported for business events, so in that case, you can only send a collection containing a single element.