跳到主要内容

修订历史​

发布时间修订说明
2026-10-10综合报表 V3、V4 的 metric 支持 ecpm（TradPlus 统计的 eCPM）
2026-09-30综合报表 V4 的 groupBy 支持 intermediaryGroupId（中介组）。该维不返回广告平台 API 统计数据；默认组 id 为 0、名称为「所有国家」
2026-09-04广告类型附录补充互动广告（7）、插播（8）
2026-08-07报表数据查询功能新增支持查询已删除广告源相关数据
2026-03-25支持 A/B 测试报表数据查询
2025-08-11新增 TradPlus 统计数据接口: 用户价值1-90报表
2023-11-22新增 V4接口，支持 Mintegral 平台广告位返回增加 AD Unit ID
2023-02-27综合报表新增埋点收入指标 eventRevenue
2023-02-06综合报表新增维度：应用版本，渠道，SDK 版本，IDFA 授权，A/B 测试分组
2023-01-04用户 LTV 新增维度：广告位，应用版本，渠道
用户留存新增维度：应用版本，渠道
2022-12-16综合报表新增应用请求指标 appRequest
2022-10-10综合报表所有维度支持 TradPlus 统计数据、新增广告平台竞价指标
2022-02-09综合报表新增广告场景维度查询
-支持用户留存、用户价值数据查询
-支持综合报表数据查询

注意事项​

各类指标数据说明

https://docs.tradplusad.com/docs/guide/start_glossary

1. 接口校验​

1.1 协议​

HTTP

1.2 Header 公共请求参数​

需要在头部加入 Authorization: Bearer {your token}

参数说明样例
Authorizationauthorization infoBearer {your token}
curl --location --request POST 'https://openapi.tradplusad.com/v3/allreport' \
--header 'Authorization: Bearer BB86G020-ED1C-E02A-637E-BA73D9A4FF01' \
--header 'Content-Type: application/json' \
--data-raw '{
    "startDate": "2022-09-27",
    "endDate": "2022-09-27",
    "timezone": "UTC+0",
    "currency": "USD",
    "groupBy":
    [
        "date"
    ],
    "metric":
    [
        "all"
    ]
}'

token 的获取：后台“用户信息”-“我的账号”-“API Key”

2. 综合报表数据查询 API​

2.1 URL​

https://openapi.tradplusad.com/v3/allreport

2.2 请求协议​

HTTP POST HTTP Content-Type: application/json

2.3请求参数​

