PREMIUM 实体属性

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

实体是指您想推荐的项目。实体可以包括产品、内容(文章、幻灯片、图像、电影和电视节目)、工作列表、餐馆等。

Recommendations 发 productIdproductPurchasedId 算法中 entity.id 使用的或(在代码中称为)。

请考虑以下事项:

  • entity.id 必须与发送 productPurchasedId 到订单确认页面和产品报 productId 表中 Adobe Analytics 使用的匹配。
  • 传递给Recommendations的实体属性值将在61天后过期。 Adobe建议您每月至少为目录中的每个项目将每个实体属性的最新值传递一次至Recommendations。

大多数预定义的参数只接受一个值,新值会覆盖旧值。 categoryId 参数可以接受以逗号分隔的,表示包含该产品的每个类别的值列表。新的 categoryId 值在实体更新期间不会覆盖现有值,而是会进行附加(250 个字符限制)。

通常,如果您使用at.js 1,则显示信息mbox将像以下示例一样。** xwith mboxCreate。所有实体参数属性均区分大小写。

注意

如果您使用at.js 2。x,( 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>
注意

pageUrlthumbnailUrl 首选使用相对 URL,而非绝对 URL,因为“推荐”会接收从您网站上的所有环境发送的数据。使用相对 URL 可避免硬编码链接指向临时服务器或开发服务器。

如果 mbox 在产品页面上,您可以同时包含产品 ID 和类别 ID,然后由所选择的算法决定显示哪个 ID。产品 ID 用于亲和算法,类别 ID 用于分类算法。

可用变量

下表说明了可用的变量。

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

支持多值(逗号分隔列表)。

当前页面的类别。entity.categoryID可以包括多个类别,如羊毛衫子小节(例如,女人、女人:毛衣、女人:毛衣:羊毛衫)。 多个类别必须用逗号分隔。

categoryId值限制为250个字符。

注意

要按类别页面中的类别显示推荐,则只有一个 categoryId 可以被传递到用于显示该特定推荐的 mbox 中。categoryId 的值必须与“产品详细信息”页面上传递的 entity.categoryId 的值完全匹配。

示例:

  • “产品详细信息”页面示例:womens, womens:sweaters, womens:sweaters:cardigans
  • “类别”页面示例 - Sweaters:womens:sweaters
  • “类别”页面示例 - Cardigans:womens:sweaters:cardigans

对于基于类别的推荐,逗号分隔类别值。 以逗号分隔的任意值都会变成类别。您也可以使用不同的分隔符(例如冒号 (😃)来分隔类别值中的子类别,从而定义子类别。

例如,在以下代码中,妇女类别分为几个子类别:

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定义要在模板中与产品一起显示的其他信息。

示例: 'entity.message=Family&nbsp;special'

entity.inventory

仅支持单值。必须为整数或长整型值。

显示项目的库存水平。

示例: 'entity.inventory=1'

清空库存属性处 理:对于投放,如果包含规则、收集规则或标准设置大于0或 entity.inventory = 0且产品未设置库存,则将此值 entity.inventory 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.custom

支持多值(JSON 数组)。

最多定义 100 个自定义变量,这些变量用于提供项目的其他信息。您可为每个自定义属性指定任意一个未使用过的属性名称。例如,您可以创建名为entity.genre的自定义属性来定义书籍或影片。 票证供应商可以为辅助表演者创建事件场所的属性,例如体育事件中的访问团队或音乐会中的开幕式。

限制:

  • 您无法将预定义实体属性的名称用于自定义实体属性。
  • entity.environment 属性由系统保留,该属性不能用于自定义实体属性。忽略使用targetPageParams、feed或API传递entity.环境的尝试。

示例:

'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' )

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now