Envio de coleções em parâmetros de ação personalizados passing-collection

Coleções simples

Use coleções simples para listas de valores básicos, como sequências, números ou boolianos. Elas são úteis quando você só precisa passar uma lista de itens sem propriedades adicionais.

Por exemplo, uma lista de tipos de dispositivos:

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

Coleções de objetos

Use coleções de objetos quando cada item incluir vários campos ou propriedades. Normalmente, eles são usados para transmitir dados estruturados, como detalhes do produto, registros de evento ou atributos de item.

Por exemplo:

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

Suporte para Matrizes Aninhadas em Ações Personalizadas

O Adobe Journey Optimizer oferece suporte a matrizes aninhadas de objetos em cargas de resposta de ação personalizada, mas esse suporte é limitado em cargas de solicitação.

Nas cargas de solicitação, matrizes aninhadas só são suportadas quando contêm um número fixo de itens, conforme definido na configuração de ação personalizada. Por exemplo, se uma matriz aninhada sempre incluir exatamente três itens, ela poderá ser configurada como uma constante. Quando o número de itens precisa ser dinâmico, somente as matrizes não aninhadas (matrizes no nível inferior) podem ser definidas como variáveis.

Exemplo:

1. O exemplo a seguir ilustra um caso de uso não suportado.

   Neste exemplo, a matriz products inclui uma matriz aninhada (locations) com um número dinâmico de itens, para o qual não há suporte em cargas de solicitação.

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

2. Exemplo compatível, com itens fixos definidos como constantes.

   Nesse caso, os locais aninhados são substituídos por campos fixos (location1, location2), permitindo que a carga permaneça válida dentro da configuração com suporte.

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

Testando coleções: para testar coleções usando o modo de teste, você deve usar o modo de exibição de código. Observe que o modo de exibição de código não é compatível com eventos comerciais, portanto, nesse caso, você só pode enviar uma coleção contendo um único elemento.