# 获取服务商广告明细数据
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
GetAgencyAdsDetail
# 功能描述
该 API 用于获取授权服务商进行流量主代运营,分小程序产生的广告细分数据,最小颗粒度为广告单元id(aduint)。使用过程中如遇到问题,可在开放平台服务商专区交流专区 | 微信开放社区发帖交流。
# 注意事项
其中access_token为component_access_token
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/getdefaultamsinfo?action=get_agency_ads_detail&access_token=xxxxxxxxxxxxxxx
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
page | number | 是 | 返回第几页数据 |
page_size | number | 是 | 当页返回数据条数(最大为200) |
start_date | string | 是 | 获取数据的开始时间yyyy-mm-dd |
end_date | string | 是 | 获取数据的结束时间yyyy-mm-dd |
ad_slot | string | 否 | 广告位类型名称 |
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ret | number | 错误码 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
err_msg | string | 返回错误信息 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
list | array<object> | list | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
total_num | number | 请求返回总条数 |
# 其他说明
请注意: 返回list中的项按照date降序排列,用户请以分页的形式获取。当需要获取全部广告位的细分数据时,无需传递广告位类型名称;当需要获取某类型广告位的细分数据时,需传递广告位类型名称。
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"page": 1,
"page_size": 8,
"start_date": "2020-04-10",
"end_date": "2020-04-10",
"ad_slot": "SLOT_ID_WEAPP_REWARD_VIDEO"
}
# 返回数据示例
{
"ret":0
"err_msg":"",//仅在有错误时返回
"list":[
{
"ad_unit_id":"adunit-9cedd8514XXXX",
"ad_unit_name":"激励视频长广告",
"stat_item":{
"ad_slot":"SLOT_ID_WEAPP_REWARD_VIDEO",
"date":"2020-04-10",
"req_succ_count":138250,
"exposure_count":74771,
"exposure_rate":0.54083906,
"click_count":2242,
"click_rate":0.029984887,
"income":187766,
"ecpm":6.790813743,
"publisher_income":93883,
"agency_income":93883
}
"appid":"wxf3dsfsfsdf13d"
}
],
"total_num":1
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
0 | ok | ok |
-202 | 内部错误 | 可在一段时间后重试 |
1700 | 参数错误 | 检验输入参数是否符合文档说明 |
1701 | 参数错误 | 检验输入参数是否符合文档说明 |
1737 | 操作过快 | 等待一分钟后重新操作 |
2056 | 服务商未在变现专区开通账户 | 在第三方平台页面的变现专区开通服务 |