名称

类型

描述

校验规则

是否必填

user_id

integer

媒体账号id

对应账号必须存在且状态为"运行中"

是

role_id

integer

子账号id，若使用主账号，则此处填写主账号ID

对应子账号必须存在且从属于主账号；子账号拥有聚合权限；

是

timestamp

integer

时间戳（毫秒）

请求提交时间的十分钟内

是

sign

string

通过指定哈算算法生成的签名，用于校验token

存在且不为空；使用指定算法验签

是

sign_type

string

哈希算法(取值MD5)

只能使用已支持的算法（MD5）

是

version

string

API版本号

固定版本号："2.0"

是

network_id

integer

广告网络id，固定ADN见映射表，自定义ADN的id在平台查看

只能是目前已支持/已配置的广告网络

注意：已在【广告网络】中配置自动自动拉取API数据的ADN暂不支持通过该接口回传数据

是

report_data

map<string, list<CustomReportData>>

报表数据：key:日期(格式为yyyy-MM-dd); value: 当前日期的收益数据

注意：该参数不用于签名字符串的生成，请勿将该参数拼接至签名字符串

日期必须合法，且不能超过7天，T日只支持上传(T-1~(T-7)日数据。

是

名称

类型

描述

校验规则

是否必填

app_id

string

adn对应的app id（非穿山甲appid）

已在平台上配置

是

ad_slot_id

string

adn对应的代码位ID

已在平台上配置

是

request_count

integer

请求量

>= 0

否

return_count

integer

返回量

>= 0

否

show_count

integer

展示量

>= 0

否

click_count

integer

点击量

>= 0

否

revenue

double

收入，单位：元

>= 0

否

名称

类型

描述

code

string

返回错误码。100为成功

message

string

错误信息。详细的错误信息会体现在这里。

错误码

描述

解决方案

100

成功

-

115

参数错误。具体的错误信息披露在message中，其中包含了服务内部的code和msg。例如："GM1903: 上传的数据含有非法的值"

请根据报错信息检查参数后重新上传；请注意，若在report_data中所传非法数据，那么该条数据会被过滤，其余数据会上传成功

116

服务内部错误

请根据具体报错信息处理

错误码

描述

解决方案

GM1305

广告网络非法

请检查广告网络ID是否填写正确，只能是目前已支持/已配置的广告网络

GM1901

日期与指定的格式不符

格式为yyyy-MM-dd

GM1902

您上传的数据均未匹配到对应的代码位，请检查数据是否上传正确

-

GM1903

您上传的数据存在非法字符，非法数据将被过滤，其余数据将会正常上传

-

GM1904

仅支持上传(T-1)~(T-7)日内的数据，您上传的数据中存在超出时间范围内的数据，该部分数据会被过滤，其余数据将会正常上传

-

GM1905

您已配置通过自动拉取该广告网络API数据，无需手动回传数据

已在【广告网络】中配置自动自动拉取API数据的ADN暂不支持通过该接口回传数据，自动拉取API数据更方便。

广告平台ID

广告平台名称

币种

1

穿山甲

使用当前账号的币种

2

Admob

usd

3

优量汇

cny

4

Mintegral

usd

5

百度

cny

6

Unity

usd

7

快手

cny

8

Sigmob

cny

9

游可盈

cny