Adobe Experience League

“推荐”常见问题解答

关于Adobe Target Recommendations活动的常见问题列表(FAQ)。

当我使用数值搜索自定义属性时，为什么目录搜索不显示正确的结果？

当您对具有数值的自定义属性执行目录搜索时，结果会将自定义属性视为字符串类型而不是数值。

目前，没有允许客户更改属性类型的功能。要进行更改，请打开一个客户问题，该问题引用需要类型从字符串更改为数字的属性。

我的目录中的项目更新需要多长时间才能反映在我的网站上？

时间范围和结果会因项目的更新方式而异。

来源	详细信息
通过mbox或API更新的项属性	Recommendations将在15分钟内更新。在更新可用之前，将显示现有推荐和项目属性。目录搜索在目录索引后更新（3-8小时）。
通过源更新的物料属性	Recommendations在收录后（2-8小时）进行更新。在更新可用之前，将显示现有推荐和项目属性。目录搜索在源摄取（2-8小时）和后续目录索引（3-8小时）后更新。目录搜索通常在总计5-16小时内进行更新。
通过目标 UI或API从目录中删除的项目	Recommendations将在15分钟内更新。在更新可用之前，将显示现有推荐和项目属性。目录搜索在目录索引后更新（3-8小时）。
通过mbox或API添加到目录的项目	Recommendations在算法运行后更新。算法运行计划为1-2天算法每12小时运行一次，7天以上算法每24小时运行一次。如果添加的项目不是请求的密钥，则在更新可用之前显示现有推荐。如果添加的项是请求的键，则在更新可用之前显示备份建议。目录搜索在目录索引后更新（3-8小时）。
通过源添加到目录的项目	Recommendations在摄入源后（2-8小时）进行更新。对于1-2天算法，后续算法运行每12小时计划一次，对于7天以上的算法，每24小时计划一次。 Recommendations通常在2-32小时内更新。如果添加的项目不是请求的密钥，则在更新可用之前显示现有推荐。如果添加的项是请求的键，则在更新可用之前显示备份建议。目录搜索在源摄取（2-8小时）和目录索引（3-8小时）后更新。目录搜索通常在总计5-16小时内进行更新。

在导入源文件后，或通过API或mbox接收实体更新后，以下更改将在60分钟内反映出来：

如果某个项之前被排除，但现在应该包括在内，则该项将包含在下一个算法运行中（12-24小时）。

出现这种情况是因为目标同时在线和离线应用排除。新排除某个项目时，将快速应用联机排除。当新包含某个项目时，联机排除很快消失，但脱机排除直到下一个算法运行才消失。
如果之前包括某个项目，但现在应排除该项目，则根据“已更新的项目属性……”排除该项目根据源（通过mbox/API 15分钟，或通过源12-24小时），上述时间线将有所讨论。

在下一个算法运行后（12-24 小时内），才会反映以下更改：

在用于活动的收藏集规则中使用的项目属性。
在基于与活动关联的属性或收藏集的促销活动中使用的项目属性。
项目在其中显示为“最畅销商品”或“查看次数最多”算法中的“当前类别”或“最喜爱的类别”的项目类别。
当更改的属性是用作算法自定义键的自定义属性时的推荐项目排名。
当推荐逻辑为“具有相似属性的项”时、当使用“内容相似性”加权因子时或当使用“属性加权”因子时，基于一个或多个更改的属性对推荐项进行排序。

注意

当信息源文件的状态从“正在导入项目”变为“正在准备搜索索引更新”时，信息源文件会被视为已导入。更新可能需要60分钟以上的时间才能反映在目录搜索用户界面中；Catalog Search是动态消息状态更改为“已完成更新”时的最新状态。即使目录搜索尚未更新，您的网站也会反映上述时间范围的更新。最新的“目录搜索”索引更新时间将显示在“目录搜索”页面上。

如果特殊字符破坏了数组，我应该怎么做？

在 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的位置，则条件选取器包含所有适用的条件。

目标具有“筛选器不兼容条件”设置，用于控制算法选取器的智能筛选。

