개체 특성을 사용하여 제품 또는 콘텐트 정보를 Adobe Target Recommendations에 전달합니다.
Recommendations 알고리즘에 사용되는 productId
또 productPurchasedId
는 코드 entity.id
에 사용되는 or(코드라고 함)을 전송합니다.
entity.id
는 주문 확인 productPurchasedId
페이지 및 Adobe Analytics 제품 보고서에 productId
사용된 것과 일치해야 합니다.
제공된 엔티티 속성값은 61일 후 만료됩니다. 이것은 각 엔티티 속성의 최신 값이 카탈로그의 각 항목에 대해 매월 최소 한 번씩 Target Recommendations에 전달되도록 해야 함을 의미합니다.
대부분의 사전 정의된 매개 변수는 단일 값만 허용하므로, 새 값이 이전 값을 덮어씁니다. categoryId
매개 변수에는 해당 제품을 포함하는 각 카테고리의 쉼표 구분 값 목록이 사용됩니다. 새 categoryId
값이 기존 값을 덮어쓰지 않지만, 대신 엔티티 업데이트(250자 제한) 중에 첨부됩니다.
일반적으로 표시 정보 mbox는 at.js 1을 사용하는 경우 다음 예와 비슷합니다.xwith mboxCreate
.
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=/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'
다중 값(쉼표로 구분된 목록)을 지원합니다.
현재 페이지의 카테고리. 여기에는 카디건 하위 섹션의 하위와 같은 여러 카테고리가 포함될 수 있습니다(예 - 여성, 여성:스웨터, 여성:스웨터:카디건). 여러 카테고리는 쉼표로 구분해야 합니다.
categoryId
는 250자로 제한됩니다.
카테고리를 기반으로 한 권장 사항을 카테고리 페이지에 표시하기 위해 한 개의 categoryId
만 특정 권장 사항을 표시하는 데 사용되는 mbox에 전달할 수 있습니다. categoryId
값은 제품 세부사항 페이지에서 전달된 entity.categoryId
값과 정확히 일치해야 합니다.
예:
카테고리 기반 권장 사항의 경우 쉼표를 사용해서 카테고리값을 구분합니다. 쉼표로 구분되는 모든 값은 카테고리가 됩니다. 콜론(:)과 같은 기타 구분 기호를 사용하여 카테고리 값 내의 하위 카테고리를 구분하도록 정의할 수도 있습니다.
예를 들어 다음 코드에서 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=brandxyz'
단일 값만 가능합니다.
항목을 구입할 수 있는 페이지의 상대 URL을 정의합니다.
예: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'
단일 값만 가능합니다.
항목과 함께 표시되는 썸네일 이미지에 대한 상대 URL을 정의합니다.
예: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'
단일 값만 가능합니다.
권장 사항에 표시되는 제품에 대한 메시지(예: "판매 중" 또는 "세일")입니다. 메시지는 일반적으로 제품 이름보다 더 자세합니다. 템플릿에 제품과 함께 표시할 추가 정보를 정의하는 데 사용합니다.
예: '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.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' )