Show Menu
主题×

实体属性

可使用实体属性,将产品或内容信息传递到 Recommendations。

可用变量

下表说明了可用的变量。

entity.id

仅支持单值。
此必填参数可识别产品。此字母数字 ID 必须在使用的所有 Adobe Experience Cloud 产品(包括 Analytics)中均相同,以便各个产品能够识别该项目并共享与其相关的数据。
entity.id 值不得包含斜杠、与号、问号、百分比符号、逗号或其他在 REST API 调用中传递时需要 URL 编码的标点字符。允许包含连字符和下划线。在 entity.id 值中包含无效标点符号会导致某些 Recommendations 功能失败。
示例: 'entity.id=67833'

entity.name

仅支持单值。
当推荐产品后,该产品名称将显示在网站上。
示例: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

支持多值(逗号分隔列表)。
当前页面的类别。可以包括多个类别,如羊毛衫是第三级标题(例如女士、女士:毛衫、女士:毛衫:羊毛衫)。多个类别可使用逗号分隔。
categoryId 限制为 250 个字符。
要按类别页面中的类别显示推荐,则只有一个 categoryId 可以被传递到用于显示该特定推荐的 mbox 中。 categoryId 的值必须与“产品详细信息”页面上传递的 entity.categoryId 的值完全匹配。
示例:
  • “产品详细信息”页面示例:womens, womens:sweaters, womens:sweaters:cardigans
  • “类别”页面示例 - Sweaters:womens:sweaters
  • “类别”页面示例 - Cardigans: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

仅支持单值。必须为整数或长整型值。
显示项目的库存水平。
示例: '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.<custom>

支持多值(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' )

使用实体属性

提供的实体属性值会在 61 天后过期。这意味着对于目录中的每个项目,应确保每月至少向 Target 推荐传递一次每个实体属性的最新值。
推荐会发送在算法中使用的 productId productPurchasedId (在代码中称为 entity.id )。
entity.id 必须与发送至订单确认页面的 productPurchasedId 以及 Adobe Analytics 产品报表中使用的 productId 相匹配。
大多数预定义的参数仅接受单个值,且新值会覆盖旧值。 categoryId 参数可以接受以逗号分隔的,表示包含该产品的每个类别的值列表。新的 categoryId 值在实体更新期间不会覆盖现有值,而是会进行附加(250 个字符限制)。
一般情况下,显示信息 mbox 可能如下例所示。更改粗体部分的详细信息,以适应您自己的产品。
所有实体参数属性都区分大小写。
<div class="mboxDefault"></div><script language="JavaScript1.2"> 
 
mboxCreate('productPage', 
 
'entity.id= 
<b>67833</b>', 
 
'entity.name= 
<b>GIANTS VS ROCKIES 5/12</b>', 
 
'entity.categoryId= 
<b>BASEBALL, GIANTS, SF BAY AREA</b>', 
 
'entity.pageUrl= 
<b>../baseball/giants-tix/giantsvrockies5.12.2000-67833</b>', 
 
'entity.venue= 
<b>AT&T PARK</b>', 
 
'entity.secondary= 
<b>ROCKIES</b>', 
 
'entity.thumbnailUrl= 
<b>../baseball/giants-tix/giants-136px.gif</b>', 
 
'entity.message= 
<b>FAMILY SPECIAL</b>', 
 
'entity.value= 
<b>15.99</b>', 
 
'entity.inventory= 
<b>1</b>' 
 
); 
 
</script>

pageUrl thumbnailUrl 首选使用相对 URL,而非绝对 URL,因为“推荐”会接收从您网站上的所有环境发送的数据。使用相对 URL 可避免硬编码链接指向临时服务器或开发服务器。
如果 mbox 在产品页面上,您可以同时包含产品 ID 和类别 ID,然后由所选择的算法决定显示哪个 ID。产品 ID 用于亲和算法,类别 ID 用于分类算法。

相关主题: