推荐物品提权与降权功能允许你通过人工干预的方式，结合用户地理位置（LBS）和物品距离维度，调整特定物品在推荐结果中的排序。它提供了一种直接有效的手段来影响推荐结果，帮助你灵活实现推广新品、清理库存、打压负面商品或优化区域化推荐等业务目标。本文将指导你如何通过控制台配置物品的提权与降权。

推荐物品提权与降权是一项人工干预功能，允许运营人员结合用户地理位置（LBS）和物品与用户的实际距离，调整特定物品的权重分值，来提升或降低其在推荐系统中的排序优先级。该功能旨在提供一种直接、有效的手段来影响推荐结果，以满足特定的业务运营需求（包括基于距离的精细化调控）。

关键特性

• 提权配置：对指定物品提升推荐权重，使其在推荐结果中更容易被展示。
• 降权配置：对指定物品降低推荐权重，使其在推荐结果中更不容易被展示，支持结合距离纬度触发降权。
• 权重因子：支持配置 -100% 到 100% 的整数作为权重因子，数值越大，提权或降权的效果越明显。
• 距离纬度支持：可基于用户地理位置（LBS）和物品实际距离范围配置权重，实现区域化的提权或降权控制。例如，对超出用户设定距离阈值的物品自动应用降权。

典型使用场景

• 远距离物品降权：针对超出用户地理位置（LBS）设定距离范围的物品（如跨区域库存、配送受限商品），通过降权减少其在推荐结果中的曝光，提升推荐的地域相关性和用户体验。

如果您想使用地理位置能力，您必须确保以下前置操作已经完成：

1. 推荐场景所使用的「物品数据集」必须已配置上「经度」和「纬度」的字段属性

添加新地理位置规则

按照以下步骤，对特定物品进行提权、降权处理：

1. 在体验配置 ＞ 推荐体验，查看右边「物品提权/降权」配置入口。点击「添加规则」进入提降权配置功能区。

2. 如果推荐场景内没有现有规则，界面会引导配置新提权、降权规则。

3. 在规则配置页面，填写以下信息：

4. 点击「确定」，平台会创建新规则。新的提权、降权规则将在下一个推荐请求中于体验界面生效。
5. 当配置符合预期，点击「同步配置至 API」。线上 API 接口也会利用新提权、降权规则。
6. API请求的 context 对象中必须包含 location 字段。详情请查看 Context

体验地理位置规则

配置完成地理位置相关的提权/降权规则后，你可以通过以下步骤在推荐体验界面验证规则效果，直观感受基于用户地理位置（LBS）和物品距离的推荐调整：
前提条件： 已完成「添加新地理位置规则」

1. 进入推荐体验界面
   在控制台导航至「体验配置」＞「推荐体验」，选择目标推荐场景（如首页推荐、商品列表页）。

2. 模拟用户地理位置与物品距离
   在左边「测试用户」区域，通过指定位置能力，模拟用户位置提降权的场景：

   

   能力	能力说明
   获取我的位置	获取您当前的位置来模拟测试用户，此操作需要您授予浏览器位置权限。 说明 如果点击了「获取我的位置」后，平台不自动获取经纬度，请检查： 电脑是否开启了位置能力 电脑、浏览器是否限制了浏览器位置获取的权限 若之前禁止浏览器位置获取的权限，必须重启电脑，重置权限限制。
   指定用户位置	手动输入经纬度坐标（如 经度：39.9°、纬度：116.4°）

3. 查看推荐结果变化
   点击「刷新推荐结果」，系统将基于模拟的用户地理位置和物品实际距离（需物品数据集已配置经纬度），应用已配置的提权/降权规则。例如：

   • 近距离物品提权效果：若规则设置「距离用户5公里以内的物品提权50%」，则该范围内的物品会在推荐列表中排序靠前。
   • 远距离物品降权效果：若规则设置「距离用户20公里以外的物品降权80%」，则超出该距离的物品会在推荐列表中排序靠后（或减少曝光）。

问：为什么体验界面的推荐结果和线上有差异？
答：体验界面的推荐结果仅为预览效果，实际线上用户将根据其真实地理位置和物品距离触发规则。

问：为什么我配置规则后，没有察觉到差异？
答：若未观察到预期效果，可检查：

1. 物品数据集是否正确配置「经度」「纬度」字段；
2. 规则中的「距离配置」是否匹配测试场景；
3. 权重因子是否设置合理（数值越大，效果越明显）。

问：为什么我没有「用户与物品距离」的选项？
答：麻烦检查物品数据集，字段是否配置了「经度」和「维度」的属性。如果需要更新字段属性配置，请联系火山技术团队。

1. 其他提权、降权能力，请参考 物品提权与降权。
2. 如果想根据「发布时间」或「上新时间」提权和降权物品，请参考 时间对比提权与降权 。