手机游戏攻略
用户在移动端搜索手机游戏攻略、玩法等需求时,比如“王者荣耀攻略”,搜索会展现该卡片,提供结构化的游戏攻略信息。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 必选/可选 | 示例/说明 |
---|---|---|---|---|
game_name | string | 游戏名 | 必选 | “王者荣耀” |
注释:
结构化攻略卡的召回 query 可分成两个模块: intent(game_name) + 常量词(比如,攻略/怎么玩),如果想扩大召回,需要扩充 intent 和常量词典。 其中 intent 由资源方控制,常量词由百度产品同学填写。
intent,用户意图,由资源方提交, 结构化攻略卡的 intent 名称为 game_name,资源方要尽可能扩充符合标准的 game_name;
常量词由百度产品填写,包含 攻略/怎么玩/新手攻略/入门攻略/教学/新手教学 等,如果需要添加,请联系产品同学评估。
典型召回 query 的模块拆解
典型召回 query | game_name | 常量词 |
---|---|---|
王者荣耀怎么玩 | 王者荣耀 | 怎么玩 |
王者荣耀新手攻略 | 王者荣耀 | 新手攻略 |
密室逃脱 22 海上惊魂攻略 | 密室逃脱 22 海上惊魂 | 攻略 |
倩女幽魂入门攻略 | 倩女幽魂 | 入门攻略 |
- game_name 要求,务必严格遵守,不仅会影响审核,还会影响线上召回。① 填写结构:填写游戏名,如“王者荣耀”。② 准入范围:a. 一定填精准游戏名,不能填写含义模糊、过于泛的名字,比如“三国”,因为三国对应了好多游戏,根本无法判断出哪个游戏;b. 如果游戏有别名,单独填写一次;比如命运冠位指定,需要填两次, 一次是“命运冠位指定”,一次是“fgo”;③ 文本规范:a. 不要带标点符号,正确“命运冠位指定”,错误“命运-冠位指定”。如果填写标点符号,可能会导致线上不展现;b. 大写字母都变小写,比如“qq 飞车”, “最强 nba”。
通过平台上传 txt 文件
资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 Intent 数据。
当前资源分类 txt 上传文件内容示例如下:
- {"game_name":"王者荣耀"}
{"game_name":"命运冠位指定"}
{"game_name":"fgo"}
通过开放 API 上传
未开放
Webhook API
发送给 webhook 的请求
公共字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
type | string | 请求类型(大部分开发者可不关心) | 在小程序阿拉丁下永远为 “sp_ala” |
surface | string | 搜索场景(大部分开发者可不关心) | mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索 |
srcid | string | 资源编号 | 每个资源分类不同 |
intent | object | 搜索意图参数 | JSON 对象,每个资源分类不同 |
当前资源 srcid 资源编号
key | 类型 | 含义 | 设定 |
---|---|---|---|
srcid | string | 资源编号 | 48016 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例:发送给 webhook 的 JSON (解密后)
- {
"type": "sp_ala",
"srcid": "48016",
"surface": "mobile",
"intent": {
"game_name": "王者荣耀"
}
}
从 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” |
category_list.update_time | string | 必选 | 数据更新时间 |
举例:从 webhook 返回的 JSON (加密前)
- {
"status": 0,
"msg": "string",
"data": {
"jump_url": "string",
"category_list": [
{
"category_name": "新手教学",
"item_list": [
{
"title": "王者荣耀新手上路必备攻略",
"image": "https://example.com/path",
"read_num": "1.9w",
"time": "2019–10-08",
"url": "/gonglue/20140127/401468.html"
},
{
"title": "王者荣耀新手教程:怎么打金币",
"image": "https://example.com/path",
"read_num": "1.9w",
"time": "2019-10-05",
"url": "/gonglue/20160429/1709799.html"
},
{
"title": "王者荣耀新手教程:打暴君攻略",
"image": "https://example.com/path",
"read_num": "2.2w",
"time": "2019-10-01",
"url": "/gonglue/20160504/1713831.html"
}
],
"update_time": "2019-10-09"
},
{
"category_name": "符文",
"item_list": [
{
"title": "string",
"image": "https://example.com/path",
"read_num": "string",
"time": "string",
"url": "string"
}
],
"update_time": "string"
}
]
}
}