# 功能概述推荐物品提权与降权功能允许你通过人工干预的方式，结合用户地理位置（LBS）和物品距离维度，调整特定物品在推荐结果中的排序。它提供了一种直接有效的手段来影响推荐结果，帮助你灵活实现推广新品、清理库存、打压负面商品或优化区域化推荐等业务目标。本文将指导你如何通过控制台配置物品的提权与降权。 ## 关键特性 * 提权配置：对指定物品提升推荐权重，使其在推荐结果中更容易被展示。 * 降权配置：对指定物品降低推荐权重，使其在推荐结果中更不容易被展示，支持结合距离维度触发降权。 * 权重因子：支持配置 \-100% 到 100% 的整数作为权重因子，数值越大，提权或降权的效果越明显。 * 距离维度支持：可基于用户地理位置（LBS）和物品实际距离范围配置权重，实现区域化的提权或降权控制。例如，对超出用户设定距离阈值的物品自动应用降权。 ## 典型使用场景 * 远距离物品降权：针对超出用户地理位置（LBS）设定距离范围的物品（如跨区域库存、配送受限商品），通过降权减少其在推荐结果中的曝光，提升推荐的地域相关性和用户体验。 # 前置操作如果您想使用地理位置能力，您必须确保以下前置操作已经完成： 1. 推荐场景所使用的「物品数据集」必须已配置上「经度」和「纬度」的字段属性

# 配置步骤 ## 添加新地理位置规则 :::warning \*注意系统不支持配置优先级。当一个物品符合多个配置，平台会累加多个配置项的提权、降权配置，并获取最后的权重因子。例如：如果物品 A 符合「提权 50% 」规则和「降权 30% 」规则，平台最终会将物品提权 20% 。 ::: 按照以下步骤，对特定物品进行提权、降权处理： 1. 在 **「体验配置」—「推荐体验」— 「推荐策略」** ，点击「提权、降权」进入提权、降权配置功能区。

2. 进入规则配置页面后，请填写以下信息：

|**配置项** |**说明** | |---|---| |规则名称 |配置一个简单易懂的名称，例如：“北京地区20公里外商品降权”。 | |配置生效范围 |1. 导航到「计算字段」，选择「用户与物品距离」。|\ | ||\ | |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/c8a91c86f6ec48229b9b965411385a71 =400x) |\ | ||\ | |2. 在条件设置部分，从下拉菜单中选择‘大于’或‘小于’，在输入框中填写距离数值（如 20），并选择单位（如 km）。|\ | ||\ | |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f81638eabfc94b3c8a239d7278c5e1b0 =396x) |\ | |:::tip 当一个物品有多个坐标，怎么办？|\ | |如果一个物品存在了多组「经度」和「纬度」坐标，平台在计算与用户的距离时，会自动选择离用户最近的那组坐标。|\ | ||\ | |:::| |提权/降权配置 |支持配置 \-100% 到 100% 的整数作为权重因子，数值越大，提权或降权的效果越明显。 | 3. 点击「确定」，平台会创建新规则。新的提权、降权规则将在下一个推荐请求中于体验界面生效。建议继续阅读[体验地理位置规则](/docs/85296/1963520#b8ff614f)章节，验证配置效果。 4. 在体验界面验证效果符合预期后，点击「同步配置至 API」。线上 API 接口也会利用新提权、降权规则。 5. API请求的 `context` 对象中必须包含 `location` 字段。格式示例如下，详情请查看 [Context](/docs/85296/1788543#65900099)。 ```JSON {"context":{"location": {"longitude": 116.4, "latitude": 39.9}}} ``` ## 体验地理位置规则配置完成地理位置相关的提权/降权规则后，你可以通过以下步骤在推荐体验界面验证规则效果，直观感受基于用户地理位置（LBS）和物品距离的推荐调整。 :::tip 前提条件您必须已完成「添加新地理位置规则」 ::: 1. **进入推荐体验界面** 在控制台导航至「体验配置」＞「推荐体验」，选择目标推荐场景（如首页推荐、商品列表页）。 2. **模拟用户地理位置与物品距离** 在左边「测试用户」区域，通过指定位置能力，模拟用户位置提降权的场景：

|**能力** |**能力说明** | |---|---| |获取我的位置 |获取您当前的位置来模拟测试用户，此操作需要您授予浏览器位置权限。|\ | |:::tip|\ | |如果点击了「获取我的位置」后，平台不自动获取经纬度，请检查： |\ | ||\ | |1. 电脑是否开启了位置能力|\ | |2. 电脑、浏览器是否限制了浏览器位置获取的权限|\ | ||\ | |若之前禁止浏览器位置获取的权限，必须重启电脑，重置权限限制。|\ | ||\ | |:::| |指定用户位置 |手动输入经纬度坐标（如 `经度：39.9°`、`纬度：116.4°`） | 3. **查看推荐结果变化** 点击「刷新推荐结果」，系统将基于模拟的用户地理位置和物品实际距离（需物品数据集已配置经纬度），应用已配置的提权/降权规则。例如： * **近距离物品提权效果**：若规则设置「距离用户5公里以内的物品提权50%」，则该范围内的物品会在推荐列表中排序靠前。 * **远距离物品降权效果**：若规则设置「距离用户20公里以外的物品降权80%」，则超出该距离的物品会在推荐列表中排序靠后（或减少曝光）。 --- # 常见问题 **问：为什么体验界面的推荐结果和线上有差异？** 答：体验界面的推荐结果仅为预览效果，实际线上用户将根据其真实地理位置和物品距离触发规则。 **问：为什么我配置规则后，没有察觉到差异？** 答：若未观察到预期效果，可检查： 1. 物品数据集是否正确配置「经度」「纬度」字段； 2. 规则中的「距离配置」是否匹配测试场景； 3. 权重因子是否设置合理（数值越大，效果越明显）。 **问：为什么我没有「用户与物品距离」的选项？** 答：麻烦检查物品数据集，字段是否配置了「经度」和「纬度」的属性。如果需要更新字段属性配置，请联系火山技术团队。 --- # 相关文档 1. 其他提权、降权能力，请参考 [物品属性提权与降权](/docs/85296/1925098)。 2. 如果想根据「发布时间」或「上新时间」提权和降权物品，请参考 [时间对比提权与降权](/docs/85296/2096788) 。

全域AI搜索