智能小程序OPENCARD
开放类目

电影票购买

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

示意图

intent 上传接口

当前资源 intent 意图参数

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

通过平台上传 txt 文件

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

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

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

注意：为了能够召回泛需求如“电影票购买”，需要额外上传一个空的 intent，{“movie_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 资源编号 5548

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

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

1
2
3
4
5
6
7
8
{
  "type": "sp_ala",
  "srcid": "5548",
  "surface": "mobile",
  "intent": {
    "movie_name": "罗小黑战记"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
  "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 应为预售；
  • 卡片展示影片若为即将上映影片，不应有评分、评价等不符合客观事实的信息；
  • 卡片展示出【特惠】标签不能为吸引用户点击的虚假信息，必须有优惠票价与之对应；
  • 卡片展示的主演、上映时间等信息必须准确。

落地页质量

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

实时票房 影评
反 馈帮 助 回 到顶 部