Show Menu
화제×

다중 값 특성을 사용한 작업

다중 값 필드를 사용하여 작업하는 경우가 있습니다. 다음 예를 생각해 보십시오.
  • 사용자에게 동영상을 제공합니다. 특정 영화에는 여러 배우가 출연한다.
  • 콘서트 티켓을 팔아요 지정된 사용자는 여러 개의 즐겨찾기 밴드를 가지고 있습니다.
  • 옷을 팔아요 셔츠는 여러 크기로 제공됩니다.
이러한 시나리오에서 권장 사항을 처리하려면 다중 값 데이터를 특수 다중 값 연산자로 Target Recommendations 전달하고 사용할 수 있습니다.
다중 값 데이터를 Recommendations 식별하려면 아래 코드 샘플에서와 같이 JSON 배열로 전송해야 합니다.

JavaScript에서 다중 값 mbox 매개 변수 전달

 <!-- pass in the value of mbox parameter “favName” as JSON array -->
<script type="text/javascript">
   mboxCreate('myMbox','entity.id=<key>','favName=["a","b","c"]');
</script>

CSV 파일에 다중 값 엔티티 속성 전달

## RECSRecommendations Upload File,,,,,,,,,,,,,,,,,,,
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.,,,,,,,,,,,,,,,,,,,
## RECS,,,,,,,,,,,,,,,,,,,
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.,,,,,,,,,,,,,,,,,,,
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.,,,,,,,,,,,,,,,,,,,
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.,,,,,,,,,,,,,,,,,,,
## RECSentity.id ,entity.name,entity. categoryId ,entity. message ,entity.thumbnailUrl ,entity.value ,entity.pageUrl ,entity.inventory ,entity.margin ,entity.custom1 ,entity.custom2 ,entity.custom3 ,entity.custom4,entity.custom5,entity.custom6,entity.custom7,entity.custom8,entity.custom9,entity.custom10,
1,Sample Product 1,category1,Save 10%,http://sample.store/products/images/product1_th.jpg,325,http://sample.store/products/product_detail.jsp?productId=1,1000,48,a,"[ ""v1"", ""v2"" ]",, , , , , , , ,
2,Sample Product 2,category1,Save 10%,http://sample.store/products/images/product2_th.jpg,369,http://sample.store/products/product_detail.jsp?productId=2,1000,52,a,"[ ""v1"", ""v2"" ]",, , , , , , , ,
3,Sample Product 3,category1,Save 10%,http://sample.store/products/images/product3_th.jpg,479,http://sample.store/products/product_detail.jsp?productId=3,1000,78,a,"[ ""v1"", ""v2"" ]",,,,,,,,,
4,Sample Product 4,category1,Save 10%,http://sample.store/products/images/product4_th.jpg,409,http://sample.store/products/product_detail.jsp?productId=4,1000,66,a,"[ ""v1"", ""v2"" ]",,,,,,,,,
5,Sample Product 5,category1,Save 10%,http://sample.store/products/images/product5_th.jpg,325,http://sample.store/products/product_detail.jsp?productId=5,1000,45,a,"[ ""v1"", ""v2"" ]",,,,,,,,, 

엔티티 속성, 프로필 속성 또는 mbox 매개 변수가 위의 형식에 따라 다중 값으로 제공되면 필드가 다중 값임을 Recommendations 자동으로 알려줍니다.
다음 연산자는 다중 값 엔티티, 프로필 및 mbox 속성에 사용할 수 있습니다.
  • 목록에 포함
  • 목록에 포함되지 않음

포함 규칙에서 다중 값 속성을 사용한 작업

다중 값 속성에 대한 동적 일치 지원은 현재 기준에서만 사용할 수 있습니다. 프로필 속성 일치 또는 매개 변수(mbox) 속성 일치 규칙을 사용할 때 단일 값을 왼쪽 다중 값 오른쪽과 비교할 때 사용할 수 있습니다. 프로모션, 개체 속성 일치 및 포함 규칙 왼쪽의 목록에 대한 지원은 2020년 초에 제공됩니다.

예:최근에 본 항목 제외

사용자의 최근 10개 시청된 영화에 있는 동영상이 권장되지 않도록 한다고 가정합니다. 먼저 JSON 배열로 마지막으로 본 10개의 동영상을 추적하기 user.lastWatchedMovies 위해 호출된 프로필 스크립트를 작성하십시오. 그런 다음 다음 다음 포함 규칙을 사용하여 항목을 제외할 수 있습니다.
`Profile Attribute Matching`
`id - is not contained in list - user.lastWatchedMovies`

포함 규칙의 JSON API 표현:
{
    "attribute": "id",
    "operation": "isNotContainedInList",
    "source": {
        "name": " user.lastWatchedMovies",
        "type": "PROFILE"
    }
} 

예:사용자의 즐겨찾기에서 항목 추천

밴드 재생이 사용자가 가장 좋아하는 밴드 중 하나인 경우에만 콘서트에 티켓을 추천한다고 가정합니다. 먼저 사용자의 즐겨찾기 밴드를 포함하는 프로필 변수를 profile.favoriteBands 호출했는지 확인합니다. 그런 다음, 카탈로그에 콘서트에서 공연하는 아티스트가 entity.artistPerforming 포함된 특성이 있는지 확인하십시오. 그런 다음 다음 포함 규칙을 사용할 수 있습니다.
`Profile Attribute Matching`
`artistPerforming - is contained in list - profile.favoriteBands`

포함 규칙의 JSON API 표현:
{
    "attribute": "artistPerforming",
    "operation": "isContainedInList",
    "source": {
        "name": "profile.favoriteBands",
        "type": "PROFILE"
    }
}

예:사용자의 즐겨찾기에서 항목을 추천하는 기준 작성

모든 기준과 같은 다중 값 필터링 규칙을 사용하는 기준은 Adobe I/O API를 통해 만들 수 있습니다. 개체 속성이 mbox 매개 변수 목록에 id 포함되어 있는 기준을 만들기 위한 예제 API 호출은 favorites 다음과 같습니다.
curl -X POST \
  https://<serverhost>/api/recs/<client>/criteria/item \
  -H 'Accept: application/vnd.adobe.target.v1+json' \
  -H 'Accept-Encoding: gzip, deflate' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: <from API client>' \
  -H 'X-Target-user-email: <email address>' \
  -H 'cache-control: no-cache' \
  -d '{
    "name": "viewed criteria",
    "criteriaTitle": "test title",
    "type": "VIEWED_CF",
    "key": "CURRENT",
    "daysCount": "TWO_WEEKS",
    "aggregation": "NONE",
    "backupDisabled": false,
    "partialDesignAllowed": true,
    "configuration": {
        "inclusionRules": [
            {
                "attribute": "id",
                "operation": "isContainedInList",
                "source": {
                    "name": "mbox.favorites",
                    "type": "MBOX"
                }
            }
        ]
    }
}'

즐겨찾기 컨텐츠를 전달하기 위해 페이지의 JavaScript와 쌍을 이루게 됩니다.
<!-- pass in the value of mbox parameter “favorites” as JSON array -->
<script type="text/javascript">
   mboxCreate('myMbox','entity.id=<key>','favorites=["a","b","c"]');
</script>