您可以在搜索请求中指定升位条件，以提升或降低搜索结果中某些文档的排名。当文档满足指定条件时，系统会向其应用提升值，并相应地对结果进行排序。您还可以指定自定义数值和时间戳值，以便根据热度和新鲜度等参数对结果进行排序。
搜索请求中的升位规范与附加到服务配置的升位控制不同。如需详细了解提升控制，请参阅提升控制简介。
本页介绍了以下类型的加权规范：
使用固定条件进行提升
如需根据结果是否满足条件按固定量提升结果，请执行以下操作：
发送
servingConfigs.search请求时，在boostSpec字段中指定提升规范。{ "boostSpec": { "conditionBoostSpecs": { "condition": "BOOST_CONDITION", "boost": BOOST_VALUE } } }规范包含以下参数：
BOOST_CONDITION：用于选择应用加权的文档的文本过滤表达式。过滤条件的求值结果必须为布尔值。BOOST_VALUE：[-1,1] 范围内的浮点数。如果该值为负值，则结果会被降级（显示在结果中更靠下的位置）。如果值为正，则结果会获得提升（显示在结果中更靠上的位置）。
用例示例
假设您的数据存储区包含有关酒店及其星级的数据。您希望提高星级评分大于或等于 3 的酒店的排名。星级评分可在 star_rating 数字字段中查看。您可以在 boostSpec 中将 condition 指定为 star_rating >= 3.0，并将提升值指定为 0.7，以同等程度提升所有 star_rating 为 3.0 或更高的酒店。
{
"boostSpec": {
"conditionBoostSpecs": {
"condition": "star_rating>=3.0",
"boost": 0.7
}
}
}
使用自定义数值属性进行提升
您可以指定控制点及其对应的提升值，以分段线性方式根据自定义数值属性提升结果。
如需使用自定义数值属性指定加权规范，请执行以下操作：
发送
servingConfigs.search请求时，在boostSpec字段中指定提升规范。{ "boostSpec": { "conditionBoostSpecs": { "condition": "BOOST_CONDITION", "boostControlSpec": { "attributeType": "NUMERICAL", "interpolationType": "LINEAR", "fieldName": "CUSTOM_ATTRIBUTE_FIELD_NAME", "controlPoints": [ { "attributeValue": "CUSTOM_ATTRIBUTE_VALUE_1", "boostAmount": BOOST_AMOUNT_1 }, { "attributeValue": "CUSTOM_ATTRIBUTE_VALUE_2", "boostAmount": BOOST_AMOUNT_2 } ] } } } }规范包含以下参数：
BOOST_CONDITION：用于选择应用加权的文档的文本过滤表达式。过滤条件的求值结果必须为布尔值。CUSTOM_ATTRIBUTE_FIELD_NAME：自定义数值属性的字段名称，该属性的值决定了提升幅度。CUSTOM_ATTRIBUTE_VALUE：具有字符串数据类型的给定控制点的自定义属性的数值。例如"3.3"或"12"。如需了解详情，请参阅 ControlPoint。BOOST_AMOUNT：[-1,1] 范围内的浮点数。如果该值为负值，则结果会被降级（显示在结果中更靠下的位置）。如果值为正，则结果会获得提升（显示在结果中更靠上的位置）。 表示映射到给定控制点的自定义属性的升幅。
当搜索结果中的文档满足指定条件时，系统会应用以下提升量：
| 属性值 | 提升金额 |
|---|---|
| 小于第一个控制点 | 等于第一个控制点的升幅 |
| 等于控制点 | 等于映射的加推金额 |
| 控制点之间 | 通过线性插值计算得出 |
| 大于最后一个控制点 | 等于最后一个控制点的升幅 |
用例示例
假设您的数据存储区包含有关酒店及其星级的数据。您希望按酒店的星级比例提升酒店搜索结果。您可以按如下方式定义提升规范：
{
"boostSpec": {
"conditionBoostSpecs": {
"condition": "star_rating >= 3.0",
"boostControlSpec": {
"attributeType": "NUMERICAL",
"interpolationType": "LINEAR",
"fieldName": "star_rating",
"controlPoints": [
{
"attributeValue": "3.5",
"boostAmount": 0.25
},
{
"attributeValue": "4.0",
"boostAmount": 0.30
},
{
"attributeValue": "4.5",
"boostAmount": 0.32
}
]
}
}
}
}
在此场景中，搜索结果的提升方式如下：
| 星级 | 提升金额 |
|---|---|
| 小于或等于 3.5 | 0.25 |
| 介于 3.5 和 4.0 之间 | 介于 0.25 和 0.30 之间，使用线性插值法计算得出 |
| 等于 4.0 | 0.30 |
| 介于 4.0 和 4.5 之间 | 介于 0.30 和 0.32 之间，使用线性插值法计算得出 |
| 大于或等于 4.5 | 0.32 |
根据新鲜度提高出价
您可以指定控制点及其对应的提升值，以分段线性方式根据日期时间属性提升结果。
如需使用自定义日期时间属性指定加权规范，请执行以下操作：
发送
servingConfigs.search请求时，在boostSpec字段中指定提升规范。{ "boostSpec": { "conditionBoostSpecs": { "condition": "BOOST_CONDITION", "boostControlSpec": { "fieldName": "DATETIME_FIELD_NAME", "attributeType": "FRESHNESS", "interpolationType": "LINEAR", "controlPoints": [ { "attributeValue": "DURATION_VALUE_1", "boostAmount": BOOST_AMOUNT_1 }, { "attributeValue": "DURATION_VALUE_2", "boostAmount": BOOST_AMOUNT_2 } ] } } } }规范包含以下参数：
BOOST_CONDITION：用于选择应用加权的文档的文本过滤表达式。过滤条件的求值结果必须为布尔值。DATETIME_FIELD_NAME：自定义DATETIME属性的字段名称，例如发布日期或上次更新日期，或者预定义的 Google 推断属性，例如datePublished。DURATION_VALUE：以dayTimeDuration数据类型表示的时长值，用于确定文档的新鲜度。此值是指执行搜索时的日期时间与文档的自定义日期时间属性的日期时间之间的时长。时长值必须按照 ISO 8601 格式以[nD][T[nH][nM][nS]]模式指定。例如，2024 年 1 月 1 日至 2024 年 3 月 1 日之间的时长可以表示为59D。同样，两天半的时长可以表示为2DT12H。如需了解详情，请参阅 ControlPoint。BOOST_AMOUNT：[-1,1] 范围内的浮点数。如果该值为负值，则结果会被降级（显示在结果中更靠下的位置）。如果值为正，则结果会获得提升（显示在结果中更靠上的位置）。 表示与给定控制点的自定义日期时间属性对应的提升幅度。
当搜索结果中的文档满足指定条件时，系统会应用以下提升量：
| 时长值 | 提升金额 |
|---|---|
| 小于第一个控制点 | 等于第一个控制点的升幅 |
| 等于给定的控制点 | 等于映射的加推金额 |
| 控制点之间 | 通过线性插值计算得出 |
| 大于最后一个控制点 | 等于最后一个控制点的升幅 |
使用自定义日期时间属性的示例用例
假设您的数据存储区包含结构化数据，其中每个文档都有发布日期。您希望按新鲜度比例提升搜索结果。您可以按如下方式定义加权规范：
{
"boostSpec": {
"conditionBoostSpecs": {
"condition": true,
"boostControlSpec": {
"fieldName": "publication_date",
"attributeType": "FRESHNESS",
"interpolationType": "LINEAR",
"controlPoints": [
{
"attributeValue": "7D",
"boostAmount": 0.40
},
{
"attributeValue": "30D",
"boostAmount": 0.37
},
{
"attributeValue": "60D",
"boostAmount": 0.32
},
{
"attributeValue": "90D",
"boostAmount": 0
}
]
}
}
}
}
在此场景中，搜索结果的提升方式如下：
| 时效性 | 提升金额 |
|---|---|
| 小于或等于 7 天 | 0.40 |
| 7 至 30 天 | 介于 0.40 和 0.37 之间，使用线性插值法计算得出 |
| 等于 30 天 | 0.37 |
| 30 至 60 天 | 介于 0.37 和 0.32 之间，使用线性插值法计算得出 |
| 等于 60 天 | 0.32 |
| 60 天到 90 天之间 | 介于 0.32 和 0.0 之间，使用线性插值法计算得出 |
| 大于或等于 90 天 | 0.0 |
使用相关性过滤条件来调节加推金额
除了影响结果排名的因素（例如关键字匹配、上下文匹配和相关性）之外，提升条件还会显著影响结果的排名。因此，您必须仔细校准提升量，尤其是在将 boostSpec 字段与相关性过滤条件搭配使用时。如需详细了解相关性过滤条件，请参阅按文档级相关性过滤搜索结果。
假设您有发布日期不同的多个文档。对于特定查询，下表表示在未实施任何提升量或相关性过滤条件的情况下，文档的绝对排名，并指明文档与查询的相关性。
| 文档 | 发布日期 | 相关性 | 排名 |
|---|---|---|---|
| A | 2024 年 2 月 1 日 | 高 | #1 |
| B | 2024 年 3 月 1 日 | 高 | #2 |
| C | 2024 年 4 月 1 日 | 最低 | #3 |
| D | 2024 年 5 月 1 日 | 中 | #4 |
| E | 2024 年 6 月 1 日 | 低 | #5 |
2024 年 6 月 6 日，您在搜索请求中添加了以下搜索条件：
- 相关性过滤条件已设置为
LOW。 - 提升值，使得过去 31 天内发布的文档的提升值为 0.7，而发布时间超过一周但不到 60 天的文档的提升值为 0.6。
在搜索输出中，系统会先按相关性过滤结果，然后再应用提升量。因此，应用条件后，结果中网页的排名会按以下方式发生变化：
| 文档 | 发布日期 | 相关性 | 排名 |
|---|---|---|---|
| E | 2024 年 6 月 1 日 | 低 | #1 |
| D | 2024 年 5 月 1 日 | 中 | #2 |
| A | 2024 年 2 月 1 日 | 高 | #3 |
| B | 2024 年 3 月 1 日 | 高 | #4 |
由于相关性过滤条件，相关性最低的结果会被过滤掉。 与查询的相关性较低的文档被评为热门结果，因为它们获得了较高的提升值。相关度越高的结果排名越低。
因此，Google 建议您从较低的精确值开始设置提升幅度，然后根据搜索输出调整该值。在此示例中，从 0.1 或更低的提升量开始，可能会在顶部获得更相关的结果。