엔티티 속성

Use entity attributes to pass product or content information to Adobe Target Recommendations.

Recommendations 알고리즘에 사용되는 productId 또는 productPurchasedId (코드라고 함 entity.id )을 전송합니다.

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

일반적으로 표시 정보 mbox는 at.js 1을 사용하는 경우 다음 예와 유사할 수 있습니다.x with mboxCreate.

모든 개체 매개 변수 속성은 대소문자를 구분합니다.

<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

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

현재 페이지의 카테고리. 여기에는 카디건 하위 섹션의 하위와 같은 여러 카테고리가 포함될 수 있습니다(예 - 여성, 여성:스웨터, 여성:스웨터:카디건). 여러 카테고리는 쉼표로 구분해야 합니다.

categoryId는 250자로 제한됩니다.

예:

• 예제 제품 세부사항 페이지: 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.사용자 지정

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

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

제한 사항:

• 사용자 지정 엔티티 속성에는 사전 정의된 엔티티 속성 이름을 사용할 수 없습니다.
• entity.environment 속성은 시스템에 의해 예약되어 있으므로 사용자 지정 엔티티 속성에 사용할 수 없습니다. targetPageParams, 피드 또는 API를 사용하여 entity.environment를 전달하려고 하면 무시됩니다.

예:

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

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

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

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' )

관련 항목:

• 사용자 지정 엔티티 속성