注意

此设置仅适用于在可视化体验编辑器 (VEC) 中创建的活动。此设置不适用于在基于表单的体验编辑器中创建的活动（Target 没有位置上下文）。

要访问“筛选不兼容的标准”设置，请单击“推荐”>“设置”：

如果“筛选不兼容的标准”设置未启用，则 Target 不会对算法选择器中的算法进行筛选，因而会显示所有算法。

如果“筛选不兼容的标准”设置已启用，则在 VEC 活动中，Target 会从选定的位置中读取实体 ID 和类别 ID，然后根据 currentItem|currentCategory 显示算法（前提是该位置中存在相应的值）。因此，默认情况下，算法选择器中仅会显示选定位置的兼容算法。

如果“筛选不兼容的标准”设置已启用，您仍然能够查看不兼容的算法，方法是在选择标准时取消选中“兼容”复选框。

下面列出了 Target 不会显示“兼容”复选框的几种特殊情况：

位置中同时存在实体 ID 和类别 ID，在这种情况下将不进行任何筛选。
您使用的是 mbox.js 版本 55 或更低版本。
未从页面触发任何 mbox 调用 (!config.isAutoCreateGlobalMbox && !config.isRegionalMbox)
未定义 Target 参数。

如果“推荐”中的某个收藏集变为零 (0)，我应该怎么做？

如果您看到某个之前不为零的收藏集变为零，请考虑以下信息：

您可以重新保存集合并查看它是否更新了数字。通过重新保存，集合将重新运行使用该集合的所有算法。
您所查看的环境是否正确？请转到 /target/products.html#recsSettings 进行复查（如下所示）。
索引是否为最新？转到/target/products.html#productSearch并检查索引的存在时间（例如，“3小时前已索引”）。如有需要，您可以刷新索引。
您是否更改过信息源或数据层，从而导致实体不再匹配收藏集规则？请确保大小写匹配（区分大小写）。
信息源是否已成功运行？是否有人更改了FTP目录、密码等？
Target 会尽可能在最短的时间内生成交付更新（在客户的页面/应用程序中）。但是，目标还必须在UI中为营销人员提供一些表示。目标不会延迟投放更新以等待UI更新同步。您可以使用 mboxTrace 来查看收到请求时系统中包含哪些内容。

一般的属性权重与特定于内容相似度的属性权重之间有何区别？

属性权重存在两种形式：“标准属性权重”和“内容相似度属性权重”。

“标准属性权重”适用于大部分（如果不是适用于全部）标准类型（不仅仅包括内容相似度）。此类型的权重会赋予某些属性值较高的权重。在以下示例中，Nike产品在产出建议中遇到了困难。

“内容相似度属性权重”仅适用于内容相似度标准。

这是一种更为动态的权重类型，以当前的“推荐键”（当前查看的项目）为基础。在以下示例中（品牌 x 16），如果访客在查看耐克运动鞋，则很有可能向该访客推荐其他耐克产品（不一定只是运动鞋），而不是向其推荐竞争品牌的运动鞋。如果访客观看阿迪达斯的运动鞋，那访客更可能被推荐为阿迪达斯产品。

Target 为何有时无法显示推荐？

Target 有时无法显示推荐，原因在于可用推荐的数量过低。

每个标准生成的值数是设计中指定的图元数的三倍。运行时筛选（例如库存和 mbox 属性匹配）将在生成 3 倍的值后进行应用，因此有可能在交付时最终生成的值不足 3 倍。要缓解这种情况，请通过隐藏其他图元来增加设计中的图元数。

可在设计开始时使用以下 JavaScript 来增加请求实体的数量。在此示例中，请求的实体计数将为 30 (3x10)。

#foreach($entity in $entities) 
 #if( $foreach.count > 10 ) 
  #break 
 #end 
 #set ($foo = $entity.id) 
#end

用于插入/更新产品的 API 调用的大小限制是多少？我能否使用 API 而不是信息源在一次调用中更新 50,000 个产品？

目标在应用程序级别规定50-MB的员额限制；但是，仅当传递application/x-www-form-urlencoded内容类型标题时，才会出现这种情况。

