字段英文名

字段中文名

类型

是否必填

说明

user_id

媒体主账户ID

string

是

穿山甲开发者平台的媒体账户ID

signature

数据签名

string

是

payload

上报数据内容

string

是

JSON字符串数组

投放渠道分类

渠道说明

广告平台渠道

指通过巨量引擎、磁力引擎、腾讯广告等广告平台渠道买量，对应产生的广告展示、点击和消耗等相关数据。

非广告平台渠道

指通过华为、OV、小米等厂商渠道买量，对应产生的买量成本等相关数据。

分类

字段英文名

字段中文名

类型

是否必填-广告平台渠道

是否必填-厂商渠道

说明

通用信息

site_id

在穿山甲平台绑定的应用ID

long

是

是

根据上传的siteID自动绑定包名

通用信息

ad_platform

广告投放渠道

string

是

是

！！！ 注意：媒体渠道映射关系 ，广告投放渠道映射表

通用信息

stat_date

发生消耗的日期, 格式: yyyyMMdd

string

是

是

通用信息

stat_hour

发生消耗的小时时间(0-23)

string

是

是

通用信息

package_name

包名

string

是

是

通用信息

os

系统类型

string

是

是

安卓系统对应android ,ios系统对应ios

广告维度信息

advertiser_id

广告主 id

long

是

否

巨量平台对应advertiser_id，广点通平台对应account_id，磁力引擎对应advertiser_id

广告维度信息

advertiser_name

广告主名称

string

否

否

巨量平台对应advertiser_name，广点通平台对应account_name，磁力引擎对应advertiser_name

广告维度信息

campaign_id

广告第一层级，广告组id

long

是

否

巨量平台对应project_id，广点通平台对应campaign_id，磁力引擎对应campaign_id

广告维度信息

campaign_name

广告第一层级，广告组名称

string

否

否

巨量平台对应project_name，广点通平台对应campaign_name，磁力引擎对应campaign_name

广告维度信息

ad_id

广告第二层级，广告计划 id

long

是

否

巨量平台对应promotion_id，广点通平台对应adgroup_id，磁力引擎对应unit_id

广告维度信息

ad_name

广告第二层级，广告计划名称

string

否

否

巨量平台对应promotion_name，广点通平台对应adgroup_name，磁力引擎对应unit_name

广告维度信息

creative_id

广告创意

long

是

否

巨量平台对应mid，广点通平台对应ad_id，磁力引擎对应creative_id

mid是针对巨量引擎，下发的原始素材id，详细说明如下：

mid1：图片素材宏参数

mid2：标题素材宏参数

mid3：视频素材宏参数

mid4：搭配试玩素材宏参数

mid5：落地页素材宏参数

mid6：安卓下载详情页素材宏参数

广告维度信息

creative_name

广告创意名称

string

否

否

广告维度信息

ad_status

广告状态

string

否

否

广告维度信息

campaign_status

广告组状态

string

否

否

广告维度信息

campaign_create_time

广告组创建时间，格式：yyyy-MM-dd hh:mm:ss

string

否

否

广告维度信息

campaign_modify_time

广告组最后更新时间，格式：yyyy-MM-dd hh:mm:ss

string

否

否

广告维度信息

ad_create_time

广告计划创建时间，格式：yyyy-MM-dd hh:mm:ss

string

否

否

广告维度信息

ad_modify_time

广告计划更新时间，格式：yyyy-MM-dd hh:mm:ss

string

否

否

广告维度信息

deep_bid_type

投放方式

string

否

否

巨量平台对应deep_bid_type,广点通平台对应deep_optimization_action_type，磁力引擎对应deep_conversion_type

投放信息

show

展示数

long

是

否

投放信息

click

点击数

long

是

否

投放信息

cost

总花费(RMB分)

long

是

是

投放信息

active

激活数

long

是

否

投放信息

active_cost

激活消耗(RMB分)

long

否

否

投放信息

convert

转化数

long

是

否

投放信息

convert_cost

转化消耗(RMB分)

long

否

否

错误码

错误信息

建议操作

0

success

成功

400006

parameter is unauthorized

未识别信息

400007

parameter is invalid

检查参数格式是否正确

401002

user unauthorized

检查是否有signature参数，若有，请核查signature计算方式是否正确

401004

ad parameter is empty

检查广告维度信息是否为空

401005

ad stat parameter is empty

检查广告投放数据是否为空

401006

time parameter is empty

检查是否有时间参数，若有，请检查时间格式是否正确

401007

required parameter is empty

检查必填参数是否丢失（具体参数请参考第二步第3点-请求参数上报）

401009

platform parameter is empty

检查渠道信息是否为空

401010

request reach limitation error

检查请求参数是否超限

500000

unknown error

服务内部错误，联系AdSpark(增长参谋)

500001

internal error

服务内部错误，联系AdSpark(增长参谋)

500102

illegal request in MW error

服务内部错误，联系增AdSpark(增长参谋)