Premium

实体属性

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

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

Recommendations 发送 productId 或 productPurchasedId (称为 entity.id （在代码中）。

请考虑以下事项：

• entity.id 必须匹配 productPurchasedId 发送至“订单确认”页面，并且 productId 使用位置 Adobe Analytics 产品报表。
• 传递到的实体属性值 Recommendations 会在61天后过期。 Adobe建议您将每个实体属性的最新值传递到 Recommendations 对于目录中的每个项目每月至少执行一次。

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

通常，如果您使用的是at.js 1，则显示信息mbox类似于以下示例。x 替换为 mboxCreate. 所有实体参数属性都区分大小写。

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

如果 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可包含多个类别，例如羊毛衫分区中的一个类别（例如，女士、女士：毛衫、女士）:sweaters:羊毛衫)。 多个类别必须以逗号分隔。

此 categoryId 值限制为250个字符。

示例：

• “产品详细信息”页面示例：womens， womens：sweaters， womens:sweaters:羊毛衫
• “类别”页面示例 - 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 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.value仅支持十进制格式（例如，15.99）。 不支持逗号格式(15,99)。

entity.margin

仅支持单值。

项目的利润率或其他价值。

示例: 'entity.margin=1.00'

entity.custom

支持多值（JSON 数组）。

最多定义 100 个自定义变量，这些变量用于提供项目的其他信息。您可为每个自定义属性指定任意一个未使用过的属性名称。例如，您可以创建一个自定义属性，其名称为 entity.genre 定义书籍或电影。 票务供应商可以为活动场地创建属性以用于辅助表演，例如体育赛事中的客队或音乐会中的开场表演。

限制：

• 您无法将预定义实体属性的名称用于自定义实体属性。
• entity.environment 属性由系统保留，该属性不能用于自定义实体属性。尝试使用targetPageParams、信息源或API来传递entity.environment的操作将被忽略。

示例：

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

自定义实体属性支持多个值。有关字符和值限制，请参阅自定义实体属性。

示例: 'entity.secondary=["band1", "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' )