关于 Adobe Target Recommendations 活动的常见问题 (FAQ) 的列表。
对具有数字值的自定义属性执行目录搜索时,结果将该自定义属性视为字符串类型,而非数字值。
当前,没有可用的功能允许客户更改属性的类型。要作出改变,请提出客户问题,其中引用需要将类型从字符串变为数字的属性。
此时间范围和结果会有所不同,具体取决于这些项目的更新方式。
来源 | 详细信息 |
---|---|
通过 mbox 或 API 更新的项目属性 |
|
通过信息源更新的项目属性 |
|
通过 Target UI 或 API 从目录删除的项目 |
|
通过 mbox 或 API 添加到目录的项目 |
|
通过信息源添加到目录的项目 |
|
导入信息源文件后,或者通过 API 或 mbox 接收实体更新后,将在 60 分钟内反映以下更改:
如果某个项目之前已被排除但现在应该添加,该项目将包含在下一次算法运行(12-24 个小时)中。
出现此情形是因为 Target 会在线和离线应用排除项。如果某个项目是新排除的,会快速应用在线排除项。如果某个项目是新添加的,在线排除项会快速消失,但离线排除项一直到下一次运行算法时才会消失。
如果某个项目之前已添加但现在应该排除,则会按照上文讨论的“项目属性已更新…”时间线排除该项目,具体取决于信息源来源(通过 mbox/API 为 15 分钟,通过信息源为 12-24 个小时)。
在下一个算法运行后(12-24 小时内),才会反映以下更改:
当信息源文件的状态从“正在导入项目”变为“正在准备搜索索引更新”时,信息源文件会被视为已导入。更新可能耗时 60 分钟以上才能反映在目录搜索用户界面中;当信息源状态变为“更新已完成”时,目录搜索即为最新。即使目录搜索并非最新,您的网站也会反映上方所列时间范围内的更新。最新的“目录搜索”索引更新时间将显示在“目录搜索”页面上。
对促销设置做出的更改最多需要五个小时才能反映在网站上。
对其他标准设置做出的更改到下一次算法运行时才会反映在网站上。
用户行为汇总会纳入离线算法处理中,每个算法每隔 12-24 个小时运行一次。
在 JavaScript 中使用转义值。引号 (") 可能会破坏数组。以下代码片段是一个转义值示例:
#set($String='')
#set($escaper=$String.class.forName('org.apache.commons.lang.StringEscapeUtils'))
<script type="text/javascript">
console.log("$escaper.escapeJavaScript($entity1.name)")
console.log("$escaper.escapeJavaScript($entity2.name)")
console.log('$escaper.escapeJavaScript($entity3.name)')
names.push("$escaper.escapeJavaScript($entity4.name)")
</script>
可用的标准依据当前类别而定。在创建推荐选件时,算法选取器根据类别 ID 显示标准。
如果要应用标准的位置不包含类别 ID,则算法选择器中不会提供相应的标准。
如果使用 mbox 中存在类别 ID 的位置,则标准选取器包含所有适用的标准。
Target 具有“筛选不兼容的标准”设置以控制算法选取器的智能筛选。
此设置仅适用于在可视化体验编辑器 (VEC) 中创建的活动。此设置不适用于在基于表单的体验编辑器中创建的活动(Target 没有位置上下文)。
要访问筛选不兼容的标准设置,请依次单击推荐 > 设置:
如果筛选不兼容的标准设置未启用,则 Target 不会对算法选择器中的算法进行筛选,因而会显示所有算法。
如果筛选不兼容的标准 设置已启用,则在 VEC 活动中,Target 会从选定的位置中读取实体 ID 和类别 ID,然后根据 currentItem|currentCategory
显示算法(前提是该位置中存在相应的值)。因此,默认情况下,算法选择器中仅会显示选定位置的兼容算法。
如果“筛选不兼容的标准”设置已启用,您仍然能够查看不兼容的算法,方法是在选择标准时取消选中“兼容”复选框。
下面列出了 Target 不会显示兼容复选框的几种特殊情况:
如果您看到某个之前不为零的收藏集变为零,请考虑以下信息:
可重新保存该收藏集,然后查看它是否更新数字。通过重新保存,该收藏集重新运行所有使用该收藏集的算法。
您所查看的环境是否正确?请转到 /target/products.html#recsSettings 进行复查(如下所示)。
索引是否为最新?转到 /target/products.html#productSearch 并检查索引存在了多少个小时(例如,“3小时前编制了索引”)。 如有需要,您可以刷新索引。
您是否更改过信息源或数据层,从而导致实体不再匹配收藏集规则?请确保大小写匹配(区分大小写)。
信息源是否已成功运行?是否有人更改了 FTP 目录、密码等?
Target 会尽可能在最短的时间内生成交付更新(在客户的页面/应用程序中)。 但是,Target 还必须在 UI 中为营销人员提供某种表现方式。Target 并不推迟投放更新以等待 UI 更新变为同步。您可以使用 mboxTrace 来查看收到请求时系统中包含哪些内容。
属性权重存在两种形式:“标准属性权重”和“内容相似度属性权重”。
“标准属性权重”适用于大部分(如果不是适用于全部)标准类型(不仅仅包括内容相似度)。此类型的权重会赋予某些属性值较高的权重。在以下示例中,输出推荐中增加了耐克产品。
“内容相似度属性权重”仅适用于内容相似度标准。
此类型的权重比较动态,并且基于当前“推荐键”(当前查看的项目)。 在以下示例(品牌x 16)中,如果访客正在查看Nike运动鞋,则更有可能向该访客推荐其他Nike产品(不一定只是运动鞋)而不是竞争对手的运动鞋。 如果访客正在查看阿迪达斯运动鞋,则更有可能为该访客推荐阿迪达斯产品。
Target 有时无法显示推荐,原因在于可用推荐的数量过低。
为每个标准生成的值的数量是在设计中指定的实体数量的三倍。运行时筛选(例如库存和 mbox 属性匹配)将在生成 3 倍的值后进行应用,因此有可能在交付时最终生成的值不足 3 倍。要缓解此情况,请通过隐藏其他实体而提高设计中的实体数量。
可在设计开始时使用以下 JavaScript 来增加请求实体的数量。在此示例中,请求的实体计数将为 30 (3x10)。
#foreach($entity in $entities)
#if( $foreach.count > 10 )
#break
#end
#set ($foo = $entity.id)
#end
Target 在应用程序级别施加 50 MB 的发布限制;但是,仅在传递 application/x-www-form-urlencoded
内容类型标题时施加该限制。
您当然可以尝试在一次调用中发送 50,000 个产品。如果失败,可将其分几批发送。Adobe 建议客户将其调用分解为 5000 或 10000 件产品的批次,以降低因系统负载而导致超时的可能性。
在基于 mbox 参数创建推荐标准、促销活动或模板测试规则时,mboxParameter
不再提示您输入 mboxName
。mbox 名称现在是可选的。通过这项更改,您可以使用多个 mbox 中的参数或引用尚未记录到 Edge 的参数。
要选择所需的参数,请执行以下操作:
无论使用哪种方法,mbox 和参数之间均没有链接。标准、促销或模板测试规则依据参数在所有传递该参数的 mbox 间工作。
如果您编辑现有标准、促销活动或模板测试规则,则会显示筛选标准以及在创建期间提供的 mbox 名称。
确保受众具有唯一的名称。如果您为受众指定了与现有受众相同的名称,则无法保存旧版“推荐”活动(在 2016 年 10 月之前创建的“推荐”活动)。
对于上传信息源的 CSV 文件,其行数或文件大小没有硬性限制。但是,作为最佳实践,Adobe 建议将 CSV 文件的大小限制为最大 1 GB,以免在文件上传过程中失败。如果文件大小超过 1 GB,则最好能将其拆分为多个信息源文件。自定义属性列的最大数量为 100,自定义属性限制为 4,096 个字符。可在 Target 的“限制”页面上找到针对所需列长度的其他限制。
在查询字符串中,您可以传递要从推荐中排除的实体 ID。例如,可排除购物车中已有的商品。
要启用排除功能,请使用 excludedIds
mbox 参数。此参数指向一个以逗号分隔的实体 ID 列表。例如,mboxCreate(..., "excludedIds=1,2,3,4,5")
。该值将在请求推荐时发送。
仅对当前 Target 调用执行排除;除非再次传递 excludedIds
值,否则后续 Target 调用时不排除项目。要从每页上的推荐都排除购物车中的商品,请继续在每页上都传递 excludedIds
值。
如果排除的实体过多,则 Recommendations 所表现出的行为就像是没有足够的实体来填充推荐模板。
要排除 entityIds
,请将 &excludes=${mbox.excludedIds}
令牌追加到选件内容 URL。在提取了内容 URL 之后,所需参数将使用当前的 mbox 请求参数替代。
默认情况下,新创建的推荐将启用此功能。现有推荐必须进行保存才能支持动态排除的实体。
当所请求的算法和键组合无推荐可用时,返回 NO_CONTENT。一般而言,对该算法禁用了备份,并且以下一项或多项也属实时发生此情况:
结果尚未准备好。
一般在首次保存新创建的活动时或在对该活动中使用的收藏集、标准或促销作出配置更改之后发生此情况。
所请求的算法/键组合的结果已准备好,但尚未缓存到最近的边缘服务器上。
该请求发起缓存操作,因此在重新加载几页和/或经过几分钟后,此问题应自行解决。
结果已准备好,但所提供的键值无结果可用。
一般在算法最近运行之后为添加到目录的项目请求推荐时发生此情况,并将在算法下次运行之后自行解决。
禁用了部分模板渲染,因此没有足够多的结果可填入模板。
一般在具有动态包含规则时发生此情况,该规则积极地从可能得出的结果中筛选掉许多项目。为避免发生此情况,请启用备份并且不要将包含规则应用于备份,或者按顺序使用不那么积极筛选的标准。
当访客启动会话时,会话 ID 会绑定到一台边缘计算机,并且临时个人资料缓存会存储在这台边缘计算机上。来自同一会话的后续请求会读取此个人资料缓存,包括最近查看过的项目。
会话结束时(通常会在处于非活动状态 30 分钟后终止),会话状态(包括最近查看过的项目)会永久保存到同一地理位置边缘的更多永久个人资料存储中。
然后,来自不同设备的后续会话能够访问这些最近查看过的项目,但前提是新会话通过同一 Marketing Cloud ID (MCID)、Experience Cloud ID (ECID) 或 CustomerID/mbox3rdPartyId 关联到客户个人资料。
如果某位访客同时具有两个活动会话,那么除非强制这些设备共享会话 ID,否则一台设备上最近查看过的项目不会更新另一台设备上最近查看过的项目。这是针对此问题的可能解决方法,但Target 不会直接支持在多个设备上共享会话 ID。客户必须自己管理此 ID 共享。
如果某位访客在一个设备上处于活动状态,然后在几分钟后又在另一台设备上处于活动状态,仍然会发生此行为。第一个设备的会话不会在 30 分钟内过期,并且在将个人资料状态写入永久状态并进行处理之前,最多可能会有五分钟的延迟。测试此行为时,请等待 35 分钟以使会话过期并存储个人资料。
如果该访客并非同时具有两个活动会话,那么只要会话已结束,一台设备上最近查看过的项目就会更新另一台设备上最近查看过的项目。测试此行为时,请等待 35 分钟以使会话过期。
Recommendations Premium 不支持 Recommendations Classic 中创建的算法。您或许可以使用 Target Premium 中的旧算法;但是,在 Target Premium UI 中停用或删除活动时,该算法可能会产生同步问题。有关这两种解决方案之间的差异的更多信息,请参阅 Target Premium🔗 中的 Recommendations Classic versus Recommendations 活动。
媒体和出版行业中的一些客户希望确保推荐项目仅包含最新的文章或视频。例如,Target 客户使用了以下方法推荐存在时间少于 60 天的文章:
publish date > today's date minus 60 days
。实体属性 | 示例 |
---|---|
issueDate | 2021218 |
lastViewDate | 2021701 |
parentCategory | 注释 |
publishDate | 20210113 |
publishDateDisplay | 2021 年 1 月 13 日 |
此示例还可以使用匹配 priorDate60
值并将其作为 mbox 参数进行传递的参数来完成。
以下是对于推荐活动已知的问题: