제품이나 컨텐츠 정보를 로 전달하려면 엔티티 속성을 사용하십시오 Adobe Target Recommendations.
엔티티는 추천할 항목을 나타냅니다. 엔티티는 제품, 콘텐츠(기사, 슬라이드쇼, 이미지, 동영상 및 TV 프로그램), 구인 및 구직 정보, 식당 등을 포함할 수 있습니다.
Recommendations 전송 productId
또는 productPurchasedId
(이하 entity.id
에서)로 설정되어야 합니다.
다음 사항을 고려하십시오.
entity.id
와 일치해야 함 productPurchasedId
주문 확인 페이지 및 productId
에서 사용 Adobe Analytics 제품 보고서.대부분의 사전 정의된 매개 변수는 단일 값만 허용하므로, 새 값이 이전 값을 덮어씁니다. categoryId
매개 변수에는 해당 제품을 포함하는 각 카테고리의 쉼표 구분 값 목록이 사용됩니다. 새 categoryId
값이 기존 값을 덮어쓰지 않지만, 대신 엔티티 업데이트(250자 제한) 중에 첨부됩니다.
일반적으로 디스플레이 정보 mbox는 at.js 1.x with 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
값은 필수입니다. not REST API 호출에 전달될 때 URL 인코딩이 필요한 슬래시, 앰퍼샌드, 물음표, 백분율 기호, 쉼표 또는 기타 구두점 문자를 포함합니다. 하이픈 및 밑줄은 허용됩니다. entity.id
값에 올바르지 않은 구두점을 포함하면 일부 Recommendations 기능에 오류가 발생합니다.
예: 'entity.id=67833'
단일 값만 가능합니다.
제품이 권장될 때 웹 사이트에 표시되는 제품 이름
예: 'entity.name=Giants& vs& Rockies& 5/12'
다중 값(쉼표로 구분된 목록)을 지원합니다.
현재 페이지의 카테고리. entity.categoryID는 카디건 하위 섹션의 하위와 같은 여러 카테고리를 포함할 수 있습니다(예: 여성, 여성:스웨터, 여성):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 배달의 경우 키에 가장 긴 속성 이름이 사용됩니다. 연결이 있는 경우 마지막 속성이 사용됩니다. 위의 예에서 카테고리 키는 Womens입니다: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' )