PC游戏攻略

用户在移动端搜索 PC 游戏攻略、玩法等需求时,比如“英雄联盟攻略”,搜索会展现该卡片,提供结构化的游戏攻略信息。

示意图

PC游戏攻略 - 图1

intent 上传接口

当前资源 intent 意图参数

key类型含义必选/可选示例/说明
game_namestring游戏名必选“英雄联盟”

注释:

  • 结构化攻略卡的召回 query 可分成两个模块: intent(game_name) + 常量词(比如,攻略/怎么玩),如果想扩大召回,需要扩充 intent 和常量词典。 其中 intent 由资源方控制,常量词由百度产品同学填写。

  • intent,用户意图,由资源方提交, 结构化攻略卡的 intent 名称为 game_name,资源方要尽可能扩充符合标准的 game_name;

  • 常量词由百度产品填写,包含 攻略/怎么玩/新手攻略/入门攻略/教学/新手教学 等,如果需要添加,请联系产品同学评估。

  • 典型召回 query 的模块拆解

典型召回 querygame_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":"英雄联盟"}
    {"game_name":"lol"}
    {"game_name":"英雄联盟云顶之奕"}
    {"game_name":"云顶之奕"}

通过开放 API 上传

未开放

Webhook API

发送给 webhook 的请求

公共字段

key类型含义示例/说明
typestring请求类型(大部分开发者可不关心)在小程序阿拉丁下永远为 “sp_ala”
surfacestring搜索场景(大部分开发者可不关心)mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索
srcidstring资源编号每个资源分类不同
intentobject搜索意图参数JSON 对象,每个资源分类不同

当前资源 srcid 资源编号

key类型含义设定
srcidstring资源编号48014

当前资源的 intent 参数参考上节 “intent 上传接口“。

举例:发送给 webhook 的 JSON (解密后)

  1. {
    "type": "sp_ala",
    "srcid": "48014",
    "surface": "mobile",
    "intent": {
    "game_name": "英雄联盟"
    }
    }

从 webhook 返回的结果

外层通用数据字段

key类型含义示例/说明
statusinteger结果状态码,0 代表正确,1 代表无结果,2 代表请求参数错误,3 代表内部服务错误0
msgstring出错消息,当非 0 时提供“”
dataobject要返回的资源数据内容JSON 对象,每个资源分类不同

当前资源分类的 data object 字段内容

key类型要求说明
jump_urlstring必选卡片标题的跳转链接,如果文章列表只有一个内容,就跳到该内容链接。如果文章列表大于 1 个内容,就跳到游戏的攻略专区。 H5 的跳转链接要去掉域名。例如:/games/hzwwqfb/ ;小程序的跳转,使用“/page/of/target”
category_listarray必选Tabs 攻略 tab 细分类数据,最少 2 个,最多 5 个
category_list.category_namestring必选攻略 tab 细分类名称,比如新手攻略、合成表、指令教程等
category_list.item_listarray必选攻略文章数组,最少 1 个,最多 3 个
category_list.item_list.titlestring必选文章标题,1 行截断,最多展现 10-12 个字
category_list.item_list.imagestring必选文章封面图,图片比例: 364*243
category_list.item_list.read_numstring可选,选后不可为空文章阅读量,例如:1.9w,2890,36w,四舍五入即可
category_list.item_list.timestring必选文章时间,时间:年月日,比如 2019-07-20. 同一张卡片下的数据格式应该相同
category_list.item_list.urlstring必选文章跳转链接。H5 的跳转链接要去掉域名,例如:/games/a/2396308.html ;小程序的跳转,使用“/page/of/target”
category_list.update_timestring必选数据更新时间

举例:从 webhook 返回的 JSON (加密前)

  1. {
    "status": 0,
    "msg": "string",
    "data": {
    "jump_url": "string",
    "category_list": [
    {
    "category_name": "新手攻略",
    "item_list": [
    {
    "title": "我的世界46条新手小常识",
    "image": "https://example.com/path",
    "read_num": "1.9w",
    "time": "2019-07-20",
    "url": "/gonglue/20140127/401468.html"
    },
    {
    "title": "关于升级我的世界,存档问题解释",
    "image": "https://example.com/path",
    "read_num": "1.9w",
    "time": "2019-07-20",
    "url": "/gonglue/20160429/1709799.html"
    },
    {
    "title": "我的世界 分享一些有趣知识",
    "image": "https://example.com/path",
    "read_num": "1800",
    "time": "2019-07-20",
    "url": "/gonglue/20160504/1713831.html"
    }
    ],
    "update_time": "2019-09-20"
    },
    {
    "category_name": "指令教程",
    "item_list": [
    {
    "title": "string",
    "image": "https://example.com/path",
    "read_num": "2016-5-10",
    "time": "string",
    "url": "string"
    }
    ],
    "update_time": "string"
    }
    ]
    }
    }