您当然可以尝试在一次调用中发送 50,000 个产品。如果失败，您可以将其分批处理。 Adobe建议客户将其调用分为5,000或10,000个产品批，以降低系统负载导致超时的可能性。

在创建Recommendations标准、促销或模板测试规则时，是否必须指定mbox名称？

在基于 mbox 参数创建推荐标准、促销活动或模板测试规则时，mboxParameter 不再提示您输入 mboxName。mbox 名称现在是可选的。通过这项更改，您可以使用多个 mbox 中的参数或引用尚未记录到 Edge 的参数。

要选择所需的参数，请执行以下操作：

在创建标准、升级或模板测试规则时，从列表中选择参数名称。开始键入所需参数名称的首个字符，或键入所需参数名称的全名。
如果您记得 mbox 名称而不记得参数名称，则使用复选框筛选传递所需参数的已知 mbox。

无论使用哪种方法，mbox 和参数之间均没有链接。标准、提升或模板测试规则基于传递该参数的所有mbox中的参数工作。

如果您编辑现有标准、促销活动或模板测试规则，则会显示筛选标准以及在创建期间提供的 mbox 名称。

在定义新受众后，为什么我无法保存旧版“推荐”活动？

确保受众具有唯一的名称。如果您为受众指定了与现有受众相同的名称，则无法保存旧版“推荐”活动（在 2016 年 10 月之前创建的“推荐”活动）。

可用于信息源上传的 CSV 文件的最大大小是多少？

对于上传信息源的 CSV 文件，其行数或文件大小没有硬性限制。但是，作为最佳实践，Adobe建议将CSV文件大小限制为1 GB，以避免在文件上传过程中出现故障。如果文件大小超过1 GB，理想情况下可以将其拆分为多个源文件。自定义属性列的最大数量为 100，自定义属性限制为 4,096 个字符。“目标限制”页面中提供了对所需列长度的其他限制。

是否可以动态排除实体？

在查询字符串中，您可以传递要从推荐中排除的实体 ID。例如，您可以排除已在购物车中的项目。

要启用排除功能，请使用 excludedIds mbox 参数。此参数指向一个以逗号分隔的实体 ID 列表。例如，mboxCreate(..., "excludedIds=1,2,3,4,5")。该值将在请求推荐时发送。

仅对当前目标调用执行排除；除非再次传递excludedIds值，否则在后续目标调用中不排除项。要从每页的推荐中排除购物车中的项目，请继续在每页传递excludedIds值。

注意

如果排除的实体过多，则 Recommendations 所表现出的行为就像是没有足够的实体来填充推荐模板。

要排除entityIds，请将&excludes=${mbox.excludedIds}标记附加到优惠内容url。在提取了内容 URL 之后，所需参数将使用当前的 mbox 请求参数替代。

默认情况下，新创建的推荐将启用此功能。现有推荐必须进行保存才能支持动态排除的实体。

在Recommendations内容跟踪中有时返回的NO_CONTENT响应表示什么？

当所请求的算法和密钥组合的推荐不可用时，返回NO_CONTENT。通常情况下，当算法禁用备份且以下一项或多项也为true时，会发生这种情况：

结果尚未就绪。

这种情况通常发生在首次保存新创建的活动或对活动中使用的集合、条件或促销进行配置更改之后。
对于请求的算法/密钥组合，结果已准备就绪，但尚未在最近的边缘服务器上缓存。

请求启动缓存操作，因此在重新加载几页和/或几分钟后，此问题应会自行解决。
结果已准备就绪，但对于提供的键值不可用。

这种情况通常发生在为最近算法运行后添加到目录的项目请求建议时，并在下一个算法运行后解析自身。
部分模板渲染功能被禁用，并且没有足够的结果可用于填充模板。

这种情况通常发生在您有动态包含规则时，该规则会从可能的结果中积极过滤器许多项目。要避免出现这种情况，请启用备份，但不要将包含规则应用于备份，或按顺序使用标准，并且筛选条件不那么激进。