PREMIUM 엔티티 속성

제품이나 컨텐츠 정보를 로 전달하려면 엔티티 속성을 사용하십시오 Adobe Target Recommendations.

엔티티는 추천할 항목을 나타냅니다. 엔티티는 제품, 콘텐츠(기사, 슬라이드쇼, 이미지, 동영상 및 TV 프로그램), 구인 및 구직 정보, 식당 등을 포함할 수 있습니다.

Recommendations 전송 productId 또는 productPurchasedId (이하 entity.id 에서)로 설정되어야 합니다.

다음 사항을 고려하십시오.

  • entity.id 와 일치해야 함 productPurchasedId 주문 확인 페이지 및 productId 에서 사용 Adobe Analytics 제품 보고서.
  • 전달하는 엔티티 속성 값 Recommendations 는 61일 후에 만료됩니다. Adobe은 각 엔티티 속성의 최신 값을 Recommendations 카탈로그의 각 항목에 대해 매월 최소 한 번 이상

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

일반적으로 디스플레이 정보 mbox는 at.js 1.x with mboxCreate. 모든 엔티티 매개 변수 속성은 대소문자를 구분합니다.

노트

at.js 2.x, mboxCreate (다음 예에서 사용됨)은 더 이상 지원되지 않습니다. 제품 또는 콘텐츠 정보를에 전달하려면 Recommendations at.js 2 사용.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>
노트

권장 사항은 사이트의 모든 환경에서 전송되는 데이터를 수신하므로 pageUrlthumbnailUrl에는 절대 URL보다 상대 URL이 선호됩니다. 상대 URL을 사용하면 스테이징 서버나 개발 서버에 대한 하드코딩된 링크가 사용되지 않습니다.

mbox가 제품 페이지에 있는 경우, 제품 ID와 카테고리 ID를 모두 포함시킬 수 있습니다. 선택한 알고리즘에 따라 표시되는 내용이 결정됩니다. 제품 ID는 친화성 알고리즘에 사용되고 카테고리 ID는 카테고리 알고리즘에 사용됩니다.

사용 가능한 변수

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

entity.id

Singe 값만 사용합니다.

이 필수 매개 변수는 제품을 식별합니다. 항목을 인식하고 그에 대한 데이터를 공유하려면 다양한 제품에 사용된 모든 Adobe Experience Cloud 제품(Analytics 포함)에서 이 영숫자 ID가 동일해야 합니다.

다음 entity.id 값은 필수입니다. not REST API 호출에 전달될 때 URL 인코딩이 필요한 슬래시, 앰퍼샌드, 물음표, 백분율 기호, 쉼표 또는 기타 구두점 문자를 포함합니다. 하이픈 및 밑줄은 허용됩니다. entity.id 값에 올바르지 않은 구두점을 포함하면 일부 Recommendations 기능에 오류가 발생합니다.

예: 'entity.id=67833'

entity.name

단일 값만 가능합니다.

제품이 권장될 때 웹 사이트에 표시되는 제품 이름

예: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

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

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

다음 categoryId 값은 250자로 제한됩니다.

노트

카테고리를 기반으로 한 권장 사항을 카테고리 페이지에 표시하기 위해 한 개의 categoryId만 특정 권장 사항을 표시하는 데 사용되는 mbox에 전달할 수 있습니다. categoryId 값은 제품 세부사항 페이지에서 전달된 entity.categoryId 값과 정확히 일치해야 합니다.

예:

  • 예제 제품 세부 정보 페이지: womens, womens:sweaters, womens:sweaters:카디건
  • 예제 카테고리 페이지 스웨터: womens:sweaters
  • 예제 카테고리 페이지 가디건: 여성:sweaters:카디건

카테고리 기반 권장 사항의 경우 쉼표는 카테고리 값을 구분합니다. 쉼표로 구분되는 모든 값은 카테고리가 됩니다. 콜론(:)과 같은 기타 구분 기호를 사용하여 카테고리 값 내의 하위 카테고리를 구분하도록 정의할 수도 있습니다.

예를 들어, 다음 코드에서는 여성 카테고리가 여러 하위 카테고리로 분류됩니다.

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

단일 값만 가능합니다.

항목의 브랜드 이름을 표시합니다.

예: '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를 사용합니다.

예: 'entity.message=Family&nbsp;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.value는 십진수 형식만 지원합니다(예: 15.99). 쉼표 형식(15,99)은 지원되지 않습니다.

entity.margin

단일 값만 가능합니다.

항목의 이윤 폭 또는 다른 가치

예: 'entity.margin=1.00'

entity.사용자 지정

다중 값(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' )

이 페이지에서는