热搜和底纹

热搜和底纹是一个完整搜索引擎必备的基本功能，通常占据着搜索框入口的重要位置，提供不可或缺的业务价值。下图是看一个典型电商平台的热搜和底纹的位置。

热搜和底纹处于搜索引擎整个工作流程的最上游，为搜索优化起铺垫作用，可以大大降低query理解、排序、运营干预等环节的调优难度，并且结合运营策略可以有比较大的发挥空间。

从用户的角度来看，热搜底纹一般可以满足如下的需求：

从运营者的角度，热搜和底纹可以提供这样的价值：

【控制台热搜榜】和【热搜推荐接口】有以下几点区别：

温馨提示

创建热搜或底纹模型

API/SDK创建热搜和底纹模型：

管控SDK依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-opensearch</artifactId>
    <version>0.7.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.0</version>
</dependency>

Java SDK Demo

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.opensearch.model.v20171225.*;
import com.aliyuncs.profile.DefaultProfile;
public class CreateModel {
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-beijing", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);
        CreateModelRequest request = new CreateModelRequest();
        request.setAppGroupIdentity("app_name");
 //type为算法类型：热搜设置为hot，底纹设置为hint；modelName为模型名称：自定义，由英文数字、字母、下划线组成，非纯数字，不超过30个字符
        String content = "{\"type\": \"hot\",\"name\": \"model_name\"}";
        request.setHttpContent(content.getBytes(), "UTF-8", FormatType.JSON);
        try {
            HttpResponse response = client.doAction(request);
            System.out.println(response.getHttpContentString());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

页面创建模型

1、在搜索引导->热搜与底纹页面，点击创建按钮创建热搜或底纹模型：

2、填写名称，选择模型类型（热搜/底纹模型），填写过滤条件（非必选）：

3、在热搜与底纹页面的列表页中找到刚创建的状态为“待训练”的模型，点击训练：4、训练完成后可通过热搜效果预览查看效果：

热搜效果预览：

底纹效果预览：

注意：

热搜与底纹页面介绍

热搜与底纹列表介绍

可通过搜索引导->热搜与底纹下查看，模型名称、模型类型、创建时间、模型状态、最后训练开始时间、最新版本状态和操作信息。用户可以根据自身需求设置默认模型，如果参数中没有设定模型名称，则访问默认模型。

热搜与底纹 详情页介绍

其基本信息包含创建时间、模型状态、最后训练开始时间、最新版本状态。也可在训练历史下查看模型版本、版本状态、训练开始时间、训练结束时间等信息。模型训练后为两种状态训练成功和训练失败

训连失败问题查看：

可点击详情进入详情页查看：可以通过异常报告查看失败的原因，在升级条件下查看所需条件。

个性化配置：

黑白名单配置：用户可根据自身业务的需求对模型进行黑白名单配置在模型详情下配置信息处点击配置

SDKSDK获取热搜/底纹结果

在产品中集成热搜和底纹功能，可以通过API/SDK来调用热搜底纹的推荐结果，热搜和底纹API文档。SDK Demo请参考下文。

热搜功能默认返回10个query，底纹功能默认返回3个query，用于在搜索框中轮播。

温馨提示：

流量SDK依赖：

<dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.5.0</version>
</dependency>

Java SDK Demo

import java.util.HashMap;
import java.util.Map;
import com.alibaba.fastjson.JSON;
import com.aliyun.opensearch.OpenSearchClient;
import com.aliyun.opensearch.sdk.generated.OpenSearch;
import com.aliyun.opensearch.sdk.generated.commons.OpenSearchClientException;
public class Hot {
    private static final String accesskey = "替换为accesskey";
    private static final String secret = "替换为secret";
    private static final String host = "替换为endpoint, 例如：http://opensearch-cn-hangzhou.aliyuncs.com";
    private static final String appName = "替换为opensearch应用名";
    private static final String HOT_API_PATH = "/apps/{app_name}/actions/hot";
    public static void main(String[] args) {
        OpenSearch openSearch = new OpenSearch(accesskey, secret, host);
        // Create OpenSearchClient
        OpenSearchClient client = new OpenSearchClient(openSearch);
        String requestPath = HOT_API_PATH.replaceAll(("\\{app_name\\}"), appName);
        Map<String, String> params = new HashMap<>();
        params.put("model_name", "your_model_name");//设置模型名称
        params.put("hit", "20");//设置查询的热搜词数据条数
        try {
            String response = client.call(requestPath, params, OpenSearchClient.METHOD_GET);
            System.out.println(JSON.toJSONString(response));
        } catch (OpenSearchClientException e) {
            e.printStackTrace();
        }
    }
}

效果优化

行为数据

基于统计搜索日志的热搜/底纹结果可以满足冷启动阶段的需求，在这个功能开始发挥作用后，建议关联热搜/底纹的用户点击事件，系统内部通过采集行为数据（from_request_id和user_id）来进一步优化效果，采集了行为数据有如下几个收益：

热搜/底纹引导搜索流量

API/SDK获取到的热搜/底纹结果中会返回一个request_id， 用于唯一标识这一次请求。通常，如果产品中集成了热搜/底纹结果，当终端用户点击了热搜词或底纹词后，便会以该热搜词或底纹词作为搜索词触发一次搜索请求，通过在搜索请求中将from_request_id参数设置为热搜/底纹结果返回的request_id，就可以关联这一次用户点击行为，后台通过搜索日志分析和统计了这些点击行为，就可以在业务运营报表中看到由热搜/底纹引导的搜索流量指标。如果在搜索请求中设置了user_id参数，业务运营报表中还可以看到热搜/底纹引导的搜索UV指标。

温馨提示：

界面介绍

热搜：

可以通过【搜索算法中心-->搜索引导—->热搜与底纹】，“查看指标”进入热搜的运营报表;

也可以直接在“统计报表—->热搜报表”里查：

底纹：

可以通过【搜索算法中心-->搜索引导—->热搜与底纹】，“查看指标”进入底纹的运营报表;

也可以直接在“统计报表—->底纹报表”里查：

注意：