数据需要拉取到没有返回为止，通过 start 参数

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2020-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2020-03-02
timezoneStringN时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0";广告平台 API 数据可按时区切换查看，TradPlus 统计数据不支持时区切换，和开发者后台设置时区一致UTC+8
currencyStringN币种：不传默认 USD 仅支持 USD CNYUSD
bidTypeintN竞价类型：不传默认所有，1 常规类型 2 竞价类型0
appIdListString[]N开发者后台的应用 ID 列表，不传默认为当前账号下所有 app
startIntN偏移量，表示从第几条数据开始，默认为00
limitIntN每次拉取数据的最大条数，默认是1000，可选[1,20000]之间的任意整数100
groupByString[]Ndate（日期，默认值）,
appId（应用）,
placementId（广告位）,
adFormat（广告类型）,
area(ISO 3166-1二位国家地区代码),
network（广告平台）,
networkPlacementId（广告平台 API 广告位）,
adSceneId（广告场景，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据）,
sdk (sdk 版本，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
channel (渠道，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
appVersion (应用版本，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
idfa (IDFA 授权，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
bucketId (A/B 测试分组，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据)		["network",”networkPlacementId"]
metricString[]Nall（所有指标，默认值）,
dau（TradPlus 统计的日活跃用户数量(app 级别)）,
deu（TradPlus 统计的每日观看广告用户数）,
arpu（TradPlus 统计的用户平均收入）,
newUsers（TradPlus 统计的新增用户(app 级别)）,
requestApi（广告平台 API 请求数）,
fillApi（广告平台 API 填充数）,
fillrateApi（广告平台 API 填充率）,
impressionApi（广告平台 API 展示数）,
clickApi（广告平台 API 点击数）,
ecpmApi（广告平台 API eCPM）,
ctrApi（广告平台 API 点击率）,
revenue（广告平台 API 收入）,
bidRequestApi（广告平台 API 竞价请求数）,
bidResponseApi（广告平台 API 竞价响应数）,
bidResponseRateApi（广告平台 API 竞价响应率）,
bidWinRateApi（广告平台 API 竞价胜出率）,
appRequest（TradPlus 统计的应用请求数）,
enterAdScene（TradPlus 统计的进入广告场景数）,
enterAdSceneUsers（TradPlus 统计的进入广告场景用户数）,
request（TradPlus 统计的请求数）,
bidRequest（TradPlus 统计的竞价请求数）,
bidResponse（TradPlus 统计的竞价响应数）,
bidResponseRate（TradPlus 统计的竞价响应率）,
bidWinRate（TradPlus 统计的竞价胜出率）,
impression（TradPlus 统计的展示数）,
fill（TradPlus 统计的填充数）,
click（TradPlus 统计的点击数）,
clickUsers（TradPlus 统计的点击用户数）,
ctr（TradPlus 统计的点击率）,
ecpm（TradPlus 统计的 eCPM）,
eventRevenue(TradPlus 统计的埋点收入)，
sdk (TradPlus 记录的 sdk 版本) ,
channel (TradPlus 记录的渠道) ,
appVersion (TradPlus 记录的应用版本) ,
idfa (TradPlus 记录的 IDFA 授权) ,
bucketName (TradPlus 记录的 A/B 测试组名称) ,
countryName (TradPlus 记录的国家)		["dau","request","fillrateApi"]

2.4 返回参数​

HTTP Content-Type: application/json

字段类型备注
codeInt状态码 详见下方状态码定义列表
totalInt总数据量
timezoneString时区
messageString提示信息
itemsArray记录

items 元素结构如下：

字段类型是否必传备注
dateStringN日期，格式：YYYY-mm-dd
appIdStringN应用 ID，groupBy有appId维度才有返回
platformIntN应用的系统平台 (1 Android, 2 iOS)，groupBy有appId维度才有返回
packageNameStringN应用的包名 ，groupBy有appId维度才有返回
placementIdStringN广告位 ID，groupBy有placementId维度才有返回
placementNameStringN广告位名字，groupBy有placementId维度才有返回
adFormatIntN广告位类型，groupBy有adFormat维度才有返回
adFormatNameStringN广告位类型名字，groupBy有adFormat维度才有返回
areaStringN国家地区编码(ISO 3166-1二位国家地区代码)，groupBy有area维度才有返回
networkIntN广告平台 ID，groupBy有network维度才有返回
networkNameStringN广告平台名字，groupBy有network维度才有返回
networkPlacementIdStringN广告平台的广告位 ID 信息，groupBy有networkPlacementId维度才有返回
networkPlacementNameStringN广告平台的广告源名称，groupBy有networkPlacementId维度才有返回
networkPlacementInfoStringN广告平台的广告位详细信息，groupBy有networkPlacementId维度才有返回
adSceneIdStringN广告场景 ID，groupBy有adSceneId维度才有返回
adSceneNameStringN广告场景名称，groupBy有adSceneId维度才有返回
dauIntNTradPlus 统计的日活跃用户数量(app 级别)
deuIntNTradPlus 统计的每日观看广告用户数
arpuFloatNTradPlus 统计的用户平均收入
newUsersIntNTradPlus 统计的新增用户(app 级别)
newUserRateFloatNTradPlus 统计的新增用户占比(app 级别)
bidRequestApiIntN广告平台 API 竞价请求数
bidResponseApiIntN广告平台 API 竞价响应数
bidResponseRateApiFloatN广告平台 API 竞价响应率
bidWinRateApiFloatN广告平台 API 竞价胜出率
requestApiIntN广告平台 API 请求数
fillApiIntN广告平台 API 填充数
fillrateApiFloatN广告平台 API 填充率
impressionApiIntN广告平台 API 展示数
clickApiIntN广告平台 API 点击数
ctrApiFloatN广告平台 API 点击率
ecpmApiFloatN广告平台 API eCPM
RevenueFloatN广告平台 API 收益
appRequestIntNTradPlus 统计的应用请求数
enterAdSceneIntNTradPlus 统计的进入广告场景次数
enterAdSceneUsersIntNTradPlus 统计的进入广告场景用户数
bidRequestIntNTradPlus 统计的竞价请求数
bidResponseIntNTradPlus 统计的竞价响应数
bidResponseRateFloatNTradPlus 统计的竞价响应率
bidWinRateFloatNTradPlus 统计的竞价胜出率
requestIntNTradPlus 统计的请求数
fillIntNTradPlus 统计的填充数
fillrateFloatNTradPlus 统计的填充率
impressionIntNTradPlus 统计的展示次数
impressionRatioFloatNTradPlus 统计的展示占比
clickIntNTradPlus 统计的点击次数
clickUsersIntNTradPlus 统计的点击用户数
ctrFloatNTradPlus 统计的点击率
idfaIntNIDFA 授权
bucketNameStringNA/B 测试组名称
countryNameStringN国家
channelStringN渠道
sdkStringNsdk 版本
appVersionStringN应用版本
ecpmFloatNTradPlus 统计的 eCPM
eventRevenueFloatNTradPlus 统计的埋点收入

各时区完整数据更新时间点： UTC+0 20(北京时间) UTC+8 21点(北京时间) UTC-8 次日2点(北京时间)

广告平台 API 时区说明

2.5 样例​

请求样例​

{
    "startDate": "2021-07-01",
    "endDate"  : "2021-07-07",
    "timezone" : "UTC+8",
    "currency" : "USD",
    "start": 0,
    "limit": 1000,
    "groupBy":
    [
        "date",
        "appId",
        "placementId"
    ],
    "metric":
    [
        "all"
    ]
}

响应样例​

{
    "items": [
        {
            "date": "2021-07-01",
            "appId": "6640E7E3BDAC951B8F28D4C8C50E50B5",
            "packageName": "com.unstall.meetdelete",
            "placementId": "B514A432CE5E96A44BD2E313AC3323AB",
            "placementName": "Banner_1",
            "adFormat": 0,              //groupBy有adFormat维度才有返回
            "adFormatName": "",         //groupBy有adFormat维度才有返回
            "area": "YE",               //groupBy有area维度才有返回
            "network": 0,               //groupBy有network维度才有返回
            "networkName": "",          //groupBy有network维度才有返回
            "networkPlacementName": "", //groupBy有networkPlacementId维度才有返回
            "networkPlacementId": "",   //groupBy有networkPlacementId维度才有返回
            "networkPlacementInfo": "", //groupBy有networkPlacementId维度才有返回
            "adSceneId":"",             //groupBy有adSceneId维度才有返回
            "adSceneName":"",           //groupBy有adSceneId维度才有返回
            "requestApi": 19433,
            "fillApi":150,
            "fillrateApi": 0.13,
            "impressionApi": 1989,
            "clickApi": 236,
            "ecpmApi": 2.21,
            "ctrApi": 0.14,
            "Revenue": 6.59,
            "dau": 679,
            "deu": 223,
            "arpu": 0.01,
            "newUsers": 349,
            "newUserRate": 0.63,
            "enterAdScene":4123,
            "enterAdSceneUsers":3178,
            "impression": 44106,
            "ecpm": 2.267265,
            "impressionRatio": 0.8507,
            "click": 20358,
            "clickUsers": 16829,
            "ctr": 0.4616,
            "request": 19432,
            "bidRequestApi": 8655,
            "bidRequest": 9152,
            "bidResponseApi": 4582,
            "bidResponse": 5625,
            "bidResponseRateApi": 0.5294,
            "bidResponseRate": 0.6175,
            "bidWinRateApi": 3.4547,
            "bidWinRate": 4.2409,
			"appRequest": 1549732,
            "idfa": 0,
            "bucketName": "",
            "countryName": "",
            "channel": "",
            "sdk": "",
            "appVersion": ""
        }
    ],
    "timezone": "UTC+8"
}

3. 综合报表数据查询 API v4​

3.1 URL_v4​

https://openapi.tradplusad.com/v4/allreport

3.2 请求协议_v4​

HTTP POST HTTP Content-Type: application/json

3.3请求参数_v4​

数据需要拉取到没有返回为止，通过 start 参数

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2020-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2020-03-02
timezoneStringN时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0";广告平台 API 数据可按时区切换查看，TradPlus 统计数据不支持时区切换，和开发者后台设置时区一致UTC+8
currencyStringN币种：不传默认 USD 仅支持 USD CNYUSD
bidTypeintN竞价类型：不传默认所有，1 常规类型 2 竞价类型0
appIdListString[]N开发者后台的应用 ID 列表，不传默认为当前账号下所有 app
includeDeletedPlacementIdintN是否支持查询已删除广告源，默认0, 0 不支持 1 支持0
startIntN偏移量，表示从第几条数据开始，默认为00
limitIntN每次拉取数据的最大条数，默认是1000，可选[1,20000]之间的任意整数100
groupByString[]Ndate（日期，默认值）,
appId（应用）,
placementId（广告位）,
adFormat（广告类型）,
area(ISO 3166-1二位国家地区代码),
network（广告平台）,
networkPlacementId（广告平台 API 广告位）,
adSceneId（广告场景，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据）,
sdk (sdk 版本，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
channel (渠道，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
appVersion (应用版本，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
idfa (IDFA 授权，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
bucketId (A/B 测试分组，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据) ,
intermediaryGroupId (中介组，广告平台 API 不支持此维度，选择后不会返回广告平台 API 统计数据；默认组 id 为 0、名称为「所有国家」)		["network",”networkPlacementId"]
metricString[]Nall（所有指标，默认值）,
dau（TradPlus 统计的日活跃用户数量(app 级别)）,
deu（TradPlus 统计的每日观看广告用户数）,
arpu（TradPlus 统计的用户平均收入）,
newUsers（TradPlus 统计的新增用户(app 级别)）,
requestApi（广告平台 API 请求数）,
fillApi（广告平台 API 填充数）,
fillrateApi（广告平台 API 填充率）,
impressionApi（广告平台 API 展示数）,
clickApi（广告平台 API 点击数）,
ecpmApi（广告平台 API eCPM）,
ctrApi（广告平台 API 点击率）,
revenue（广告平台 API 收入）,
bidRequestApi（广告平台 API 竞价请求数）,
bidResponseApi（广告平台 API 竞价响应数）,
bidResponseRateApi（广告平台 API 竞价响应率）,
bidWinRateApi（广告平台 API 竞价胜出率）,
appRequest（TradPlus 统计的应用请求数）,
appFill（TradPlus 统计的应用填充数）,
enterAdScene（TradPlus 统计的进入广告场景数）,
enterAdSceneUsers（TradPlus 统计的进入广告场景用户数）,
request（TradPlus 统计的请求数）,
bidRequest（TradPlus 统计的竞价请求数）,
bidResponse（TradPlus 统计的竞价响应数）,
bidResponseRate（TradPlus 统计的竞价响应率）,
bidWinRate（TradPlus 统计的竞价胜出率）,
bidResponseEcpm（TradPlus 统计的竞价响应 eCPM）,
impression（TradPlus 统计的展示数）,
fill（TradPlus 统计的填充数）,
click（TradPlus 统计的点击数）,
clickUsers（TradPlus 统计的点击用户数）,
ctr（TradPlus 统计的点击率）,
ecpm（TradPlus 统计的 eCPM）,
eventRevenue(TradPlus 统计的埋点收入)，
sdk (TradPlus 记录的 sdk 版本) ,
channel (TradPlus 记录的渠道) ,
appVersion (TradPlus 记录的应用版本) ,
idfa (TradPlus 记录的 IDFA 授权) ,
bucketName (TradPlus 记录的 A/B 测试组名称) ,
countryName (TradPlus 记录的国家)		["dau","request","fillrateApi"]

3.4 返回参数_v4​

HTTP Content-Type: application/json

字段类型备注
codeInt状态码 详见下方状态码定义列表
totalInt总数据量
timezoneString时区
messageString提示信息
itemsArray记录

items 元素结构如下：

字段类型是否必传备注
dateStringN日期，格式：YYYY-mm-dd
appIdStringN应用 ID，groupBy有appId维度才有返回
platformIntN应用的系统平台 (1 Android, 2 iOS)，groupBy有appId维度才有返回
packageNameStringN应用的包名 ，groupBy有appId维度才有返回
placementIdStringN广告位 ID，groupBy有placementId维度才有返回
placementNameStringN广告位名字，groupBy有placementId维度才有返回
adFormatIntN广告位类型，groupBy有adFormat维度才有返回
adFormatNameStringN广告位类型名字，groupBy有adFormat维度才有返回
areaStringN国家地区编码(ISO 3166-1二位国家地区代码)，groupBy有area维度才有返回
networkIntN广告平台 ID，groupBy有network维度才有返回
networkNameStringN广告平台名字，groupBy有network维度才有返回
networkPlacementIdStringN广告平台的广告位 ID 信息，groupBy有networkPlacementId维度才有返回
networkPlacementNameStringN广告平台的广告源名称，groupBy有networkPlacementId维度才有返回
networkPlacementInfoStringN广告平台的广告位详细信息，groupBy有networkPlacementId维度才有返回
isInCurrentConfigStringN广告源的状态（1 正常 0 删除），groupBy有networkPlacementId维度才有返回
adSceneIdStringN广告场景 ID，groupBy有adSceneId维度才有返回
adSceneNameStringN广告场景名称，groupBy有adSceneId维度才有返回
intermediaryGroupIdStringN中介组 ID，groupBy有intermediaryGroupId维度才有返回；默认组为 0
intermediaryGroupNameStringN中介组名称，groupBy有intermediaryGroupId维度才有返回；默认组为「所有国家」
dauIntNTradPlus 统计的日活跃用户数量(app 级别)
deuIntNTradPlus 统计的每日观看广告用户数
arpuFloatNTradPlus 统计的用户平均收入
newUsersIntNTradPlus 统计的新增用户(app 级别)
newUserRateFloatNTradPlus 统计的新增用户占比(app 级别)
bidRequestApiIntN广告平台 API 竞价请求数
bidResponseApiIntN广告平台 API 竞价响应数
bidResponseRateApiFloatN广告平台 API 竞价响应率
bidWinRateApiFloatN广告平台 API 竞价胜出率
requestApiIntN广告平台 API 请求数
fillApiIntN广告平台 API 填充数
fillrateApiFloatN广告平台 API 填充率
impressionApiIntN广告平台 API 展示数
clickApiIntN广告平台 API 点击数
ctrApiFloatN广告平台 API 点击率
ecpmApiFloatN广告平台 API eCPM
RevenueFloatN广告平台 API 收益
appRequestIntNTradPlus 统计的应用请求数
appFillIntNTradPlus 统计的应用填充数
enterAdSceneIntNTradPlus 统计的进入广告场景次数
enterAdSceneUsersIntNTradPlus 统计的进入广告场景用户数
bidRequestIntNTradPlus 统计的竞价请求数
bidResponseIntNTradPlus 统计的竞价响应数
bidResponseRateFloatNTradPlus 统计的竞价响应率
bidWinRateFloatNTradPlus 统计的竞价胜出率
bidResponseEcpmFloatNTradPlus 统计的竞价响应 eCPM（竞价响应对应收入 / 竞价响应数 × 1000）
requestIntNTradPlus 统计的请求数
fillIntNTradPlus 统计的填充数
fillrateFloatNTradPlus 统计的填充率
impressionIntNTradPlus 统计的展示次数
impressionRatioFloatNTradPlus 统计的展示占比
clickIntNTradPlus 统计的点击次数
clickUsersIntNTradPlus 统计的点击用户数
ctrFloatNTradPlus 统计的点击率
idfaIntNIDFA 授权
bucketNameStringNA/B 测试组名称
countryNameStringN国家
channelStringN渠道
sdkStringNsdk 版本
appVersionStringN应用版本
ecpmFloatNTradPlus 统计的 eCPM
eventRevenueFloatNTradPlus 统计的埋点收入

各时区完整数据更新时间点： UTC+0 20(北京时间) UTC+8 21点(北京时间) UTC-8 次日2点(北京时间)

广告平台 API 时区说明

3.5 样例_v4​

请求样例​

{
    "startDate": "2021-07-01",
    "endDate"  : "2021-07-07",
    "timezone" : "UTC+8",
    "currency" : "USD",
    "start": 0,
    "limit": 1000,
    "groupBy":
    [
        "date",
        "appId",
        "placementId"
    ],
    "metric":
    [
        "all"
    ]
}

响应样例​

{
    "items": [
        {
            "date": "2021-07-01",
            "appId": "6640E7E3BDAC951B8F28D4C8C50E50B5",
            "packageName": "com.unstall.meetdelete",
            "placementId": "B514A432CE5E96A44BD2E313AC3323AB",
            "placementName": "Banner_1",
            "adFormat": 0,              //groupBy有adFormat维度才有返回
            "adFormatName": "",         //groupBy有adFormat维度才有返回
            "area": "YE",               //groupBy有area维度才有返回
            "network": 0,               //groupBy有network维度才有返回
            "networkName": "",          //groupBy有network维度才有返回
            "networkPlacementName": "", //groupBy有networkPlacementId维度才有返回
            "networkPlacementId": "",   //groupBy有networkPlacementId维度才有返回
            "networkPlacementInfo": "", //groupBy有networkPlacementId维度才有返回
            "adSceneId":"",             //groupBy有adSceneId维度才有返回
            "adSceneName":"",           //groupBy有adSceneId维度才有返回
            "requestApi": 19433,
            "fillApi":150,
            "fillrateApi": 0.13,
            "impressionApi": 1989,
            "clickApi": 236,
            "ecpmApi": 2.21,
            "ctrApi": 0.14,
            "Revenue": 6.59,
            "dau": 679,
            "deu": 223,
            "arpu": 0.01,
            "newUsers": 349,
            "newUserRate": 0.63,
            "enterAdScene":4123,
            "enterAdSceneUsers":3178,
            "impression": 44106,
            "ecpm": 2.267265,
            "impressionRatio": 0.8507,
            "click": 20358,
            "clickUsers": 16829,
            "ctr": 0.4616,
            "request": 19432,
            "bidRequestApi": 8655,
            "bidRequest": 9152,
            "bidResponseApi": 4582,
            "bidResponse": 5625,
            "bidResponseRateApi": 0.5294,
            "bidResponseRate": 0.6175,
            "bidWinRateApi": 3.4547,
            "bidWinRate": 4.2409,
			"appRequest": 1549732,
            "idfa": 0,
            "bucketName": "",
            "countryName": "",
            "channel": "",
            "sdk": "",
            "appVersion": ""
        }
    ],
    "timezone": "UTC+8"
}

4. 用户价值1-90天报表 API​

4.1 URL​

https://openapi.tradplusad.com/v2/ltv

4.2 请求协议​

HTTP POST HTTP Content-Type: application/json

4.3请求参数​

数据需要拉取到没有返回为止，通过 start 参数

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2020-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2020-03-02
timezoneStringN时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0";广告平台 API 数据可按时区切换查看，TradPlus 统计数据不支持时区切换，和开发者后台设置时区一致UTC+8
currencyStringN币种：不传默认 USD 仅支持 USD CNYUSD
appIdListString[]N开发者后台的应用 ID 列表，不传默认为当前账号下所有 app
areaListString[]NISO 3166-1二位国家地区代码的列表，不传默认为全部地区CN
startIntN偏移量，表示从第几条数据开始，默认为00
limitIntN每次拉取数据的最大条数，默认是1000，可选[1,1000]之间的任意整数100
groupByString[]Ydate 日期，必填
app 应用，必填
area 国家
placementId 广告位
appVersion 应用版本
channel 渠道		["date","app","area"]
metricString[]Yltvxx 列表，最多支持90天，只传一个["all"] 代表全部，例如 ltv20代表第20天的累积收益["ltv11","ltv12","ltv13"]

4.4 返回参数​

HTTP Content-Type: application/json

字段1类型备注
timezoneString时区
itemsArray记录

items 元素结构如下：

字段类型备注
dateString日期，格式：YYYY-mm-dd
appIdString应用 ID
appNameString应用名称
appVersionString应用版本
channelString渠道
placementIdString广告位 ID
placementNameString广告位名称
newUserNumInt64新增用户数
ltvxxFloat64ltv 数字（1-90）

备注:每日北京时间21点更新昨天数据

5. 用户价值1-90天报表 tradplus 数据​

5.1 URL​

https://openapi.tradplusad.com/v2/tpltv

5.2 请求协议​

HTTP POST HTTP Content-Type: application/json

5.3请求参数​

数据需要拉取到没有返回为止，通过 start 参数

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2020-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2020-03-02
timezoneStringN时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0";广告平台 API 数据可按时区切换查看，TradPlus 统计数据不支持时区切换，和开发者后台设置时区一致UTC+8
currencyStringN币种：不传默认 USD 仅支持 USD CNYUSD
appIdListString[]N开发者后台的应用 ID 列表，不传默认为当前账号下所有 app
areaListString[]NISO 3166-1二位国家地区代码的列表，不传默认为全部地区CN
startIntN偏移量，表示从第几条数据开始，默认为00
limitIntN每次拉取数据的最大条数，默认是1000，可选[1,1000]之间的任意整数100
groupByString[]Ydate 日期，必填
app 应用，必填
area 国家
placementId 广告位
appVersion 应用版本
channel 渠道		["date","app","area"]
metricString[]Yltvxx 列表，最多支持90天，只传一个["all"] 代表全部，例如 ltv20代表第20天的累积收益["ltv11","ltv12","ltv13"]

5.4 返回参数​

HTTP Content-Type: application/json

字段1类型备注
timezoneString时区
itemsArray记录

items 元素结构如下：

字段类型备注
dateString日期，格式：YYYY-mm-dd
appIdString应用 ID
appNameString应用名称
appVersionString应用版本
channelString渠道
placementIdString广告位 ID
placementNameString广告位名称
newUserNumInt64新增用户数
ltvxxFloat64ltv 数字（1-90）

备注:每日北京时间21点更新昨天数据

5.5 样例​

请求样例：​

{
    "startDate": "2021-07-01",
    "endDate"  : "2021-07-07",
    "timezone" : "UTC+0",
    "currency" : "USD",
    "start": 0,
    "limit": 1000,
    "groupBy":
    [
        "date",
        "app"
    ],
    "metric":
    [
        "all"
    ]
}

响应样例：​

{
    "items":
    [
        {
            "appId": "6640E7E3BDAC951B8F28D4C8C50E50B5",
            "appName": "Banner_1",
            "date": "2021-07-01",
            "newUserNum": 2,
            "ltv1": 9.54,
            "ltv10": 0,
            "ltv11": 0,
            "ltv12": 0,
            "ltv13": 0,
            "ltv14": 0,
            "ltv15": 0,
            "ltv16": 0,
            "ltv17": 0,
            "ltv18": 0,
            "ltv19": 0,
            "ltv2": 0,
            "ltv20": 0,
            "ltv21": 0,
            "ltv22": 0,
            "ltv23": 0,
            "ltv24": 0,
            "ltv25": 0,
            "ltv26": 0,
            "ltv27": 0,
            "ltv28": 0,
            "ltv29": 0,
            "ltv3": 0,
            "ltv30": 0,
            "ltv31": 0,
            "ltv32": 0,
            "ltv33": 0,
            "ltv34": 0,
            "ltv35": 0,
            "ltv36": 0,
            "ltv37": 0,
            "ltv38": 0,
            "ltv39": 0,
            "ltv4": 0,
            "ltv40": 0,
            "ltv41": 0,
            "ltv42": 0,
            "ltv43": 0,
            "ltv44": 0,
            "ltv45": 0,
            "ltv46": 0,
            "ltv47": 0,
            "ltv48": 0,
            "ltv49": 0,
            "ltv5": 0,
            "ltv50": 0,
            "ltv51": 0,
            "ltv52": 0,
            "ltv53": 0,
            "ltv54": 0,
            "ltv55": 0,
            "ltv56": 0,
            "ltv57": 0,
            "ltv58": 0,
            "ltv59": 0,
            "ltv6": 0,
            "ltv60": 0,
            "ltv61": 0,
            "ltv62": 0,
            "ltv63": 0,
            "ltv64": 0,
            "ltv65": 0,
            "ltv66": 0,
            "ltv67": 0,
            "ltv68": 0,
            "ltv69": 0,
            "ltv7": 0,
            "ltv70": 0,
            "ltv71": 0,
            "ltv72": 0,
            "ltv73": 0,
            "ltv74": 0,
            "ltv75": 0,
            "ltv76": 0,
            "ltv77": 0,
            "ltv78": 0,
            "ltv79": 0,
            "ltv8": 0,
            "ltv80": 0,
            "ltv81": 0,
            "ltv82": 0,
            "ltv83": 0,
            "ltv84": 0,
            "ltv85": 0,
            "ltv86": 0,
            "ltv87": 0,
            "ltv88": 0,
            "ltv89": 0,
            "ltv9": 0,
            "ltv90": 0
        }
    ],
    "timezone": "UTC+0"
}

6 用户留存2-90天报表 API 数据​

6.1 URL​

https://openapi.tradplusad.com/v2/userActive

6.2 请求协议​

HTTP POST HTTP Content-Type: application/json

6.3请求参数​

数据需要拉取到没有返回为止，通过 start 参数

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2020-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2020-03-02
timezoneStringN时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0";广告平台 API 数据可按时区切换查看，TradPlus 统计数据不支持时区切换，和开发者后台设置时区一致UTC+8
appIdListString[]N开发者后台的应用 ID 列表，不传默认为当前账号下所有 app
areaListString[]NISO 3166-1二位国家地区代码的列表，不传默认为全部地区CN
startIntN偏移量，表示从第几条数据开始，默认为00
limitIntN每次拉取数据的最大条数，默认是1000，可选[1,1000]之间的任意整数100
groupByString[]Ydate 日期，必填
app 应用，必填
area 国家
appVersion 应用版本
channel 渠道		["date","app","area"]
metricString[]Ykpxx 列表，最多支持90天，只传一个["all"] 代表全部，例如 kp20 代表第20天的累积收益["kp22","kp23"]

6.4 返回参数​

HTTP Content-Type: application/json

字段类型备注
timezoneString时区
itemsArray记录

items 元素结构如下：

字段类型备注
dateString日期，格式：YYYY-mm-dd
appIdString应用 ID
appNameString应用版本
appVersionString应用版本
channelString渠道
kpxxFloat64kp 数字（1-90）

备注:每日北京时间21点更新昨天数据

6.5 样例​

请求样例：​

{
    "startDate": "2021-07-01",
    "endDate"  : "2021-07-07",
    "timezone" : "UTC+0",
    "currency" : "USD",
    "start": 0,
    "limit": 1000,
    "groupBy":
    [
        "date",
        "app"
    ],
    "metric":
    [
        "all"
    ]
}

响应样例：​

{
    "items": [
        {
            "appId": "FDC48B1D9D9E1F5CBD0C327159C8191C",
            "appName": "Banner_1",
            "date": "2021-07-01",
            "kp1": 2.31,
            "kp10": 0,
            "kp11": 0,
            "kp12": 0,
            "kp13": 0,
            "kp14": 0,
            "kp15": 0,
            "kp16": 0,
            "kp17": 0,
            "kp18": 0,
            "kp19": 0,
            "kp2": 0,
            "kp20": 0,
            "kp21": 0,
            "kp22": 0,
            "kp23": 0,
            "kp24": 0,
            "kp25": 0,
            "kp26": 0,
            "kp27": 0,
            "kp28": 0,
            "kp29": 0,
            "kp3": 0,
            "kp30": 0,
            "kp31": 0,
            "kp32": 0,
            "kp33": 0,
            "kp34": 0,
            "kp35": 0,
            "kp36": 0,
            "kp37": 0,
            "kp38": 0,
            "kp39": 0,
            "kp4": 0,
            "kp40": 0,
            "kp41": 0,
            "kp42": 0,
            "kp43": 0,
            "kp44": 0,
            "kp45": 0,
            "kp46": 0,
            "kp47": 0,
            "kp48": 0,
            "kp49": 0,
            "kp5": 0,
            "kp50": 0,
            "kp51": 0,
            "kp52": 0,
            "kp53": 0,
            "kp54": 0,
            "kp55": 0,
            "kp56": 0,
            "kp57": 0,
            "kp58": 0,
            "kp59": 0,
            "kp6": 0,
            "kp60": 0,
            "kp61": 0,
            "kp62": 0,
            "kp63": 0,
            "kp64": 0,
            "kp65": 0,
            "kp66": 0,
            "kp67": 0,
            "kp68": 0,
            "kp69": 0,
            "kp7": 0,
            "kp70": 0,
            "kp71": 0,
            "kp72": 0,
            "kp73": 0,
            "kp74": 0,
            "kp75": 0,
            "kp76": 0,
            "kp77": 0,
            "kp78": 0,
            "kp79": 0,
            "kp8": 0,
            "kp80": 0,
            "kp81": 0,
            "kp82": 0,
            "kp83": 0,
            "kp84": 0,
            "kp85": 0,
            "kp86": 0,
            "kp87": 0,
            "kp88": 0,
            "kp89": 0,
            "kp9": 0,
            "kp90": 0
        }
    ],
    "timezone": "UTC+0"
}

7 A/B 测试报表 API 数据​

7.1 各实验组对比报表数据​

7.1.1 URL​

https://openapi.tradplusad.com/v4/abtestreport

7.1.2 请求协议​

HTTP POST HTTP Content-Type: application/json

7.1.3 请求参数​

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2026-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2026-03-02
abtestIdIntYA/B 测试 ID；开发者后台管理 API 的 A/B 测试列表获取
countryStringN国家码，支持多选，逗号分隔；开发者后台管理 API 的查询国家信息获取US,JP

7.1.4 返回参数​

HTTP Content-Type: application/json

字段类型必传说明
adseat_uuidIntY广告位 UUID
adseat_nameStringY广告位名称
bucket_idIntY分组 ID
bucket_group_idIntY分组组号
bucket_nameStringY分组名称
deuNumberY日均 DEU
dauNumberY日均 DAU
incomeNumberY预估收入
app_requestIntY应用请求
app_fillIntY应用填充
impressionIntY展示数
app_fill_rateNumberY应用填充率
app_fill_timesNumberY应用填充时长
impression_dauNumberY人均展示（按 DAU）
impression_deuNumberY人均展示（按 DEU）
est_ecpmNumberY预估 eCPM
arpdeuNumberYARPDEU 单位￠
engaged_rateNumberY渗透率
income_dauNumberY收入/DAU

7.1.5 样例​

请求样例：​

{
    "startDate":"2026-03-16",
    "endDate":"2026-03-16",
    "abtestId" : 3210,
    "countrys" : ""
}

响应样例：​

{
    "code": 200,
    "items": [
        {
            "adseat_uuid": "C9426BEC900CB2E6A8E8C671AA8BFB12",
            "adseat_name": "插屏",
            "bucket_id": "8431",
            "bucket_group_id": "1",
            "bucket_name": "A组",
            "deu": 20,
            "dau": 10,
            "income": 4,
            "app_request": 2,
            "app_fill": 4,
            "impression": 8,
            "app_fill_rate": 200,
            "app_fill_times": 0.0177,
            "impression_dau": 0.8,
            "impression_deu": 0.4,
            "est_ecpm": 500,
            "arpdeu": 20,
            "engaged_rate": 200,
            "income_dau": 0.4
        },
        {
            "adseat_uuid": "C9426BEC900CB2E6A8E8C671AA8BFB12",
            "adseat_name": "插屏",
            "bucket_id": "8432",
            "bucket_group_id": "2",
            "bucket_name": "B组",
            "deu": 20,
            "dau": 10,
            "income": 4,
            "app_request": 2,
            "app_fill": 4,
            "impression": 8,
            "app_fill_rate": 200,
            "app_fill_times": 0.0177,
            "impression_dau": 0.8,
            "impression_deu": 0.4,
            "est_ecpm": 500,
            "arpdeu": 20,
            "engaged_rate": 200,
            "income_dau": 0.4
        }
    ]
}

7.2 应用维度预估数据​

7.2.1 URL​

https://openapi.tradplusad.com/v4/appforecastreport

7.2.2 请求协议​

HTTP POST HTTP Content-Type: application/json

7.2.3 请求参数​

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2026-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2026-03-02
abtestIdIntYA/B 测试 ID；开发者后台管理 API 的 A/B 测试列表获取
countryStringN国家码，支持多选，逗号分隔；开发者后台管理 API 的查询国家信息获取US,JP

7.2.4 返回参数​

HTTP Content-Type: application/json

字段类型必传说明
app_uuidstringY应用 ID
bucket_idIntY分组 ID
bucket_group_idIntY分组组号
bucket_nameStringY分组名称
percentStringY分流占比
dauNumberY日均 DAU
deuNumberY日均 DEU
incomeNumberY预估收益
arpdeuNumberYARPDEU 单位￠
income_dauNumber/StringYDAU 收入
app_requestNumberY应用请求
app_fillNumberY应用填充
app_fill_rateFloatY应用填充率
app_fill_timesFloatY应用填充时长
impressionNumberY展示
impression_dauFloatY展示 / DAU
impression_deuNumberY展示 / DEU
engaged_rateFloatY渗透率
est_ecpmFloatY预估 eCPM

7.2.5 样例​

请求样例：​

{
    "startDate":"2026-03-16",
    "endDate":"2026-03-16",
    "abtestId" : 3210,
    "countrys" : ""
}

响应样例：​

{
    "code": 200,
    "items": [
        {
            "app_uuid": "8EFC6E4C26E961B3C68C274CE4862511",
            "bucket_id": "8431",
            "bucket_group_id": "1",
            "bucket_name": "A组",
            "percent": "50",
            "dau": 10,
            "deu": 5,
            "income": 6,
            "arpdeu": 120,
            "income_dau": 0.6,
            "app_request": 1,
            "app_fill": 2,
            "app_fill_rate": 200,
            "app_fill_times": 0.0013,
            "impression": 4,
            "impression_dau": 0.4,
            "impression_deu": 0.8,
            "engaged_rate": 50,
            "est_ecpm": 1500
        },
        {
            "app_uuid": "8EFC6E4C26E961B3C68C274CE4862511",
            "bucket_id": "8432",
            "bucket_group_id": "2",
            "bucket_name": "B组",
            "percent": "50",
            "dau": 10,
            "deu": 50,
            "income": 60,
            "arpdeu": 120,
            "income_dau": 6,
            "app_request": 10,
            "app_fill": 20,
            "app_fill_rate": 200,
            "app_fill_times": 0,
            "impression": 40,
            "impression_dau": 4,
            "impression_deu": 0.8,
            "engaged_rate": 500,
            "est_ecpm": 1500
        }
    ]
}

7.3 置信度评估数据​

7.3.1 URL​

https://openapi.tradplusad.com/v4/abconfidencereport

7.3.2 请求协议​

HTTP POST HTTP Content-Type: application/json

7.3.3 请求参数​

参数名类型是否必传备注样例
startDateStringY开始日期，格式：YYYY-mm-dd2026-03-01
endDateStringY结束日期，格式：YYYY-mm-dd2026-03-02
abtestIdIntYA/B 测试 ID；开发者后台管理 API 的 A/B 测试列表获取

7.3.4 返回参数​

HTTP Content-Type: application/json

字段类型必传说明
bucket_idIntY分组 ID
bucket_nameStringY分组名称
bucket_group_idStringY分组组号
test_timeStringY实验时长（小时）（基准组返回-）
dauStringYDAU（基准组返回-）
arpuNumberNARPU 单位￠
statusStringN置信状态（基准组返回-）1可信 0不可信

7.3.5 样例​

请求样例：​

{
    "startDate":"2026-03-16",
    "endDate":"2026-03-16",
    "abtestId" : 3210
}

响应样例：​

{
    "code": 200,
    "items": [
        {
            "bucket_id": 8431,
            "arpu_cny": 1,
            "adseat_id": 86730,
            "dau": "-",
            "arpu": 50,
            "status": "-",
            "test_time": "-",
            "bucket_name": "A组",
            "bucket_group_id": "1"
        },
        {
            "bucket_id": 8432,
            "arpu_cny": 7.6,
            "adseat_id": 86730,
            "dau": "10",
            "arpu": 200,
            "status": "1",
            "test_time": "26",
            "bucket_name": "B组",
            "bucket_group_id": "2"
        }
    ]
}

广告平台 ID​

id备注
1Meta
2Admob
4AdColony
5Unity Ads
6Tapjoy
7Liftoff
9Applovin
10IronSource
15Chartboost
16Tencent Ads
17穿山甲
18Mintegral
19Pangle
20Kuaishou Ads
21Sigmob
23Inmobi
24Digital Turbine
25Youdao
27crosspro
30Helium
31Maio
32Criteo
33VK Ads
34ogury
36Appnext
37Kidoz
38Smaato
41Huawei Ads
43BaiDu Ads
44Klevin
45A4G
46米盟
47Super Awesome
48Google Ad Manager
49GroMore
50Yandex
51My Network
52小步科技
54Appic (海外)
55zMaticoo
56ReklamUp
57Bigo
58BeiZi
59Okspin
60ONEMOB
61Appic(China)
62LeYou
63Dirchlet(TapTap)
64PremiumAds
65zMaticoo（H5）
66My Network 2
67GreedyGame
68AlgoriX
69BeesAds
70APS
71Mango X
72章鱼移动
73TanX
74TaurusX
75KwaiAd
76Columbus
77YSO
78Vivo
79OPPO 广告联盟

广告类型​

id备注
1原生
2插屏
3开屏
4横幅
5激励视频
6积分墙
7互动广告
8插播

code 状态码定义​

数值含义
200成功
401用户校验信息缺失或者错误
10001请求参数错误
10005开始或结束时间错误
10006维度参数错误
10007请求指标错误