广告类型详解

📋 广告请求与展示流程

📋 请求广告类型说明

提示

支持的广告请求类型可能会改变，请访问广告类型详解或使用获取广告类型接口API来了解更详细的广告类型信息！

📝 1 - 文本广告

🎯 使用场景： 纯文本形式的广告展示
⏰ 展示时长： 无限制
📐 推荐格式： 纯文本，支持基础HTML标签

返回字段：

字段名	类型	说明	示例
标题	string	广告标题	"软件分享标题1"
内容	string	广告描述	"这是一个优质的软件推荐"
跳转链接	string	点击跳转链接	"https://example.com/target"

🖼️ 2 - 图片广告

🎯 使用场景： 包含图片的广告展示
⏰ 展示时长： 无限制
📐 推荐尺寸： 横版16:9，竖版9:16

返回字段：

字段名	类型	说明	示例
标题	string	广告标题	"软件分享标题1"
内容	string	广告描述	"这是一个优质的软件推荐"
跳转链接	string	点击跳转链接	"https://example.com/target"
广告图横版	string	横版图片URL	"http://127.0.0.3/uploads/horizontal_image.png"
广告图竖版	string	竖版图片URL	"http://127.0.0.3/uploads/vertical_image.png"

👀 3 - 图片浏览广告

🎯 使用场景： 需要浏览一定时长的图片广告
⏰ 展示时长： 有最低浏览时长要求
📐 推荐尺寸： 横版16:9，竖版9:16

返回字段：

字段名	类型	说明	示例
标题	string	广告标题	"软件分享标题1"
内容	string	广告描述	"这是一个优质的软件推荐"
跳转链接	string	点击跳转链接	"https://example.com/target"
广告图横版	string	横版图片URL	"http://127.0.0.3/uploads/horizontal_image.png"
广告图竖版	string	竖版图片URL	"http://127.0.0.3/uploads/vertical_image.png"
最低浏览时长	int	最少浏览时长(秒)	5

🎬 4 - 视频广告

🎯 使用场景： 视频形式的广告展示
⏰ 展示时长： 有最低观看时长要求
📐 推荐格式： MP4，H.264编码

返回字段：

字段名	类型	说明	示例
标题	string	广告标题	"软件分享标题1"
内容	string	广告描述	"这是一个优质的软件推荐"
跳转链接	string	点击跳转链接	"https://example.com/target"
广告图横版	string	横版图片URL	"http://127.0.0.3/uploads/horizontal_image.png"
广告图竖版	string	竖版图片URL	"http://127.0.0.3/uploads/vertical_image.png"
视频链接	string	视频文件URL	"http://127.0.0.3/uploads/video.mp4"
视频最低观看时长	int	最少观看时长(秒)	5
视频总时长	int	视频总时长(秒)	30

📱 5 - 摇一摇广告

🎯 使用场景： 通过摇一摇触发的广告
⏰ 展示时长： 无时长检查
📐 推荐格式： 支持图片和视频

返回字段：

字段名	类型	说明	示例
标题	string	广告标题	"软件分享标题1"
内容	string	广告描述	"这是一个优质的软件推荐"
跳转链接	string	点击跳转链接	"https://example.com/target"
广告图横版	string	横版图片URL	"http://127.0.0.3/uploads/horizontal_image.png"
广告图竖版	string	竖版图片URL	"http://127.0.0.3/uploads/vertical_image.png"
视频链接	string	视频文件URL	"http://127.0.0.3/uploads/video.mp4"
最低浏览时长	int	最少浏览时长(秒)	3
视频最低观看时长	int	最少观看时长(秒)	5
视频总时长	int	视频总时长(秒)	30

📋 返回字段说明

1 - 基础字段

字段名	类型	说明	示例
eid	string	上报ID，用于广告上报	"ad_689c209bd210f0.59912595"
adid	string	广告ID，唯一标识	"63"
title	string	广告标题	"软件分享标题1"
content	string	广告描述内容	"这是一个优质的软件推荐"
aurl	string	广告跳转链接	"https://example.com/"

2 - 媒体字段

字段名	类型	说明	适用类型
vd	string	竖版图片URL	开屏、插屏
td	string	横版图片URL	插屏、横幅
icon	string	广告图标URL	插屏、横幅
video	string	视频文件URL	视频广告

3 - 时长字段

字段名	类型	说明	单位
videoti	int	视频总时长	秒
sp_viewti	int	视频最少观看时长	秒
ab_viewti	int	图片广告最少浏览时长	秒

❌ 错误码对照表

错误码	类型	说明	解决方案
1000	成功	操作成功	-
-1001	验证失败	Token验证失败或参数错误	检查appid、appkey、时间戳
-1002	无广告	暂无匹配的广告或重复上报	稍后重试或检查上报状态
-1003	时长不足	广告观看时长不足	确保满足最低观看时长
-1004	频率限制	请求频率过高	降低请求频率，建议间隔3秒
-1005	时间过期	时间戳过期	同步系统时间
-1006	权限不足	项目状态异常或余额不足	联系管理员检查项目状态

📋 广告请求与展示流程#

📋 请求广告类型说明#

📝 1 - 文本广告#

🖼️ 2 - 图片广告#

👀 3 - 图片浏览广告#

🎬 4 - 视频广告#

📱 5 - 摇一摇广告#

📋 返回字段说明#

1 - 基础字段#

2 - 媒体字段#

3 - 时长字段#

❌ 错误码对照表#

最佳错误处理#

📋 广告请求与展示流程

📋 请求广告类型说明

📝 1 - 文本广告

🖼️ 2 - 图片广告

👀 3 - 图片浏览广告

🎬 4 - 视频广告

📱 5 - 摇一摇广告

📋 返回字段说明

1 - 基础字段

2 - 媒体字段

3 - 时长字段

❌ 错误码对照表

最佳错误处理