1、注意事项
1.1 动参设置注意事项
- 1、texts的title、description，支持动参，总体长度根据示例有参考；
- 2、红包的texts的name，支持动参，总体长度不能超过12；
- 3、所有的action的url，支持动参，总体长度不能超过1000；
- 4、button的content，支持动参，总体长度不能超过5；
- 5、所有兜底地址back_url，不支持动参；
1.2 buttons设置注意事项
- 1、单图文、多图文、视频、轮播、红包，buttons设置在外层；
- 2、横划，buttons设置在images中，可以看参考示例； |
1.3 个别参数说明注意事项
2、模板内容字段属性定义
texts——文本
| 字段 | 说明 |
|---|
| title | 标题 |
| description | 描述 |
| action | 点击动作 |
| number | 媒体（图片、视频）对象编号——顺序，从1开始递增 |
| name | 名称 |
action——动作
| 字段 | 说明 |
|---|
| url | 跳转地址 |
| type | 1 H5跳转 2 快应用跳转 3 app跳转 9 打开浏览器 |
| back_url | 备用地址，如果url失败时使用 |
| package_name | 应用名称，如果跳转类型为应用 |
| jump_title | 商户名称（用于跳转时提示“正在跳转到 xxx(商户名称） |
| monitor_tink_click | 监控链接 vivo独有 |
| attr | 扩展属性，支持厂商自定义扩展 |
images——图片
| 字段 | 说明 |
|---|
| material_id | 内部素材ID |
| src | 图片地址 |
| action | 动作 |
| main_img | 是否主图片，多图文卡片需要该标识 |
| image_attrs | 扩展属性 |
| buttons | 按钮列表 |
| number | 媒体（图片、视频）对象编号——顺序，从1开始 |
videos——视频
| 字段 | 说明 |
|---|
| material_id | 内部素材ID |
| action | 动作 |
| video_url | 视频链接 |
| cover_image_url | 封面图片链接 |
| cover_material_id | 缩略图 资源id |
| video_attrs | 扩展属性 |
| number | 媒体（图片、视频）对象编号——顺序 |
buttons——按钮
| 字段 | 说明 |
|---|
| content | 按钮文本 |
| action | 动作 |
| button_attrs | 扩展属性 |
imageRatio——比例
3、模板内容格式参考示例
3.1、单图文模板（template_type=1）
注意事项
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": true,
"materialId": "202604111543337698655601664",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/d744c69c-8f1d-4c8b-b905-1702a176897f.jpeg",
"width": 1280
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 0,
"title": "字符长度<=17,您已超出3长度"
}
],
"videos": [
]
}
3.2、多图文模板（template_type=2）
注意事项
{
"attrs": {
},
"buttons": [
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": true,
"materialId": "202604111628193408655994880",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/a4dde25e-167c-40a1-9957-795e81b5fd15.jpeg",
"width": 1280
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111628243818655470592",
"number": 1,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/0466c95a-5ea7-4915-8349-f5fb40142a3d.jpeg",
"width": 1648
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111628296528655470592",
"number": 2,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/e5738f03-aca4-45fb-8e58-295dde14beef.jpeg",
"width": 1648
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111628340608655470592",
"number": 3,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/a159fea3-ffad-4efa-9320-3d7f8522d571.jpeg",
"width": 1648
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入标题,最多30个字",
"number": 0,
"title": "请输入标题,最多30个字"
},
{
"description": "请输入描述文案,最多30个字（包含标点及空格）",
"number": 1,
"title": "请输入描述文案,最多30个字（包含标点及空格）"
},
{
"description": "请输入描述文案,最多30个字（包含标点及空格）",
"number": 2,
"title": "请输入描述文案,最多30个字（包含标点及空格）"
},
{
"description": "请输入描述文案,最多30个字（包含标点及空格）",
"number": 3,
"title": "请输入描述文案,最多30个字（包含标点及空格）"
}
],
"videos": [
]
}
3.3、横划模板（template_type=3）
注意事项
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "按钮名称不能为空"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "按钮名称不能为空"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "按钮名称不能为空"
}
],
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111632034958655994880",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/5c1075c4-b09d-466a-918e-02e9d9ff9044.jpeg",
"width": 1648
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "按钮名称不能为空"
}
],
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111632078168655863808",
"number": 1,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/33e52dc7-1220-4167-92a9-2e4c50b47cad.jpeg",
"width": 1648
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多30个字（包含标点及空格）",
"number": 0,
"title": "请输入标题,最多13个字"
},
{
"description": "请输入描述文案,最多30个字（包含标点及空格）",
"number": 1,
"title": "请输入标题,最多13个字"
}
],
"videos": [
]
}
3.4、视频模板（template_type=4）
注意事项
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 0,
"title": "请输入标题,最多17个字"
}
],
"videos": [
{
"coverImageUrl": "https://static.chuanglan.com/yunge/console/64078/20260411/image/1c23c4f1-59ed-4f3f-beb4-926e3646b55e.jpeg",
"coverMaterialId": "202604111636591228655601664",
"imageFileSize": "115567",
"imageFileType": "image/jpeg",
"imageHeight": 720,
"imageRate": "sixteenToNine",
"imageWidth": 1280,
"materialId": "202504271730139528650883072",
"number": 0,
"videoFileSize": "2693435",
"videoFileType": "video/mp4",
"videoUrl": "https://static.chuanglan.com/yunge/console/64078/20250427/video/bb9b972a-3639-4196-b191-008aaaea84f0.mp4"
}
]
}
3.5、轮播模板（template_type=5）
注意事项
- 1、轮播图片设置比例：1:1、16:9、48:65，支持格式jpg、png、jpeg，一个模板只支持一种比例；
{
"attrs": {
"imageRatio": "2"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": false,
"materialId": "202604111639196478655863808",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/2735be43-3417-4e57-b498-04a898fe53e9.jpeg",
"width": 1280
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": false,
"materialId": "202604111639244768655863808",
"number": 1,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/4488cc9a-4eb5-4401-96c2-297f8acd4324.jpeg",
"width": 1280
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": false,
"materialId": "202604111639291298655470592",
"number": 2,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/28535c47-9829-4956-91fd-b644b27f75af.jpeg",
"width": 1280
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "115567",
"fileType": "image/jpeg",
"height": 720,
"imageRate": "sixteenToNine",
"mainImg": false,
"materialId": "202604111639333778655994880",
"number": 3,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/98c54991-83e6-4644-aee2-c854de32d1a3.jpeg",
"width": 1280
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多253个字（包含标点及空格）",
"number": 0,
"title": "请输入标题,最多17个字"
}
],
"videos": [
]
}
3.6、红包模板（template_type=6）
注意事项
- 1、红包图片设置比例：1:1，支持格式jpg、png、jpeg，一个模板只支持一种比例；
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"buttonType": "static",
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": true,
"materialId": "202604111643185868655470592",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/19683f8e-2b30-4bb8-8c4b-cd0f09d4e4b8.jpeg",
"width": 1648
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多54个字（包含标点及空格）",
"name": "名称最多12个字",
"number": 0,
"title": "标题最多11个字"
}
],
"videos": [
]
}
3.7、一般通知模板（template_type=10）
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "133459",
"fileType": "image/jpeg",
"height": 426,
"imageRate": "threeToOne",
"mainImg": true,
"materialId": "202604111646203418655863808",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/8d67a055-74f0-47ed-9d5d-1c6b6e3e4333.jpeg",
"width": 1278
}
],
"paramTexts": [
{
"content": "编辑内容，最多24个字",
"isMaster": false,
"name": "长度<=6",
"sort": 0
},
{
"content": "最多24个字",
"isMaster": false,
"name": "最多6个字",
"sort": 1
}
],
"texts": [
{
"description": "请输入描述文案,最多20个字",
"number": 0,
"title": "标题最多12个字"
}
],
"videos": [
]
}
3.8、增强通知模板（template_type=11）
{
"attrs": {
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "133459",
"fileType": "image/jpeg",
"height": 426,
"imageRate": "threeToOne",
"mainImg": true,
"materialId": "202604111648469268655470592",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/920f6110-d144-4815-aa39-6a76463092f9.jpeg",
"width": 1278
}
],
"paramTexts": [
{
"content": "最多6个字",
"isMaster": true,
"name": "最多6个字",
"sort": 0
},
{
"content": "编辑内容，最多24个字",
"isMaster": false,
"name": "最多6个字",
"sort": 1
},
{
"content": "编辑内容，最多24个字",
"isMaster": false,
"name": "最多6个字",
"sort": 2
}
],
"texts": [
{
"description": "最多20个字",
"number": 0,
"title": "最多12个字"
}
],
"videos": [
]
}
3.9、电商图文模板（template_type=12）
规格要求
| 字段 | 说明 |
|---|
| 图片 | 比例：1:1，数量：1-8张，超过4张时，提示vivo只传前4张的图片和配置。尺寸不小于1088px*1088px，支持点击行为 |
| 视频 | 【封面】：比例要求 1:1，支持jpg,png,jpeg格式，【视频】：比例要求 : 1:1，支持mp4格式。不支持点击行为 |
| 主标签 | 最多8个字，“¥”可以选择是否显示 |
| 副标签 | 最多12个字。支持动参 |
| 标题 | 最多17个字，支持动参 |
| 描述 | 最多69个字，支持动参 |
| 按钮 | 5个字以内，数量1-2个 |
注意事项
- 1、图片比例1:1，支持jpg,png,jpeg
- 2、按钮1-2个，最大5个字，轮播图片1-8张(vivo:1-4)，主副标签、标题和描述文案各一个，一个￥/$ 符号显示
- 3、￥/$（不传默认不显示，有￥和 $，但是目前只提供￥，1为显示，2为不显示，具体看模板内容）
{
"attrs": {
"currencyType": "￥",
"currencyDisplay": "1"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111651464208655994880",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/d1965401-1f44-46bc-a377-579c293aeb6a.jpeg",
"width": 1648
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": false,
"materialId": "202604111651590018655863808",
"number": 1,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/e878c3ef-8bf7-4af6-8f15-0361b02ed915.jpeg",
"width": 1648
}
],
"paramTexts": [
],
"texts": [
{
"description": "描述文案最多12个字",
"number": 0,
"textType": "1",
"title": "标题最多8个字"
},
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 1,
"title": "请输入标题,最多17个字"
}
],
"videos": [
]
}
3.10、电商视频模板（template_type=13）
注意事项
- 1、封面比例1:1，支持jpg,png,jpeg；视频比例1:1，支持mp4
- 2、按钮1-2个，最大5个字，视频一个，主副标签、标题和描述文案各一个，一个￥/$ 符号显示
- 3、￥（不传默认不显示，有￥和 $，但是目前只提供￥，1为显示，2为不显示，具体看模板内容）
{
"attrs": {
"currencyType": "￥",
"currencyDisplay": "1"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
],
"paramTexts": [
],
"texts": [
{
"description": "描述文案最多12个字",
"number": 0,
"textType": "1",
"title": "标题最多8个字"
},
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 1,
"title": "请输入标题,最多17个字"
}
],
"videos": [
{
"coverImageUrl": "https://static.chuanglan.com/yunge/console/64078/20260411/image/9f79a949-cf5b-4cda-8b41-fb019d54d0e6.jpeg",
"coverMaterialId": "202604111654359948655994880",
"imageFileSize": "101638",
"imageFileType": "image/jpeg",
"imageHeight": 1648,
"imageRate": "oneToOne",
"imageWidth": 1648,
"materialId": "202504242242270818650883072",
"number": 0,
"videoFileSize": "2081855",
"videoFileType": "video/mp4",
"videoUrl": "https://static.chuanglan.com/yunge/console/64078/20250424/video/a648aaf3-991d-419d-8b59-3c1f59f98c9e.mp4"
}
]
}
3.11、短剧图文模板（template_type=14）
注意事项
- 1、图片支持比例：1:1、3:4，支持格式jpg、png、jpeg，一个模板只支持一种比例；
{
"attrs": {
"imageRatio": "1"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"fileSize": "101638",
"fileType": "image/jpeg",
"height": 1648,
"imageRate": "oneToOne",
"mainImg": true,
"materialId": "202604111659597468655863808",
"number": 0,
"src": "https://static.chuanglan.com/yunge/console/64078/20260411/image/43b355d1-12a5-4c32-9cae-770573393bed.jpeg",
"width": 1648
}
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 0,
"title": "请输入标题,最多17个字"
}
],
"videos": [
]
}
3.12、短剧视频模板（template_type=15）
注意事项
- 1、视频支持比例：1:1、3:4，支持格式jpg、png、jpeg，一个模板只支持一种比例；
{
"attrs": {
"imageRatio": "1"
},
"buttons": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
},
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"content": "点击查看"
}
],
"images": [
],
"paramTexts": [
],
"texts": [
{
"description": "请输入描述文案,最多69个字（包含标点及空格）",
"number": 0,
"title": "请输入标题,最多17个字"
}
],
"videos": [
{
"action": {
"jumpTitle": "目标地址，精彩即将呈现",
"mode": 0,
"type": "9",
"url": "https://www.chuanglan.com"
},
"coverImageUrl": "https://static.chuanglan.com/yunge/console/64078/20260411/image/364a8b9c-0f77-4c9e-9f81-fa8ba88f3a57.jpeg",
"coverMaterialId": "202604111702010268655994880",
"imageFileSize": "101638",
"imageFileType": "image/jpeg",
"imageHeight": 1648,
"imageRate": "oneToOne",
"imageWidth": 1648,
"materialId": "202504271730217608651014144",
"videoFileSize": "2693435",
"videoFileType": "video/mp4",
"videoUrl": "https://static.chuanglan.com/yunge/console/64078/20250427/video/5eb77c3d-3301-40ac-9a81-abbc1103bdfd.mp4"
}
]
}
没有更多了
