用户在移动端搜索 PC 游戏攻略、玩法等需求时,比如“英雄联盟攻略”,搜索会展现该卡片,提供结构化的游戏攻略信息。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 必选/可选 | 示例/说明 |
---|---|---|---|---|
game_name | string | 游戏名 | 必选 | “英雄联盟” |
注释:
- 结构化攻略卡的召回 query 可分成两个模块: intent(game_name) + 常量词(比如,攻略/怎么玩),如果想扩大召回,需要扩充 intent 和常量词典。 其中 intent 由资源方控制,常量词由百度产品同学填写。
- intent,用户意图,由资源方提交, 结构化攻略卡的 intent 名称为 game_name,资源方要尽可能扩充符合标准的 game_name;
- 常量词由百度产品填写,包含 攻略/怎么玩/新手攻略/入门攻略/教学/新手教学 等,如果需要添加,请联系产品同学评估。
- 典型召回 query 的模块拆解
典型召回 query | game_name | 常量词 |
---|---|---|
英雄联盟怎么玩 | 英雄联盟 | 怎么玩 |
英雄联盟新手攻略 | 英雄联盟 | 新手攻略 |
云顶之奕攻略 | 云顶之奕 | 攻略 |
暴走英雄坛百花门入门攻略 | 暴走英雄坛百花门 | 入门攻略 |
- game_name 要求,务必严格遵守,不仅会影响审核,还会影响线上召回。
① 三种填写结构:
a. 填写游戏名,如“英雄联盟”,
b. 游戏名+mode,如“英雄联盟云顶之奕”,
c. 著名 Mode,如“云顶之奕”;
② 准入范围:
a. 一定填精准游戏名,不能填写含义模糊、过于泛的名字,比如“三国”,因为三国对应了好多游戏,根本无法判断出哪个游戏;
b. 如果游戏有别名,单独填写一次;比如侠盗飞车 5,需要填两次, 一次是“侠盗飞车 5”,一次是“gta5”;
③ 文本规范:
a. 不要带标点符号,正确“遗迹灰烬重生”,错误“遗迹:灰烬重生”。如果填写标点符号,可能会导致线上不展现;
b. 大写字母都变小写,比如“gta5”, “lol”。
通过平台上传 txt 文件
资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 Intent 数据。
当前资源分类 txt 上传文件内容示例如下:
1 | {"game_name":"英雄联盟"} |
通过开放 API 上传
详细接入方式参见 API上传方式
Webhook API
发送给 webhook 的请求
公共字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
type | string | 请求类型 | 在小程序阿拉丁下永远为 “sp_ala” |
surface | string | 搜索场景 | mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索 |
srcid | string | 资源编号 | 每个资源分类不同 |
intent | object | 搜索意图参数 | JSON 对象,每个资源分类不同 |
当前资源 srcid 资源编号
key | 类型 | 含义 | 设定 |
---|---|---|---|
srcid | string | 资源编号 | 48014 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例:发送给 webhook 的 JSON (解密后)
1 | { |
从 webhook 返回的结果
外层通用数据字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
status | integer | 结果状态码,0 代表正确,1 代表无结果, 2 代表请求参数错误,3 代表内部服务错误 |
0 |
msg | string | 出错消息,当非 0 时提供 | “” |
data | object | 要返回的资源数据内容 | JSON 对象,每个资源分类不同 |
当前资源分类的 data
object 字段内容
key | 类型 | 要求 | 说明 |
---|---|---|---|
jump_url | string | 必选 | 卡片标题的跳转链接,如果文章列表只有一个内容,就跳到该内容链接。如果文章列表大于 1 个内容,就跳到游戏的攻略专区。 H5 的跳转链接要去掉域名。例如:/games/hzwwqfb/ ;小程序的跳转,使用“/page/of/target” |
category_list | array | 必选 | Tabs 攻略 tab 细分类数据,最少 2 个,最多 5 个 |
category_list.category_name | string | 必选 | 攻略 tab 细分类名称,比如新手攻略、合成表、指令教程等 |
category_list.item_list | array | 必选 | 攻略文章数组,最少 1 个,最多 3 个 |
category_list.item_list.title | string | 必选 | 文章标题,1 行截断,最多展现 10-12 个字 |
category_list.item_list.image | string | 必选 | 文章封面图,图片比例: 364*243 |
category_list.item_list.read_num | string | 可选,选后不可为空 | 文章阅读量,例如:1.9w,2890,36w,四舍五入即可 |
category_list.item_list.time | string | 必选 | 文章时间,时间:年月日,比如 2019-07-20. 同一张卡片下的数据格式应该相同 |
category_list.item_list.url | string | 必选 | 文章跳转链接。H5 的跳转链接要去掉域名,例如:/games/a/2396308.html ;小程序的跳转,使用“/page/of/target” |
举例:从 webhook 返回的 JSON (加密前)
1 | { |