엔티티 속성을 사용하여 제품 또는 컨텐츠 정보를 로 전달 Adobe Target Recommendations.
엔티티는 추천할 항목을 나타냅니다. 엔티티에는 제품, 콘텐츠(문서, 슬라이드쇼, 이미지, 동영상 및 TV 프로그램), 구인 및 구직 정보, 식당 등이 포함될 수 있습니다.
Recommendations 다음 전송 productId
또는 productPurchasedId
(이하 entity.id
(코드에서) 라고도 함)으로 식별됩니다.
다음 사항을 고려하십시오.
entity.id
은(는) 과(와) 일치해야 합니다. productPurchasedId
주문 확인 페이지 및 로 전송됩니다. productId
다음에서 사용됨 Adobe Analytics 제품 보고서입니다.대부분의 사전 정의된 매개 변수는 단일 값만 허용하며 새 값이 이전 값을 덮어씁니다. categoryId
매개 변수에는 해당 제품을 포함하는 각 카테고리의 쉼표 구분 값 목록이 사용됩니다. 새 categoryId
값이 기존 값을 덮어쓰지 않지만, 대신 엔티티 업데이트(250자 제한) 중에 첨부됩니다.
일반적으로 at.js 1을 사용하는 경우 표시 정보 mbox는 다음 예와 비슷합니다.x 포함 mboxCreate
. 모든 엔티티 매개 변수 속성은 대소문자를 구분합니다.
at.js 2를 사용 중인 경우 입니다.x, mboxCreate
(다음 예에서 사용됨)은 더 이상 지원되지 않습니다. 제품 또는 콘텐츠 정보를 로 전달하려면 Recommendations at.js 2 사용x, 사용 targetPageParams. For an example, see Plan and implement 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=/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>
권장 사항은 사이트의 모든 환경에서 전송되는 데이터를 수신하므로 pageUrl
및 thumbnailUrl
에는 절대 URL보다 상대 URL이 선호됩니다. 상대 URL을 사용하면 스테이징 서버나 개발 서버에 대한 하드코딩된 링크가 사용되지 않습니다.
mbox가 제품 페이지에 있는 경우, 제품 ID와 카테고리 ID를 모두 포함시킬 수 있습니다. 선택한 알고리즘에 따라 표시되는 내용이 결정됩니다. 제품 ID는 친화성 알고리즘에 사용되고 카테고리 ID는 카테고리 알고리즘에 사용됩니다.
다음 목록에서는 사용 가능한 변수를 설명합니다.
Singe 값만 사용합니다.
이 필수 매개 변수는 제품을 식별합니다. 항목을 인식하고 그에 대한 데이터를 공유하려면 다양한 제품에 사용된 모든 Adobe Experience Cloud 제품(Analytics 포함)에서 이 영숫자 ID가 동일해야 합니다.
다음 entity.id
값은 다음과 같아야 합니다. 아님 공백, 슬래시, 앰퍼샌드, 물음표, 백분율 기호, 쉼표 또는 REST API 호출에 전달될 때 URL 인코딩이 필요한 기타 구두점 문자를 포함합니다. 하이픈 및 밑줄을 사용할 수 있습니다. entity.id
값에 올바르지 않은 구두점을 포함하면 일부 Recommendations 기능에 오류가 발생합니다.
예: 'entity.id=67833'
단일 값만 가능합니다.
제품이 권장될 때 웹 사이트에 표시되는 제품 이름
예: 'entity.name=Giants& vs& Rockies& 5/12'
다중 값(쉼표로 구분된 목록)을 지원합니다.
현재 페이지의 카테고리. entity.categoryID에는 카디건 하위 섹션과 같은 여러 카테고리가 포함될 수 있습니다(예: womens, womens:sweaters, womens:sweaters:카디건). 여러 카테고리는 쉼표로 구분해야 합니다.
다음 categoryId
값은 250자로 제한됩니다.
카테고리를 기반으로 한 권장 사항을 카테고리 페이지에 표시하기 위해 한 개의 categoryId
만 특정 권장 사항을 표시하는 데 사용되는 mbox에 전달할 수 있습니다. categoryId
값은 제품 세부사항 페이지에서 전달된 entity.categoryId
값과 정확히 일치해야 합니다.
예:
카테고리 기반 권장 사항의 경우 쉼표로 카테고리 값을 구분합니다. 쉼표로 구분되는 모든 값은 카테고리가 됩니다. 콜론(:)과 같은 기타 구분 기호를 사용하여 카테고리 값 내의 하위 카테고리를 구분하도록 정의할 수도 있습니다.
예를 들어 다음 코드에서 여성의 카테고리는 여러 하위 카테고리로 나뉩니다.
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 배달의 경우 키에 가장 긴 속성 이름이 사용됩니다. 연결이 있는 경우 마지막 속성이 사용됩니다. 위의 예에서 카테고리 키는 여성입니다.:Outerwear:자켓:카반.
단일 값만 가능합니다.
항목의 브랜드 이름을 표시합니다.
예: 'entity.brand=brandxyz'
단일 값만 가능합니다.
항목을 구입할 수 있는 페이지의 상대 URL을 정의합니다.
예: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'
단일 값만 가능합니다.
항목과 함께 표시되는 썸네일 이미지에 대한 상대 URL을 정의합니다.
예: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'
단일 값만 가능합니다.
권장 사항에 표시되는 제품에 대한 메시지(예: "판매 중" 또는 "세일")입니다. 메시지는 일반적으로 제품 이름보다 더 자세합니다. 템플릿에 제품과 함께 표시할 추가 정보를 정의하려면 entity.message를 사용합니다.
예: 'entity.message=Family special'
단일 값만 가능합니다. 정수 또는 long 값이 필요합니다.
항목의 재고 수준을 표시합니다.
예: 'entity.inventory=1'
빈 재고 속성 처리: 게재의 경우 포함 규칙, 컬렉션 규칙 또는 이 포함된 기준 설정이 있는 경우 entity.inventory
> 0 또는 entity.inventory
= 0이고 제품에 재고가 설정되지 않았습니다. Target 이 값을 TRUE로 평가하고 재고가 설정되지 않은 제품을 포함합니다. 따라서 재고가 설정되지 않은 제품은 추천 결과에 표시됩니다.
마찬가지로, 글로벌 제외 규칙이 entity.inventory
= 0으로 설정되어 있고 entity.inventory
가 설정되지 않은 경우 Target은 이 규칙을 TRUE로 평가하고 제품을 제외합니다.
알려진 문제: 설정되지 않은 재고 값 속성에 대한 제품 검색이 전달과 일치하지 않습니다. 예를 들어 이 포함된 규칙의 경우 entity.inventory
= 0 인 경우, 제품 검색 결과에 재고 값이 설정되지 않은 제품이 표시되지 않습니다.
단일 값만 가능합니다.
항목의 가격 또는 값을 정의합니다.
예: 'entity.value=15.99'
entity.value는 십진수 형식만 지원합니다(예: 15.99). 쉼표 형식(15,99)은 지원되지 않습니다.
단일 값만 가능합니다.
항목의 이윤 폭 또는 다른 가치
예: 'entity.margin=1.00'
다중 값(JSON 배열)을 지원합니다.
항목에 대한 추가 정보를 제공하는 최대 100개의 사용자 지정 변수를 정의합니다. 각 사용자 지정 속성에 대해 미사용 속성 이름을 지정할 수 있습니다. 예를 들어 이라는 사용자 지정 속성을 만들 수 있습니다. entity.genre
책 또는 동영상을 정의합니다. 티켓 공급업체는 스포츠 경기의 원정 팀이나 콘서트의 서막 같이, 보조 참여자를 위한 이벤트 장소에 대한 속성을 만들 수 있습니다.
제한 사항:
예:
'entity.venue=AT&T Park'
'entity.secondary=Rockies'
사용자 지정 엔티티 속성은 다중 값을 지원합니다. 문자 및 값 제한에 대해서는 사용자 지정 엔티티 속성을 참조하십시오.
예: 'entity.secondary=["band1", "band2"]'
다중 값 사용자 지정 엔티티 속성에는 유효한 JSON 배열이 필요합니다. 올바른 구문 정보는 사용자 지정 엔티티 속성.
단일 값만 가능합니다.
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' )