PC游戏攻略

PC游戏攻略

用户在移动端搜索 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 上传文件内容示例如下：

{"game_name":"英雄联盟"}
{"game_name":"lol"}
{"game_name":"英雄联盟云顶之奕"}
{"game_name":"云顶之奕"}

通过开放 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 (解密后)

{
  "type": "sp_ala",
  "srcid": "48014",
  "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": "我的世界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"
      }
    ]
  }
}