カスタムアクションパラメーターへのコレクションの受け渡し passing-collection

シンプルなコレクション

文字列、数値、ブール値などの基本的な値のリストには、シンプルなコレクションを使用します。 これらは、追加のプロパティなしで項目のリストのみを渡す必要がある場合に役立ちます。

例えば、デバイスタイプのリストは次のようになります。

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

オブジェクトコレクション

各項目に複数のフィールドやプロパティが含まれている場合は、オブジェクトコレクションを使用します。これらは通常、製品の詳細、イベントレコード、項目属性などの構造化データを渡すために使用されます。

例：

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

カスタムアクションでのネストされた配列のサポート

Adobe Journey Optimizer は、カスタムアクション​ 応答ペイロード ​内のオブジェクトのネストされた配列をサポートしていますが、このサポートは​ リクエストペイロード ​に制限されています。

リクエストペイロードでは、ネストされた配列は、カスタムアクション設定で定義されているように、固定数の項目が含まれている場合にのみサポートされます。例えば、ネストされた配列に常に 3 つの項目が含まれる場合は、定数として設定できます。項目の数を動的にする必要がある場合、ネストされていない配列（下部レベルの配列）のみを変数として定義できます。

例：

1. 次の例は、サポートされていないユースケース​を示しています。

   この例では、products 配列に、動的な項目数を持つネストされた配列（locations）が含まれていますが、これはリクエストペイロードではサポートされていません。

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

2. 定数として定義された固定項目でサポートされる例。

   この場合、ネストされた場所は固定フィールド（location1、location2）に置き換えられ、サポートされる設定内でペイロードを有効なままにすることができます。

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

コレクションのテスト：テストモードを使用してコレクションをテストするには、コードビューモードを使用する必要があります。コードビューモードはビジネスイベントではサポートされていないので、その場合は 1 つの要素を含むコレクションのみを送信できます。