演出门票

用户在搜索演出门票时，搜索会展现“演出门票“卡片，提供具体演出信息及购票入口，满足用户的需求。

示意图

intent 上传接口

当前资源 intent 意图参数

通过平台上传 txt 文件

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

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

1
2
3

{"city":"杭州","play":"周杰伦演唱会"}
{"city":"","play":"2018草莓音乐节"}
{"city":"","play":"德云社相声"}

通过开放 API 上传

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

Webhook API

发送给 webhook 的请求

公共字段

当前资源 srcid 资源编号

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

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

1
2
3
4
5
6
7
8
9

{
  "type": "sp_ala",
  "srcid": "5515",
  "surface": "mobile",
  "intent": {
	   "city":"",
	   "play":"德云社相声"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

举例：从 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

{
	"status": 0,
	"msg": "",
	"data": {
		"item_list": [{
				"url": "/path/to/page",
				"title": "杭州草莓音乐节",
				"address": "杭州市余杭区xx",
				"image": "https://example.com/img.jpg",
				"time": "2019-2-15",
				"price_cent": "5000",
				"button_text": "购票",
				"button_url": "/path/to/page",
				"labels": ["套餐优惠", "惠"]
			},
			{
				"url": "/path/to/page",
				"title": "杭州草莓音乐节",
				"address": "杭州市余杭区xx",
				"image": "https://example.com/img.jpg",
				"time": "2019-2-15",
				"price_cent": "5000",
				"button_text": "购票",
				"button_url": "/path/to/page",
				"labels": ["套餐优惠", "惠"]
			}
		],
		"jump_url": "/path/to/page"
	}
}

审核常见问题

intent的编写

演出门票的intent应该是开发者能提供购票服务的演出名称，电影票、有演出的景点门票均不算演出门票。开发者可以对intent进行适当泛化，但必须在演出门票购票的服务范围内。常见问题如下：

• intent必须与演出门票类目不相关

• 开发者对intent泛化逾越边界

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

1
2
3

{"city":"","play":"相声"}
{"city":"北京","play":"音乐会"}
{"city":"厦门","play":"演唱会"}

卡片内容与intent不相关

演出门票类目下卡片内容必须与intent高度相关，能满足intent体现的用户主需求。当intent体现用户的精确需求，卡片提供的购票服务也必须精确。举例如下：

注意：建议开发者对intent进行泛化。例如，本次周杰伦在上海、长沙、杭州三个城市开演唱，开发者应提intent及其对应的结果如下：*

演出门票待售、预售或售罄/缺货

演出门票在待售、预售或者售罄/缺货状态，必须在卡片标签”labels”中有体现，如待开售、预售、售罄、待补货等。若落地页中也有标签，则要求卡片展现标签与落地页标签一致或含义相同，例如不允许卡片展现待补货，落地页展现售罄。

所有演出门票类目卡片必须在演出结束当晚24点前下线。例如，某场演唱会在8月10日，该演出门票卡片必须在8月10日晚24点下线。