三方广告播放上报

sidebar_position: 3

三方广告播放上报接口

接口地址 (三方广告播放上报)

http://third.ad.akrdinfo.cn:30133/app-api/launcher/ad/play/callback/v2 > ### 播放完成后需要立即上报，上报失败需重试。
> 如果某条数据时接口没有返回成功状态了（即服务端返回的code!=200），设备需要间隔一段时间再上报。
间隔策略5分钟，30分钟，100分钟，300分钟。1天、3天、5天，10天，20天，如果如此间隔还是不成功则删除本地缓存。该条数据不再继续上报。
如果服务器接口返回的不是json，大概率是网络故障无法连接上服务器了，这时候需要设备自行处理，但是也是建议延迟1小时以上再重试

请求参数说明 (三方广告播放上报)

mac: mac地址
cpu: 设备cpu信息,cpuid，取不到传null
createTime：设备时间上报时间
indexPlayInfos: 广告播放信息列表
indexPlayInfos[*].playDuration: 播放时长，单位为秒
indexPlayInfos[*].packageName: app包名
indexPlayInfos[*].versionCode: app版本号
indexPlayInfos[*].dateTime: 广告播放开始时间（13位时间戳）
indexPlayInfos[*].adIndexId: 广告位索引，取值范围10000-10100,用于唯一标识一个广告位或者广告类型之类的，含义可接入端自己定义，但需告知我们进行配置

请求示例 (三方广告播放上报)

{
  "mac": "2C:00:D3:66:66:31",
  "cpu": "1111",
  "createTime": "1760066867146",
  "indexPlayInfos": [
    {
      "playDuration": 0,
      "playCount": 15,
      "packageName": "com.gzsuy.ad008",
      "versionCode": 2334,
      "dateTime": "1760066867146",
      "adIndexId": 10000
    }
  ]
}

成功返回示例 (三方广告播放上报)

{
  "code": 200,
  "data": true,
  "msg": "Submitted successfully"
}

失败返回示例 (三方广告播放上报)

json的code!=200<br /> 也有可能返回其它非json格式，网络不通、后台服务Nginx网关转发失败时http_statsu=50x、http_status=40x

{
  "code": 400,
  "data": null,
  "msg": "请求参数类型错误:17600668SD67146"
}

{
  "code": 500,
  "data": null,
  "msg": "data in wrong format"
}

请求参数实体类定义 (三方广告播放上报)

import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.Date;
import java.util.List;

@Data
public class LauncherAdPlayKafkaDTO implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;
    /**
     * mac地址
     */
    private String mac;
    /**
     * cpu
     */
    private String cpu;
    /**
     * 设备端该条数据创建的时间
     */
    private Date createTime;
    List&lt;IndexPlayInfo> indexPlayInfos;

    @Data
    public static class IndexPlayInfo  implements Serializable {
        @Serial
        private static final long serialVersionUID = 1L;
        /**
         * 播放时长;秒
         */
        private int playDuration;
        /**
         * 包名
         */
        private String packageName;
        /**
         * 版本号
         */
        private Long versionCode;
        /**
         * 广告播放开始时间（日期，13位时间戳）
         */
        private Date dateTime;
        /**
         *  原则上是广告位索引
         *  这里取值范围10000-10100,用于唯一标识一个广告位或者广告类型之类的，含义可接入段自己定义，但需告知我们进行配置
         * 枚举 {@link TODO launcherAdIndex 对应的类}
         */
        private Integer adIndexId;
    }
}

sidebar_position: 3​

三方广告播放上报接口

接口地址 (三方广告播放上报)​

请求参数说明 (三方广告播放上报)​

请求示例 (三方广告播放上报)​

成功返回示例 (三方广告播放上报)​

失败返回示例 (三方广告播放上报)​

请求参数实体类定义 (三方广告播放上报)​