可使用实体属性,将产品或内容信息传递到 Adobe Target Recommendations.
实体是指您想推荐的项目。实体可包括产品、内容(文章、幻灯片、图像、电影和电视节目)、工作列表、餐厅等。
Recommendations 发送 productId
或 productPurchasedId
(称为 entity.id
(在代码中)。
请考虑以下事项:
entity.id
必须匹配 productPurchasedId
发送至“订单确认”页面,并且 productId
使用位置 Adobe Analytics 产品报表。大多数预定义参数仅接受单个值,并且新值会覆盖旧值。 categoryId
参数可以接受以逗号分隔的,表示包含该产品的每个类别的值列表。新的 categoryId
值在实体更新期间不会覆盖现有值,而是会进行附加(250 个字符限制)。
通常,如果您使用的是at.js 1,则显示信息mbox类似于以下示例。x 替换为 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 用于亲和算法,类别 ID 用于分类算法。
下表说明了可用的变量。
仅支持单值。
此必填参数可识别产品。此字母数字 ID 必须在使用的所有 Adobe Experience Cloud 产品(包括 Analytics)中均相同,以便各个产品能够识别该项目并共享与其相关的数据。
此 entity.id
值必须 非 包含空格、斜杠、&符号、问号、百分比符号、逗号或其他在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'
仅支持单值。必须为整数或长整型值。
显示项目的库存水平。
示例: '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' )