导航
动态推荐范围配置
最近更新时间：2025.12.03 00:34:00首次发布时间：2025.10.10 00:32:51
文档反馈
问问助手背景
在某些推荐场景中，用户会因为自身的喜好，对推荐的结果进行筛选，只看到筛选后的推荐结果。这时可以基于动态筛选的功能，在平台完成动态筛选的配置，在请求推荐服务接口时，回传筛选的属性值，完成动态的筛选。本文将指导您完成动态推荐范围的配置，并通过API调用实现该功能。
须知
注意
- 系统不做互斥校验，需您在配置时保持过滤逻辑的正确性，若存在互斥条件，虽然系统不会报错，但将只返回空结果。
- 请注意，过滤条件仅对包含相应字段的物品生效。如果某个物品缺少您指定的过滤字段，系统将跳过该过滤规则，不会将其排除。
业务场景
行业 | 适用场景 |
|---|---|
视频 | 在用户浏览长视频时，对电影、电视剧等视频类型或者视频的地区等属性进行筛选。 |
电商 | 在浏览电商网站时，对于某个品牌商品进行筛选，或根据用户的积分筛选对应价格区间的商品。 |
配置步骤
- 创建或编辑过滤规则：在【推荐体验界面】-【推荐结果配置】-【推荐配置范围】中，创建新的过滤规则。您也可以编辑现有过滤规则，加上动态过滤条件。
- 配置过滤字段：通过【规则配置】，配置您想过滤的字段。
通过 AND/OR 逻辑组合物品字段筛选条件，支持字段、操作符（包含/不包含/RANGE 等）及值的自定义配置：
配置项 | 说明 |
|---|---|
逻辑运算符 | 选择条件组合逻辑（AND 需全部满足，OR 满足任一即可）。 |
筛选字段 | 选择物品数据集中的目标字段。 说明 筛选字段只支持使用了「可用于过滤」的字段 |
条件类型 | 选择匹配规则（如 包含 (in)、不包含 (not in)、数值范围比较等）。 |
条件值 | 输入匹配值（多值用英文逗号分隔，数字字段直接输入数值）。 |
- 在条件值的输入框内，点击灰色的「动态参数」配置。平台支持选择多个物品属性进行动态筛选，多个物品属性之间可以配置 or/and 的关系。动态参数是一个“占位符”，无需在这里写具体值，每次实际请求时再动态传入。
- 保存配置。
说明
动态过滤配置无法在平台体验，需要通过API接口传入动态参数值来体验动态过滤效果。
- 若您想体验动态过滤的效果，选择配置并「同步配置至 API」来生效配置。您可以通过调用 API 接口，体验动态过滤的效果。
API 请求
动态过滤依赖您在请求推荐接口时，将动态的参数值传入。如果配置了多个物品属性，在线传入的时候每个物品属性的参数值都需要传入。
- 例如，您可以在请求体中加入动态参数字段，如
{"filter": {"brand": "selected_brand"}}，其中brand是您配置的动态参数名称，selected_brand是实际需要过滤的品牌值。
说明
了解在线请求如何将参数值回传 API 服务，请参考 Filter。
参数异常
当在线参数异常时，平台会自动处理并缩小影响范围。具体的过滤逻辑如下：
场景 | 默认处理逻辑 |
|---|---|
在线请求没有上传参数 | 忽略受影响的动态过滤配置，其他过滤配置（静态和动态）继续生效
|
在线请求上传参数但是没有值 | 同上 |
召回物品缺失字段 | 整体过滤条件会自动忽略。 |