사용자 지정 작업 매개 변수에 컬렉션 전달 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은 사용자 지정 작업 응답 페이로드​에서 중첩된 오브젝트 배열을 지원하지만, 이 지원은 요청 페이로드​에서 제한됩니다.

요청 페이로드에서 중첩된 배열은 사용자 지정 작업 구성에 정의된 대로 고정 수의 항목이 포함된 경우에만 지원됩니다. 예를 들어 중첩된 배열에 항상 정확히 세 개의 항목이 포함되어 있으면 상수로 구성할 수 있습니다. 항목 수가 동적이어야 하는 경우, 중첩되지 않은 배열(맨 아래 수준의 배열)만 변수로 정의할 수 있습니다.

예:

1. 다음 예제에서는 지원되지 않는 사용 사례​를 보여 줍니다.

   이 예제에서 제품 배열에는 동적 항목 수가 포함된 중첩된 배열(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" } } ] }

컬렉션 테스트: 테스트 모드를 사용하여 컬렉션을 테스트하려면 코드 보기 모드를 사용해야 합니다. 코드 보기 모드는 비즈니스 이벤트에 대해 지원되지 않으므로 이 경우 단일 요소가 포함된 컬렉션만 보낼 수 있습니다.