智能小程序OPENCARD
开放类目

展会门票预订

用户在搜索动漫展、美术展览等展览需求时,搜索会展现展览购票卡片,提供的门票购买信息。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
city string 展会城市 “北京”
name string 展会名称 “游戏嘉年华”
type string 展会类型 “动漫展”

当同时提供 intent.city和location.city时,优先使用 intent.city。
因为 intent 内容是从用户搜索词中直接提取的。

可组成以下4种类型:
1、展会城市+展会名称 (city+name)
eg:北京+游戏嘉年华

2、展会城市+展会类型(city+type)
eg:北京+动漫展

3、展会名称(name)
eg:游戏嘉年华

4、展会类型(type)
eg:动漫展会

通过平台上传 txt 文件

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

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

1
2
3
4
{"city":"北京","name":"动漫游戏嘉年华","type":""}
{"city":"北京","name":"","type":"动漫展"}
{"city":"","name":"游戏嘉年华","type":""}
{"city":"","name":"","type":"漫展"}

通过开放 API 上传

详细接入方式参见 API上传方式

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象,每个资源分类不同
location object 用户定位信息 JSON 对象
location.province string 用户所在省份 “山东”/“浙江”,不含行政区划单位,例如”市、省、自治区”,可能为空
location.city string 用户所在城市 “北京”/“杭州”,不含行政区划单位,例如”市”,可能为空

当前资源 srcid 资源编号

key 类型 含义 设定
srcid string 资源编号 48008

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

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

注:以下发送的参数中location对象中的具体字段可能是空字符,开发者需要注意兼容,当为空时开发者可以根据具体情况返回默认值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"type": "sp_ala",
"srcid": "48008",
"surface": "mobile",
"intent": {
"city":"",
"name":"动漫展",
"type":""
},
"location": {
"province":"浙江",
"city": "杭州"
}
}

从 webhook 返回的结果

外层通用数据字段

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

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

key 类型 要求 说明
jump_url string 必选 jump_url的说明:卡片标题的跳转链接,若卡片展现1个演出,跳转到该展会门票的购票页;若卡片展现大于1个演出,跳转到展会列表页
item_list array 必选 展会列表,最少1个,最多3个
item_list.title string 必选 单个左图右文的标题区域,超过两行截断
item_list.image string 必选 单个展会的图片,分辨率要高于364*486px,比例长:宽=4:3
item_list.time string 必选 展会持续时间,例如2019年4月16日-2019年4月30日
item_list.address string 必选 地址,如”北京国家会展中心”
item_list.labels array 可选 标签组,字符串数组,最多3个,每个标签不超过5个字
item_list.price integer 必选 展会门票价格,默认单位是分,例如:4000,代表40元
item_list.url string 必选 单个左图右文的跳转链接,例如/page/of/target
item_list.price_info string 可选 已售信息,例如”已售3000”,可无该字段,有该字段时不可为空
item_list.button_url string 必选 按钮跳转链接,例如/page/of/target
item_list.button_text string 必选 按钮文案,例如”购买”,不超过2个字

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"status": 0,
"msg": "string",
"data": {
"jump_url": "/page/of/target",
"item_list": [{
"title": "北京第五届Another World动漫游戏嘉年华秋季游园会",
"image": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=2379086268,2130850456&fm=58",
"time": "2019年4月16日-2019年4月30日",
"address": "北京国家会展中心",
"price": "4000",
"url":"/page/of/target",
"price_info":"月售3000",
"button_url": "/page/of/target",
"button_text": "购买",
"labels": ["热销"]
}]
}
}

审核常见问题

intent的编写

展会门票预订的intent应该是开发者能提供展会门票预订服务的展会名称或展会类型。开发者可以对intent进行适当泛化,但卡片所提供的服务必须在展会门票预订服务的范围内,音乐会门票、景点门票、游乐场门票等均不算展会门票。举例如下:

intent 结论 说明
{“city”:”哈尔滨”,”name”:”哈尔滨第三届冰城国风动漫嘉年华暨西城红场周年庆典”,”type”:””} 低质 intent过于复杂,不符合用户搜索习惯
{“city”:”哈尔滨”,”name”:”动漫嘉年华”,”type”:””} 优质 符合用户搜索习惯
{“city”:”深圳”,”name”:”11.11光棍节主题演唱会”,”type”:””} 不通过 非展会门票预订服务范畴
{“city”:”贵阳”,”name”:”森田游戏体验馆”,”type”:””} 不通过 非展会门票预订服务范畴

我们非常鼓励开发者提交intent泛词来满足搜索用户的泛需求。例如:

1
2
{"city":"","name":"","type":"婚博会"}
{"city":"北京","name":"","type":"动漫展"}
反 馈帮 助 回 到顶 部