文档中心

Viking AI 搜索

推荐原因

单物品推荐原因

能力介绍

个性化推荐结果对终端用户来说常常像一个"黑盒"：看到"猜你喜欢"却不知道为什么是这件商品，不感兴趣时直接划走，运营也很难在不做大范围 A/B 实验的前提下知道"某条推荐为什么被推、为什么没被点"。

推荐原因功能允许您按"召回通道"为每一路推荐结果配置一段不超过 20 字的短文案模板（例如"与您最近浏览的 XX 相似""近期热门 Top 3"），并随推荐接口同步返回。终端用户可以直接看懂"为什么推荐这件商品"，运营团队也可以用可视化配置代替埋点做 A/B，实现精细化调优。本文介绍推荐原因的能力边界、配置步骤，以及接口返回格式。

适用范围

推荐原因基于已创建的推荐场景配置。开始前请确认：

已完成前置配置

了解场景当前使用的召回通道

名词解释

术语	说明	举例
召回通道	推荐系统在候选池中筛出物品所走的路径	高热召回、多模态召回、相似用户兴趣召回、用户画像召回、父商品召回、物品冷启动
变量参数	插入到推荐原因模板中的占位符，发起请求时由系统自动替换为具体值	{{rank}}、{{category}}、{{item}}
兜底文案	当某条推荐没有命中任何已配置模板，或对应模板为空时使用的通用文案	"为你推荐"

界面配置

系统会根据推荐场景所使用的召回通道，自动列出可配置的推荐原因项：

首页推荐：高热召回、多模态召回、相似用户兴趣召回、用户画像召回、物品冷启动

详情页推荐 / 购物车推荐：父商品召回、高热召回、多模态召回、相似用户兴趣召回、用户画像召回、物品冷启动

场景类型	生效状态
新建场景	默认启用全部适用的召回通道，并使用系统内置的多语言模板中/英/日/韩/印地语等，跟随应用语言自动切换
历史场景	不会自动生效，需要手动开启

召回通道

召回通道	recall_channel 参数	默认模板（中文）	可用变量
多模态召回	multimodal	和你互动过的物品相似	—
用户画像召回	user_profile	符合你对「{{category}}」的兴趣	category
相似用户兴趣召回	item_cf	与「{{item}}」有相似受众	item
高热召回	hot_item	近期热门 Top {{rank}}	rank
高热召回	hot_item_fallback	近期热门商品	—
父商品召回	item_similarity	与「{{item}}」类似	item
物品冷启动	cold_start	最近上线的物品	—
—	（兜底）	为你推荐	—

配置步骤

进入控制台体验配置 > 推荐体验，选择目标推荐场景，进入「推荐话术」页签。

在左侧「推荐原因」分组下，展开单个物品推荐原因，点击添加原因。

弹窗会列出当前场景支持的召回通道，每个召回通道右侧带独立开关：

默认全部开启，文本框内为系统预置模板文案。

如需恢复为默认文案，点击文本框下方的使用模板。

如需自定义文案，直接在文本框中编辑（建议不超过 20 字，突出差异化卖点）。

点击文本框右上角变量参数下的对应按钮插入变量，支持在同一模板中插入多个变量

+ {{rank}}：自动获取推荐物品的热度排序

+{{category}}：自动获取推荐物品的类型

+ {{item}}：插入后点击该变量，从下拉列表中选择要引用的具体物品字段（如 title、genre 等），最终以 item.{字段名} 的形式生效

说明

不支持选择 array<object> 类型字段及其内部字段。Array 类型字段的值会以逗号分隔展示。

如某个召回通道不需要展示原因，直接关闭其右侧开关。关闭后接口不会返回该通道对应的 rec_info 条目。若模板留空但开关仍开启，接口会返回该通道的 rec_info，但 reason 为空字符串。

编辑完成后点击确认，配置先在控制台生效，可在中部预览区测试效果。

确认无误后，点击页面右上角更新配置，将改动发布到线上，正式对 API 请求生效。

说明

每个召回通道的模板相互独立，同一物品若被多个召回通道同时召回，会在 rec_info 中返回多条召回通道（recall_channel）和推荐原因（recall_reason）

接口对接

接口返回

启用推荐原因后，Recommend - 个性化推荐接口的返回结果中会新增 rec_info 字段，随每个推荐物品一并返回，无需额外调用接口，也不影响接口延迟。

参数	类型	含义
rec_info	Array<Object>	推荐原因列表
rec_info.recall_channel	string	命中的召回通道
rec_info.reason	string	对应召回通道生成的推荐原因文案

返回示例

说明

更多接口字段说明，请参阅 Recommend - 个性化推荐

计费与性能

该能力不额外计费。

对推荐接口延迟没有显著影响。

常见问题

Q：为什么某条推荐没有返回 rec_info，或 reason 是空字符串？

A：请检查 —— 该召回通道的开关是否已关闭（关闭则不返回该条目）；对应模板是否为空（为空则返回空字符串）；该场景是否为历史场景且尚未手动开启推荐原因能力。

Q：修改模板后多久生效？

A：控制台内的编辑会立即在预览区生效，但只有点击更新配置发布后，线上 API 请求才会返回新的文案。

Q：模板文案支持哪些语言？

A：默认模板已内置中文、英文、日文、韩文、印地语版本，跟随应用（Application）语言自动配置；您也可以直接编辑覆盖为自定义文案。

最近更新时间：2026.08.12 14:49:22

这个页面对您有帮助吗？

有用

无用