一、基础说明

1.适用范围

本文档适用于渠道对接AdPower平台，通过API接口获取应用列表。

二、接口约定

1.对接方式：

渠道-->请求API接口返回JSON

2.请求方式：

请求协议：HTTPS

请求方法： GET / POST

3.数据格式：

GET请求参数拼接在URL上，POST请求参数form-data格式。

响应数据均为JSON数据格式，为避免引起类型解析错误，数据值均为字符串类型。

4.注意事项：

确保您收到的所有广告在您的请求时间内都有效，我们可能随时下架广告。为了最大限度地减少下架广告的无效点击，我们建议您每15分钟-30分钟请求一次，下架的广告将无法访问。

短时间内请求过多可能会导致https响应代码429（请求过多），重新请求秒数在“Retry-After”响应标头中提供。

三、接口说明

1.API接口

https://api.adpower.cn/v1/offline?app_id=c46b362886e42385d30c83d76abc3c51&page_size=20&os=android&country=IN&payout_type=CPI

2.请求参数：

参数 类型 必须 描述
app_id string 是 应用密钥，从AdPower平台获取
page_size int 否 定义每页广告数量
event string 否 筛选广告类型: CPA / CPI / CPL
os string 否 筛选广告系统类型: Android / IOS
country string 否 筛选广告国家
offer_ids string 否 筛选广告价格，使用 , 分隔多个价格

3.回传参数说明：

参数 类型 描述
id string 广告ID
name string 广告名称
icon_url string 广告图标链接
package string 广告应用包名
ask_description_for_user string 广告描述
kpi string 广告kpi描述
payout double 广告总价，以美元计价
countries array 广告目标国家
os array 广告目标系统: android / ios
payout_type string 广告结算类型: CPA / CPI / CPL
category string 广告分类（例如：Casual，Education）
ad_type string 广告类型（例如：APK，Web）
trackingLink string 广告追踪链接
events array 广告事件，包括事件名称，事件描述，事件单价（以美元计价）

4.回传参数说明

GET http://api.adpower.cn/v2/offline?app_id=adfb362896e42565d30c44d76ghc3c55&page=1&page_size=20&os=android&country=IN&payout_type=CPI

5.跟踪参数说明

参数 类型 描述
clickid string 用于唯一标识一次点击（最多256个）
gps_adid string 用户的 Google 广告 ID (GAID)，必填项
android_id string 用户的android_id
model string 用户的设备型号
os_version string 用户的系统版本
aff_sub string 对于您的自定义参数（最多 256 个）
aff_sub2 string 对于您的自定义参数（最多 256 个）
ua string 不要添加 CFNetwork 用户代理，提取另一个（URL 编码）
ip string 用户的IP

注意：未提供必需的设备参数会导致无效点击。我们会截断较长的参数，因此请遵守最大长度要求。

6.结算回传协议

通常，我们会在转换发生时立即发送回调。但是，在服务器故障、转换确认延迟等罕见情况下，预计回调会延迟（最多 7 天）。我们通过 HTTP GET 方法发送回调请求，在请求失败时重试（HTTP 响应代码 5XX）。可能存在与同一转换相关的多个回调，因此接收方有责任确保回调端点是幂等的。

结算回传协议

在Adpower后台-修改应用-设置回传接口。

API合作结算回传参数

参数 必须 描述
{aff_sub} 是 用于唯一标识一次点击
{event_name} 是 只有广告主回调事件名时，回传才会带上事件名
{payout} 是 结算金额（美元）
{is_settle} 是 若是结算事件is_settle=1，若是非结算事件is_settle=0
{gaid} 否 用户的 Google 广告 ID (GAID)
{aff_sub2} 否 自定义参数
{aff_sub3} 否 自定义参数