广告上报接口

⏱️ 接口信息

功能： 上报广告展示和点击数据，用于统计分析

Content-Type：application/json(POST)或application/x-www-form-urlencoded(GET)

接口地址： api/ad_report.php

📝 请求参数

参数名	类型	必填	格式	说明
appid	string	✅	16位字符串	项目标识，与请求时一致
adid	string	✅	数字字符串	广告ID，来自请求响应
eid	string	✅	唯一标识	上报ID，来自请求响应
etoken	string	✅	32位MD5	上报令牌，计算方式见下方
ukey	string	✅	-	用户密钥，在用户资料页面设置
type	string	❌	0-3	广告类型，与请求时一致（可选）
view_time	int	❌	正整数	广告观看时长(秒)

警告

请记住，您的API访问令牌是机密信息！ 将您的访问令牌视为密码类似的敏感凭据，采取相同的保护措施。

不要与他人分享它，也不要在任何客户端代码（浏览器、应用程序）中公开它。如果请求必须通过您自己的后端服务器，从环境变量或密钥管理服务中安全加载您的 API 访问令牌。

用户必须先在个人资料页面设置密钥才能使用API。

🔐 EToken生成规则

算法： MD5(appid + adid + eid + appkey + ukey)

提醒

用户必须先在个人资料页面设置密钥(ukey)才能使用API。

Token生成示例：

过程图解：

假设：
appid = 3f518e664c62c93d
adid = 42
eid = ad_64e9b2c7a1b3c
appkey = bf443925288cc245e3b4da8a451f8192807a23099e4c0e2c44ab74860be58bcb
ukey = a1b2c3d4e5f6g7h8i9j0

组合字符串 = 3f518e664c62c93d42ad_64e9b2c7a1b3cbf443925288cc245e3b4da8a451f8192807a23099e4c0e2c44ab74860be58bcba1b2c3d4e5f6g7h8i9j0
etoken = MD5(组合字符串) = 9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a2z1y0x

🌐 请求示例

GET请求示例：

POST请求示例：

📊 响应格式

✅ 成功响应:

{
  "error": 1000,
  "m": "上报成功",
  "status": "1",
  "data": {
    "reward_points": 10,
    "total_views": 1523
  }
}

❌ 错误响应:

{
  "error": -1003,
  "m": "视频广告播放时长不足，需要至少 5 秒，当前播放时长 2 秒",
  "status": "0"
}

⏱️ 观看时长验证

系统支持多种时长参数名：
view_time - 推荐使用

目前系统会自动判断广告观看时长验证参数，无需手动调试

viewTime - 驼峰命名（待开放）
duration - 持续时间（待开放）
playTime - 播放时间（待开放）

时长计算优先级：

客户端提供的时长参数

请求到上报的时间差（自动计算）

⚠️ 常见错误码

错误码	说明	解决方案
-1001	EToken验证失败	检查eToken计算
-1002	重复上报或广告不存在	检查eid是否有效，避免重复上报
-1003	观看时长不足	确保满足最低观看时长要求
-1004	参数格式错误	检查参数类型和必填字段
-1005	上报超时	广告已过期，请重新请求广告
-1006	用户密钥无效	检查ukey是否正确设置

更多错误码请查看错误码对照表来获取更多帮助。

⏱️ 接口信息#

📝 请求参数#

🔐 EToken生成规则#

🌐 请求示例#

📊 响应格式#

⏱️ 观看时长验证#

⚠️ 常见错误码#

⏱️ 接口信息

📝 请求参数

🔐 EToken生成规则

🌐 请求示例

📊 响应格式

⏱️ 观看时长验证

⚠️ 常见错误码