电影票购买

用户在搜索”攀登者”购票精准需求以及”电影购票”购票泛需求时，搜索会展现电影票购买卡片，提供电影详情信息，比如类型、演员、上映时间等，并同时满足用户的服务需求。

示意图

电影票购买 - 图1电影票购买 - 图2

intent 上传接口

当前资源 intent 意图参数

key类型含义示例/说明
movie_namestring电影影片名“罗小黑战记””攀登者”

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

当前资源分类 txt 上传文件内容示例如下：

  1. {"movie_name":"罗小黑战记"}
    {"movie_name":"攀登者"}

电影票购买 - 图3

通过开放 API 上传

未开放

Webhook API

发送给 webhook 的请求

公共字段

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

当前资源 srcid 资源编号

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

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

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

  1. {
      "type": "sp_ala",
      "srcid": "5548",
      "surface": "mobile",
      "intent": {
        "movie_name": "罗小黑战记"
      }
    }

从 webhook 返回的结果

外层通用数据字段

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

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

key类型要求说明
jump_urlstring必选卡片标题的跳转链接「购票泛需求跳转至影片列表页，精准购票需求跳转至电影详情页 」
item_listarray必选电影购票列表「购票泛需求 3 条数据，精准购票需求 1 条数据」
item_list.titlestring必选电影影片名
item_list.timestring必选上映时间，格式：年-月-日
item_list.categorystring必选影片类别，数量 1-3 个
item_list.actorsstring必选演员，按演员列表进行排列
item_list.imagestring必选影片海报，以影片官方海报图为主，分辨率要高于 364*486px，比例长：宽=4:3
item_list.extra_tipsarray必选影片信息字段数组，若该影片已上映，为该影片所获评分+该影片评论数量，评分默认保留小数点后一位，评论数量默认保留整数，例如：【9.6 分】【700 人已评价】；若影片为待上映电影，则上传想看人数的数据，默认保留小数点后一位，例如【9.6w 人想看】
item_list.button_textstring必选按钮的文案，默认为【购票】；若影片为待上映电影，则改为【预售】
item_list.button_urlstring必选按钮跳转链接，跳转到对应的电影票购票页面
item_list.labelsarray可选，若选不可为空影片标签数组，为描述该影片的字段，可为“满 50 减 6”“19.9 元起”等，资源方可自定，写清具体优惠多少
activity_textstringactivity 运营区域整体可选，选后不可为空电影运营位文案，20 个字以内
activity_labelstringactivity 运营区域整体可选，选后不可为空电影运营位标签，标签只能有 1 个，1-3 个字
activity_urlstringactivity 运营区域整体可选，选后不可为空电影运营位标签跳转路径

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

  1. {
      "status": 0,
      "msg": "",
      "data": {
        "item_list": [
          {
            "url": "/path/to/page",
            "title": "蜘蛛侠",
            "time": "2019-2-15",
            "category": "动作 | 冒险",
            "actors": "汤姆克鲁斯 | 刘德华",
            "image": "https://example.com/img.jpg",
            "extra_tips": ["7.5分", "700人已评价"],
            "button_text": "购票",
            "button_url": "/path/to/page",
            "labels": ["满50减6", "19.9元起"]
          },
          {
            "url": "/path/to/page",
            "title": "蜘蛛侠",
            "time": "2019-2-15",
            "category": "动作 | 冒险",
            "actors": "汤姆克鲁斯 | 刘德华",
            "image": "https://example.com/img.jpg",
            "extra_tips": ["1.2w人想看"],
            "button_text": "购票",
            "button_url": "/path/to/page",
            "labels": ["满50减6", "19.9元起"]
          }
        ],
        "jump_url": "/path/to/page",
        "activity_text": "观影通券，满50减6，带上朋友一起来观影吧！",
        "activity_label": "惠",
        "activity_url": "page/of/target"
      }
    }

审核常见问题

intent 的编写

需额外提交一个空的 intent，例如{“movie_name”:””}，以方便泛需求类目词的召回，如”q=电影购票”。

卡片内容的真实性

  • 卡片展示影片若为正在热映影片，button 应显示购票；若为即将上映影片，button 应为预售；
  • 卡片展示影片若为即将上映影片，不应有评分、评价等不符合客观事实的信息；
  • 卡片展示出【特惠】标签不能为吸引用户点击的虚假信息，必须有优惠票价与之对应；
  • 卡片展示的主演、上映时间等信息必须准确。

落地页质量

点击卡片进入小程序落地页，应调用定位功能定位出附近影院，不能出现定位错误的情况，尤其不能出现定位至其他城市的情况。