文档中心

Viking AI 搜索

推荐召回配置

新物品冷启动召回

功能概述

物品冷启动主要解决将新物品推荐给可能感兴趣的用户的问题。新上架的物品由于缺乏用户互动历史（如点击、购买、浏览），因此推荐模型无法有效召回这些物品，导致：

新物品无法进入常规召回通道

推荐内容的新鲜度降低

物品流转速度减缓，影响业务增长

开启冷启动新物品召回后，平台会为新物品提供独立的召回通道，保障其获得基础曝光量，积累用户行为数据，快速转化为成熟物品。

核心能力

冷启动新物品召回在推荐场景的核心能力为：

新物品池定义：根据您配置的规则（如导入时间、物品字段）确定哪些物品属于"新物品"。

独立召回通道：满足条件的新物品通过专属召回通道进行召回，无需依赖历史行为数据。

跳过精排：冷启动物品跳过精排阶段，直接在重排阶段融合，避免因缺乏互动信号导致精排分数被压低。

自动退出：当新物品的累计曝光数超过设定阈值后，自动退出新物品池，进入常规召回通道。

使用场景

内容平台

对于每天有大量新内容产生的平台（如短视频推荐、内容社区推荐），冷启动功能确保新创作者的内容能够获得初始曝光，避免只有已有高曝光的内容才能继续获得推荐。

电商平台

对于频繁上架新商品的电商平台，冷启动功能帮助新商品获得初始流量，支持健康的商品周转和商家入驻体验。

时效性内容

对于新闻资讯、直播推荐等对时效性要求高的场景，冷启动确保最新内容能够及时被推荐给用户。

本文将引导您完成物品冷启动功能的配置步骤。

前提条件

配置冷启动新物品召回前，请确保：

已关联至少一个物品数据集

已创建推荐场景

已接入行为数据（建议实时增量导入行为数据）

配置说明

步骤 1：开启物品冷启动

在控制台中进入目标应用。

选择目标推荐场景。

在左侧面板的召回区域，找到冷启动新物品召回。

将开关设为开启状态。

步骤 2：配置新物品范围

配置哪些物品符合新物品池的准入条件。

点击「筛选新物品范围」旁的编辑按钮。

选择新物品范围条件，并配置对应的条件。支持两种定义方式。

方式一：根据物品导入时间

根据物品首次导入物品数据集的时间来定义新物品

参数	说明	默认值	最小值	最大值（建议）
导入时间窗口	导入时间在该时间窗口内的物品视为新物品	24 小时	1 小时	168 小时

方式二：根据物品数据字段

根据物品数据集中的字段条件自定义筛选新物品。

说明

只有在物品数据集 Schema 中标记为「用于过滤字段」的字段才能用作筛选条件。

参数	说明
字段	从物品数据集中选择一个字段。这里只支持配置已经标记为「用于过滤」的物品字段。
算子	配置对比算子。支持的算子，请见支持的运算符。
值	匹配条件的具体值

步骤 3：配置曝光与数量上限

当平台有满足新物品定义的可推荐物品时，平台会根据用户喜好和画像，优先推荐新物品。您可以通过此配置控制每次返回中新物品的数量和新物品的退出条件

在冷启动新物品召回卡片中，您可以找到并配置以下参数：

参数	默认值	取值范围	说明
新物品曝光次数上限	100	1 - 1000	当新物品的累计曝光次数达到该值后，物品将自动退出新物品池，进入常规推荐通道。说明平台只会统计物品历史 7 天的曝光数据。
新物品推荐数量上限	1	1 - 场景的总返回数量上限	控制单次推荐响应中可包含的冷启动物品数量上限。该值不能超过场景的总返回数量上限。

步骤 4： API 参数（可选）

调用推荐 API 时，可通过参数动态覆盖每次请求的新物品数量上限。了解更多接口详情，请见Recommend - 个性化推荐。

参数	类型	说明
new_items_size	Integer	本次请求中返回的新物品数量上限。配置覆盖控制台配置。

最佳实践

场景	推荐配置
高频内容平台（短视频、社交内容、社区）	新物品定义：导入时间在 24 小时内新物品曝光上限：100-500 新物品数量上限：1-3
电商（频繁上新）	新物品定义：导入时间在 48 小时内新物品曝光上限：200-1000 新物品数量上限：1-2
新闻/实时内容	新物品定义：导入时间在 12 小时内新物品曝光上限：50-100 新物品数量上限：2-5

常见问题

Q：关闭冷启动新物品召回后会有什么影响？

A：新物品将仅能通过依赖历史互动数据的常规召回通道被发现（如协同过滤、热门召回）。零互动的物品可能不会出现在推荐结果中。

Q：开启后可以修改新物品定义吗？

A：可以。您可以随时修改筛选条件，更改在下一次推荐请求时生效。

Q：曝光上限在多个场景中如何计算？

A：曝光上限为全局计数，跨所有场景。一旦物品在任一场景中达到上限，将在所有场景中退出新物品池。

Q：新物品推荐数量上限是否保证每次返回那么多新物品？

A：不保证，该值为上限，实际返回数量可能更少。这里可能会有几个原因：

满足条件且匹配用户偏好的新物品数量不足

因提、降权规则或打散规则影响，新物品推荐位置降低

最近更新时间：2026.06.25 19:00:23

这个页面对您有帮助吗？

有用

无用