[Premium]{class="badge positive" title="Target Premium에 포함된 내용을 확인합니다."}

엔티티 속성

엔터티 특성을 사용하여 제품 또는 콘텐츠 정보를 Adobe Target Recommendations에 전달합니다.

엔티티는 추천할 항목을 나타냅니다. 엔티티에는 제품, 콘텐츠(문서, 슬라이드쇼, 이미지, 동영상 및 TV 프로그램), 구인 및 구직 정보, 식당 등이 포함될 수 있습니다.

Recommendations이(가) 알고리즘에 사용되는 productId 또는 productPurchasedId(코드에서는 entity.id이라고 함)을(를) 보냅니다.

다음 사항을 고려하십시오.

대부분의 사전 정의된 매개 변수는 단일 값만 허용하며 새 값이 이전 값을 덮어씁니다. categoryId 매개 변수에는 해당 제품을 포함하는 각 카테고리의 쉼표 구분 값 목록이 사용됩니다. 새 categoryId 값이 기존 값을 덮어쓰지 않지만, 대신 엔티티 업데이트(250자 제한) 중에 첨부됩니다.

일반적으로 mboxCreate에서 at.js 1.x​을(를) 사용하는 경우 표시 정보 mbox는 다음 예제와 비슷합니다. 모든 엔티티 매개 변수 속성은 대소문자를 구분합니다.

<div class="mboxDefault"></div><script language="JavaScript1.2">

mboxCreate('productPage',

'entity.id=67833',

'entity.name=GIANTS VS ROCKIES 5/12',

'entity.categoryId=BASEBALL, GIANTS, SF BAY AREA',

'entity.pageUrl=/help/baseball/giants-tix/giantsvrockies5.12.2000-67833',

'entity.venue=AT&T PARK',

'entity.secondary=ROCKIES',

'entity.thumbnailUrl=/help/baseball/giants-tix/giants-136px.gif',

'entity.message=FAMILY SPECIAL',

'entity.value=15.99',

'entity.inventory=1'

);

</script>

mbox가 제품 페이지에 있는 경우 제품 ID와 카테고리 ID를 모두 포함할 수 있습니다. 선택한 알고리즘이 표시할 항목을 결정합니다. 제품 ID는 친화성 알고리즘에 사용되고 카테고리 ID는 카테고리 알고리즘에 사용됩니다.

사용 가능한 변수

다음 목록에서는 사용 가능한 변수를 설명합니다.

entity.id

Singe 값만 사용합니다.

이 필수 매개 변수는 제품을 식별합니다. 항목을 인식하고 그에 대한 데이터를 공유하려면 다양한 제품에 사용된 모든 Adobe Experience Cloud 제품(Analytics 포함)에서 이 영숫자 ID가 동일해야 합니다.

entity.id 값은 REST API 호출에 전달될 때 URL 인코딩이 필요한 공백, 슬래시, 앰퍼샌드, 물음표, 백분율 기호, 쉼표 또는 기타 구두점 문자를 포함하지 않아야​합니다. 하이픈 및 밑줄을 사용할 수 있습니다. entity.id 값에 올바르지 않은 구두점을 포함하면 일부 Recommendations 기능에 오류가 발생합니다.

예: 'entity.id=67833'

entity.name

단일 값만 가능합니다.

제품이 권장될 때 웹 사이트에 표시되는 제품 이름

예: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

다중 값(쉼표로 구분된 목록)을 지원합니다.

현재 페이지의 카테고리. entity.categoryID에는 카디건 하위 섹션(예: womens, womens:sweaters, womens:sweaters:cardigans)과 같은 여러 범주가 포함될 수 있습니다. 여러 카테고리는 쉼표로 구분해야 합니다.

categoryId 값은 250자로 제한됩니다.

예:

카테고리 기반 권장 사항의 경우 쉼표로 카테고리 값을 구분합니다. 쉼표로 구분되는 모든 값은 카테고리가 됩니다. 콜론(:)과 같은 기타 구분 기호를 사용하여 카테고리 값 내의 하위 카테고리를 구분하도록 정의할 수도 있습니다.

예를 들어 다음 코드에서 여성의 카테고리는 여러 하위 카테고리로 나뉩니다.

mboxCreate('mboxName', 'entity.id=343942-32', 'entity.categoryId= Womens, Womens:Outerwear, Womens:Outerwear:Jackets, Womens:Outerwear:Jackets:Parka, Womens:Outerwear:Jackets:Caban', 'entity.thumbnailUrl=...', 'entity.message=...', );

