Übergeben von Sammlungen in Parameter benutzerdefinierter Aktionen passing-collection

Einfache Sammlungen

Verwenden Sie einfache Sammlungen für Listen grundlegender Werte wie Strings, Zahlen oder boolesche Werte. Diese sind nützlich, wenn Sie nur eine Liste von Elementen ohne zusätzliche Eigenschaften übergeben müssen.

Ein Beispiel dafür ist eine Liste von Gerätetypen:

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

Objektsammlungen

Verwenden Sie Objektsammlungen, wenn jedes Element mehrere Felder oder Eigenschaften enthält. Diese werden normalerweise verwendet, um strukturierte Daten wie Produktdetails, Ereigniseinträge oder Elementattribute zu übergeben.

Beispiel:

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

Unterstützung verschachtelter Arrays in benutzerdefinierten Aktionen

Adobe Journey Optimizer unterstützt verschachtelte Arrays von Objekten in Antwort-Payloads benutzerdefinierter Aktionen, diese Unterstützung ist jedoch in Anfrage-Payloads eingeschränkt.

In Anfrage-Payloads werden verschachtelte Arrays nur dann unterstützt, wenn sie eine feste Anzahl von Elementen enthalten, wie in der Konfiguration der benutzerdefinierten Aktion definiert. Wenn ein verschachteltes Array beispielsweise immer genau drei Elemente enthält, kann es als Konstante konfiguriert werden. Wenn die Anzahl der Elemente dynamisch sein muss, können nur nicht verschachtelte Arrays (Arrays auf der unteren Ebene) als Variablen definiert werden.

Beispiel:

1. Das folgende Beispiel zeigt einen nicht unterstützten Anwendungsfall.

   In diesem Beispiel enthält das Produkt-Array ein verschachteltes Array (locations) mit einer dynamischen Anzahl von Elementen, das in Anfrage-Payloads nicht unterstützt wird.

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

2. Beispiel eines unterstützten Anwendungsfalls mit festen Elementen, die als Konstanten definiert sind.

   In diesem Fall werden die verschachtelten Speicherorte durch feste Felder (location1, location2) ersetzt, sodass die Payload in der unterstützten Konfiguration gültig bleibt.

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

Testen von Sammlungen: Um Sammlungen im Testmodus zu testen, müssen Sie den Code-Ansichtsmodus verwenden. Beachten Sie, dass der Code-Ansichtsmodus für Geschäftsereignisse nicht unterstützt wird. In diesem Fall können Sie also nur eine Sammlung senden, die ein einzelnes Element enthält.