全部产品
云市场

推广主报表API

更新时间:2018-04-20 13:51:16

提供用户查看营销效果相关报表。

具体域名请联系阿里云营销引擎技术支持获取。

推广主未来3个月推广计划排期(GetAdvThreeMonthPlanRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/adv_three_month_plan/

参数列表

参数 类型 必填 描述

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/adv_three_month_plan/

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据,每个月排期时间
errorCode 错误码
message 错误提示信息

返回样例

JSON返回

  1. {
  2. "data": [
  3. ["2017-01-10", "2017-01-11", "2017-01-30"],
  4. ["2017-02-01", "2017-02-23", "2017-02-22", "2017-02-21"],
  5. ["2017-03-13"]
  6. ],
  7. "result": "SUCCESS"
  8. }

推广主计划效果报表详细数据(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_adplan_statement/${start_time}/${end_time}?hour=${hour}&page=${page}&size=${size}&ad_plan_id=${ad_plan_id}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
ad_plan_id long N 推广计划ID
ad_group_id long N 推广组ID
ad_creative_id long N 创意ID
hour boolean Y 是否是24小时报表(false:不是,true:是)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_adplan_statement/2017-01-01/2017-01-07?hour=false

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
clicks 有效点击数
conversion_num 有效转化数
bid_type 结算类型

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "clicks": 0,
  14. "conversion_num": 0,
  15. "bid_type": 1
  16. }]
  17. },
  18. "result": "SUCCESS"
  19. }

推广主推广组效果报表详细数据(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_adgroup_statement/${start_time}/${end_time}?hour=${hour}&page=${page}&size=${size}&ad_group_id=${ad_group_id}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
ad_plan_id long N 推广计划ID
ad_group_id long N 推广组ID
ad_creative_id long N 创意ID
hour boolean Y 是否是24小时报表(false:不是,true:是)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_adgroup_statement/2017-01-01/2017-01-07?hour=false

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
clicks 有效点击数
conversion_num 有效转化数
bid_type 结算类型

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "clicks": 0,
  14. "conversion_num": 0,
  15. "bid_type": 1
  16. }]
  17. },
  18. "result": "SUCCESS"
  19. }

推广主效果报表详细数据(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_creative_statement/${start_time}/${end_time}?hour=${hour}&page=${page}&size=${size}&ad_creative_id=${ad_creative_id}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
ad_plan_id long N 推广计划ID
ad_group_id long N 推广组ID
ad_creative_id long N 创意ID
hour boolean Y 是否是24小时报表(false:不是,true:是)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_creative_statement/2017-01-01/2017-01-07?hour=false

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
clicks 有效点击数
conversion_num 有效转化数
bid_type 结算类型

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "clicks": 0,
  14. "conversion_num": 0,
  15. "bid_type": 1
  16. }]
  17. },
  18. "result": "SUCCESS"
  19. }

推广主效果报表详细数据(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_statement_detail/${start_time}/${end_time}?hour=${hour}&page=${page}&size=${size}&ad_plan_id=${ad_plan_id}&ad_group_id=${ad_group_id}&ad_creative_id=${ad_creative_id}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
ad_plan_id long N 推广计划ID
ad_group_id long N 推广组ID
ad_creative_id long N 创意ID
hour boolean Y 是否是24小时报表(false:不是,true:是)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_statement_detail/2017-01-01/2017-01-07?hour=false

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
clicks 有效点击数
conversion_num 有效转化数
bid_type 结算类型

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "clicks": 0,
  14. "conversion_num": 0,
  15. "bid_type": 1
  16. }]
  17. },
  18. "result": "SUCCESS"
  19. }

推广主媒体效果报表详细数据(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_media_statement/${media_type}=${media_type}&third_party_type=${third_party_type}&media_id=${media_id}&hour=${hour}&page=${page}&size=${size}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
hour boolean Y 是否是24小时报表(false:不是,true:是)
media_category_id string N 媒体资源位id多值列
media_type string N 媒体类型id多值列
third_party_type int N 第三方类型(1:阿里妈妈Tanx;2:二方媒体;3:百度流量交易服务(Baidu Exchange Service);4:腾讯广告实时交易平台(Tencent AdExchange);5:Google DoubleClick)
media_id long N 媒体id
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_media_statement/2017-01-01/2017-01-07?hour=false

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
clicks 有效点击数
conversion_num 有效转换数

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "clicks": 0,
  14. "conversion_num": 0
  15. }]
  16. },
  17. "result": "SUCCESS"
  18. }

推广主人群报表(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_crowd_statement/${start_time}/${end_time}=${media_type}&third_party_type=${third_party_type}&media_id=${media_id}&hour=${hour}&page=${page}&size=${size}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
page int N 当前页码,默认1
size int N 一页展现条数,默认10
hour boolean Y 是否是24小时报表(false:不是,true:是)
media_category_id string N 媒体资源位id多值列
media_type string N 媒体类型id多值列
third_party_type int N 第三方类型(1:阿里妈妈Tanx;2:二方媒体;3:百度流量交易服务(Baidu Exchange Service);4:腾讯广告实时交易平台(Tencent AdExchange);5:Google DoubleClick)
media_id long N 媒体id
group_id long N 人群id

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_crowd_statement/2017-01-01/2017-01-07

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
show_num 有效展示数
download_num 有效下载数
total_download_num 所有下载数
total_conversion_num 所有转化数
statement_time 报表时间
ad_cost 消耗金额(元)
total_show_num 所有展示数
total_click_num 所有点击数
click_num 有效点击数
conversion_num 有效转换数

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "show_num": 4,
  6. "download_num": 0,
  7. "total_download_num": 0,
  8. "total_conversion_num": 0,
  9. "statement_time": "2017-01-05",
  10. "ad_cost": 0.012,
  11. "total_show_num": 14,
  12. "total_click_num": 0,
  13. "click_num": 0,
  14. "conversion_num": 0,
  15. "bid_type": 1
  16. }]
  17. },
  18. "result": "SUCCESS"
  19. }

推广主交易报表(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement/${start_time}/${end_time}?page=${page}&size=${size}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement/2017-01-01/2017-01-07

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
type 交易类型(1:充值;2:消费;3:退款)
date 操作日期
amount 金额

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "date": "2016-12-08 00:00:00",
  6. "amount": 100,
  7. "type": 3
  8. }]
  9. },
  10. "result": "SUCCESS"
  11. }

推广主交易明细报表(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_statement_detail/${start_time}/${end_time}?page=${page}&size=${size}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_effect_statement_detail/2017-01-01/2017-01-01

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
type 交易类型(1:充值;2:消费;3:退款)
date 操作日期
amount 金额
date 操作时间
balance 余额

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "amount": 0.000,
  6. "balance": 0.000,
  7. "date": "2017-10-26 01:54:03",
  8. "type": 2
  9. }]
  10. },
  11. "result": "SUCCESS"
  12. }

推广主最近一次充值交易(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_latest_recharge_cost/${start_time}/${end_time}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd),填写当天时间
end_time string Y 结束时间(yyyy-mm-dd),填写当天时间
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

  1. http://xxxxxx.aliyuncs.com/advstatement/query/adv_latest_recharge_cost/2017-01-01/2017-01-07

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回查询数据
errorCode 错误码
message 错误提示信息
type 交易类型(1:充值;2:消费;3:退款)
date 操作日期
amount 金额

返回样例

JSON返回

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "date": "2016-12-08 00:00:00",
  6. "amount": 100,
  7. "type": 3
  8. }]
  9. },
  10. "result": "SUCCESS"
  11. }