Show Menu
화제×

엔티티 속성

제품이나 컨텐츠 정보를 권장 사항에 전달하려면 엔티티 속성을 사용하십시오.

사용 가능한 변수

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

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

다중 값(쉼표로 구분된 목록)을 지원합니다.
현재 페이지의 카테고리. 여기에는 카디건 하위 섹션의 하위와 같은 여러 카테고리가 포함될 수 있습니다(예 - 여성, 여성:스웨터, 여성:스웨터:카디건). 여러 카테고리는 쉼표로 구분해야 합니다.
categoryId 는 250자로 제한됩니다.
카테고리를 기반으로 한 권장 사항을 카테고리 페이지에 표시하기 위해 한 개의 categoryId 만 특정 권장 사항을 표시하는 데 사용되는 mbox에 전달할 수 있습니다. categoryId 값은 제품 세부사항 페이지에서 전달된 entity.categoryId 값과 정확히 일치해야 합니다.
예:
  • 예제 제품 세부사항 페이지: womens, womens:sweaters, womens:sweaters:cardigans
  • 예제 카테고리 페이지 스웨터: womens:sweaters
  • 예제 카테고리 페이지 가디건: womens:sweaters:cardigans
카테고리 기반 권장 사항의 경우 쉼표를 사용해서 카테고리값을 구분합니다. 쉼표로 구분되는 모든 값은 카테고리가 됩니다. 콜론(:)과 같은 기타 구분 기호를 사용하여 카테고리 값 내의 하위 카테고리를 구분하도록 정의할 수도 있습니다.
예를 들어 다음 코드에서 Womens 카테고리는 일부 하위 카테고리로 구분됩니다.
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=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.margin

단일 값만 가능합니다.
항목의 이윤 폭 또는 다른 가치
예: 'entity.margin=1.00'

entity.<custom>

다중 값(JSON 배열)을 지원합니다.
항목에 대한 추가 정보를 제공하는 최대 100개의 사용자 지정 변수를 정의합니다. 각 사용자 지정 속성에 대해 미사용 속성 이름을 지정할 수 있습니다. 예를 들어, 책 또는 동영상을 정의하기 위해 entity.genre 라는 사용자 지정 속성을 만들 수 있습니다. 또는 티켓 공급업체는 행사 장소 또는 스포츠 경기의 원정팀이나 콘서트의 서막같이 보조 참여자에 대한 속성을 만들 수 있습니다.
제한 사항:
  • 사용자 지정 엔티티 속성에는 사전 정의된 엔티티 속성 이름을 사용할 수 없습니다.
  • entity.environment 속성은 시스템에 의해 예약되어 있으므로 사용자 지정 엔티티 속성에 사용할 수 없습니다. targetPageParams, 피드 또는 API를 사용하여 entity.environment를 전달하려고 하면 무시됩니다.
예:
'entity.venue=AT&T&nbsp;Park'
'entity.secondary=Rockies'
사용자 지정 엔티티 속성은 다중 값을 지원합니다. 문자 및 값 제한에 대해서는 사용자 지정 엔티티 속성 을 참조하십시오.
예: 'entity.secondary=["band1",&nbsp;"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' )

엔티티 속성 사용

제공된 엔티티 속성값은 61일 후 만료됩니다. 이것은 각 엔티티 속성의 최신 값이 카탈로그의 각 항목에 대해 매월 최소 한 번씩 Target Recommendations에 전달되도록 해야 함을 의미합니다.
권장 사항은 알고리즘에 사용되는 productId 또는 productPurchasedId (코드에서 entity.id 라고 함)를 전송합니다.
entity.id 는 주문 확인 페이지에 전송된 productPurchasedId 및 Adobe Analytics 제품 보고서에 사용된 productId 와 일치해야 합니다.
대부분의 사전 정의된 매개 변수는 단일 값만 허용하므로, 새 값이 이전 값을 덮어씁니다. categoryId 매개 변수에는 해당 제품을 포함하는 각 카테고리의 쉼표 구분 값 목록이 사용됩니다. 새 categoryId 값이 기존 값을 덮어쓰지 않지만, 대신 엔티티 업데이트(250자 제한) 중에 첨부됩니다.
일반적으로 표시 정보 mbox는 at.js 1을 사용하는 경우 다음 예와 유사할 수 있습니다. x with mboxCreate .
at.js 2를 사용하는 경우​ x , mboxCreate (다음 예에서 사용됨)는 더 이상 지원되지 않습니다. at.js 2를 사용하여 제품 또는 컨텐츠 정보를 Recommendations에 전달하려면​ x , targetPageParams를 사용하십시오 . 예를 들어 Recommendations 을 계획 및 구현하십시오 .
모든 개체 매개 변수 속성은 대소문자를 구분합니다.
<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=../baseball/giants-tix/giantsvrockies5.12.2000-67833', 
 
'entity.venue=AT&T PARK', 
 
'entity.secondary=ROCKIES', 
 
'entity.thumbnailUrl=../baseball/giants-tix/giants-136px.gif', 
 
'entity.message=FAMILY SPECIAL', 
 
'entity.value=15.99', 
 
'entity.inventory=1' 
 
); 
 
</script>

권장 사항은 사이트의 모든 환경에서 전송되는 데이터를 수신하므로 pageUrl thumbnailUrl 에는 절대 URL보다 상대 URL이 선호됩니다. 상대 URL을 사용하면 스테이징 서버나 개발 서버에 대한 하드코딩된 링크가 사용되지 않습니다.
mbox가 제품 페이지에 있는 경우, 제품 ID와 카테고리 ID를 모두 포함시킬 수 있습니다. 선택한 알고리즘에 따라 표시되는 내용이 결정됩니다. 제품 ID는 친화성 알고리즘에 사용되고 카테고리 ID는 카테고리 알고리즘에 사용됩니다.