广告类型详解

📋 广告请求与展示流程

📋 请求广告类型说明

提示

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

1 - 开屏广告

🎯 使用场景： 应用启动时的首屏展示
⏰ 展示时长： 3-5秒，不可跳过
📐 推荐尺寸： 1080×1920 (9:16)

返回字段：

字段名	类型	说明	示例
vd	string	竖版图片URL	-
title	string	广告标题	广告标题
content	string	广告描述	这是一个优质的软件推荐
aurl	string	跳转链接	-

最佳实践：

图片加载要快，建议压缩优化

支持倒计时显示

点击区域要明确标识

2 - 插屏广告

🎯 使用场景： 应用使用过程中的间隙展示
⏰ 展示时长： 2-10秒，用户可关闭
📐 推荐尺寸： 750×1334 或 1080×1920

返回字段：

字段名	类型	说明	示例
vd	string	竖版图片URL	-
td	string	横版图片URL	-
icon	string	广告图标	-
title	string	广告标题	软件分享标题
content	string	广告描述	这是一个优质的软件推荐
aurl	string	跳转链接	-

最佳实践：

提供关闭按钮

支持横竖屏适配

避免在关键操作时弹出

3 - 横幅广告

🎯 使用场景： 页面顶部或底部固定展示
⏰ 展示时长： 持续展示
📐 推荐尺寸： 728×90 或 320×50

返回字段：

字段名	类型	说明	示例
td	string	横版图片URL	-
icon	string	广告图标	-
title	string	广告标题	软件分享标题
content	string	广告描述	这是一个优质的软件推荐
aurl	string	跳转链接	-

最佳实践：

不遮挡主要内容

支持自动轮播

提供收起功能

4 - 视频广告

🎯 使用场景： 视频内容前、中、后插播
⏰ 展示时长： 15-60秒，支持跳过
📐 推荐格式： MP4，H.264编码

返回字段：

字段名	类型	说明	示例
video	string	视频文件URL	-
vd	string	视频封面图	-
td	string	横版封面图	-
icon	string	广告图标	-
title	string	广告标题	软件分享标题
content	string	广告描述	这是一个优质的软件推荐
aurl	string	跳转链接	-
videoti	int	视频总时长(秒)	30
sp_viewti	int	最少观看时长(秒)	5

最佳实践：

提供播放控制

显示播放进度

支持音量调节

网络自适应播放

📋 返回字段说明

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 - 视频广告#

📋 返回字段说明#

1 - 基础字段#

2 - 媒体字段#

3 - 时长字段#

❌ 错误码对照表#

最佳错误处理#

📋 广告请求与展示流程

📋 请求广告类型说明

1 - 开屏广告

2 - 插屏广告

3 - 横幅广告

4 - 视频广告

📋 返回字段说明

1 - 基础字段

2 - 媒体字段

3 - 时长字段

❌ 错误码对照表

最佳错误处理