mbox 배달의 경우 키에 가장 긴 속성 이름이 사용됩니다. 연결이 있는 경우 마지막 속성이 사용됩니다. 위의 예에서 범주 키는 Womens:Outerwear:Jackets:Caban입니다.

entity.brand

단일 값만 가능합니다.

항목의 브랜드 이름을 표시합니다.

예: 'entity.brand=brandxyz'

entity.pageUrl

단일 값만 가능합니다.

항목을 구입할 수 있는 페이지의 상대 URL을 정의합니다.

예: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'

entity.thumbnailUrl

단일 값만 가능합니다.

항목과 함께 표시되는 썸네일 이미지에 대한 상대 URL을 정의합니다.

예: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'

entity.message

단일 값만 가능합니다.

권장 사항에 표시되는 제품에 대한 메시지(예: “판매 중” 또는 “세일”)입니다. 메시지는 일반적으로 제품 이름보다 더 자세합니다. 템플릿에 제품과 함께 표시할 추가 정보를 정의하려면 entity.message를 사용합니다.

예: 'entity.message=Family special'

entity.inventory

단일 값만 가능합니다. 정수 또는 long 값이 필요합니다.

항목의 재고 수준을 표시합니다.

예: 'entity.inventory=1'

빈 재고 특성 처리: 배달을 위해 포함 규칙, 컬렉션 규칙 또는 기준 설정이 entity.inventory > 0 또는 entity.inventory = 0이고 제품에 재고가 설정되어 있지 않은 경우 Target에서 이 값을 TRUE로 평가하고 재고가 설정되지 않은 제품을 포함합니다. 따라서 재고가 설정되지 않은 제품은 추천 결과에 표시됩니다.

마찬가지로, 글로벌 제외 규칙이 entity.inventory = 0으로 설정되어 있고 entity.inventory가 설정되지 않은 경우 Target은 이 규칙을 TRUE로 평가하고 제품을 제외합니다.

알려진 문제: 제품 검색이 설정되지 않은 재고 값 특성에 대한 게재와 일치하지 않습니다. 예를 들어, entity.inventory = 0인 규칙의 경우, 제품 검색 결과에 재고 값이 설정되지 않은 제품이 표시되지 않습니다.

entity.value

단일 값만 가능합니다.

항목의 가격 또는 값을 정의합니다.

예: 'entity.value=15.99'

entity.value는 십진수 형식만 지원합니다(예: 15.99). 쉼표 형식(15,99)은 지원되지 않습니다.

entity.margin

단일 값만 가능합니다.

항목의 이윤 폭 또는 다른 가치

예: 'entity.margin=1.00'

entity.사용자 지정

다중 값(JSON 배열)을 지원합니다.

항목에 대한 추가 정보를 제공하는 최대 100개의 사용자 지정 변수를 정의합니다. 각 사용자 지정 속성에 대해 미사용 속성 이름을 지정할 수 있습니다. 예를들어, entity.genre(이)라는 사용자 지정 특성을 만들어 책 또는 동영상을 정의할 수 있습니다. 티켓 공급업체는 스포츠 경기의 원정 팀이나 콘서트의 서막 같이, 보조 참여자를 위한 이벤트 장소에 대한 속성을 만들 수 있습니다.

제한 사항:

예:

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

사용자 지정 엔티티 속성은 다중 값을 지원합니다. 문자 및 값 제한에 대해서는 사용자 지정 엔티티 속성을 참조하십시오.

예: 'entity.secondary=["band1", "band2"]'

다중 값 사용자 지정 엔티티 속성에는 유효한 JSON 배열이 필요합니다. 올바른 구문 정보는 사용자 지정 엔터티 특성을 참조하십시오.

entity.event.detailsOnly

단일 값만 가능합니다.

mbox 호출이 알고리즘에 대한 행동 데이터 카운터를 증분하지 못하게 하는 데 사용됩니다.

예: 'entity.event.detailsOnly=true'

아래 예에서 첫 번째 mbox 호출은 카탈로그 및 동작 데이터를 업데이트합니다. 두 번째 mbox 호출은 카탈로그만 업데이트합니다.

mboxCreate('myMbox', 'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 'entity.inventory = 4' )
mboxCreate('myMbox',  'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 123', 'entity.inventory = 4' 'entity.event.detailsOnly=true' )