报告模块
所有文档

          百度信息流推广API

          报告模块

          实时报告请求对象

          字段名称 类型 描述 限制
          performanceData array(string) 指定返回数据 必填(取值范围中任意一个)
          取值范围:
          impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost
          针对不同的物料层级,其合法的取值范围不同,(按照第一个请求的字段排序)请参见规则描述
          说明:impression(展现)、click(点击)、cost(消费)、ctr(点击率)、cpc(平均点击价格)、cpm(千次展现消费)、aggrformsubmitsuccess(表单提交成功量)、aggrordersubmitsuccess(订单提交成功量)、aggreffectiveconsults(有效咨询量)、highqualityconsults(高质量咨询量)、aggrformclicksuccess(表单按钮点击量)、aggrreverseclicks(表单调起按钮点击量)、aggrconcultclicks(咨询按钮点击量)、aggrphoneclicks(电话按钮点击量)、activeconversions(APP激活量)、activecost(APP激活成本)、appregisterconversions(注册量)、appregistercost(注册成本)、apppayconversions(付费量)、apppaycost(付费成本)、ocpctranstype(转化目标)、ocpctargettrans(目标转化量)、ocpctargettranscpc(目标转化成本)、ocpctargettransratio(目标转化率)、ocpx信息 aggrpageviews(营销页浏览量)、aggrtongjiconversions(百度统计转化量)、effectiveclient(有效获客量-客户自定义量)、effectiveclientcost(有效获客成本-客户自定义成本)、weixincopyconversions(微信复制按钮点击量)、weixincopyconversionscost(微信复制按钮点击成本)、ecbuy(商品下单成功量)、ecbuycost(商品下单成功成本)、ecshoppingcart(加入购物车量)、ecshoppingcartcost(加入购物车成本)、ecfavorite(商品收藏量)、ecfavoritecost(商品收藏成本)、ecpagearrival(商品详情页到达量)、ecpagearrivalcost(商品详情页到达成本)、reservedownloadconversions(预约按钮点击量)、ecpaidsuccess(商品支付成功量)、ecpaidsuccesscost(商品支付成功成本)、phonedialupconversions(电话拨通量)、phonedialupconversionscost(电话拨通成本)、retentions(次日留存量)、retentionscost(次日留存成本)、keybehavior(关键行为量-客户自定义量)、keybehaviorcost(关键行为成本-客户自定义成本)、ordersubmit(商品下单成功量)、deepordersubmitcost(商品下单成功成本)、aggrminiprogramformsubmit(表单提交成功量)、aggrminiprogramformsubmitcost(表单提交成功成本)、mpordersuccess(商品下单成功量)、mpordersuccesscost(商品下单成功成本)、mpcallbuttonclicks(电话按钮点击量)、mpcallbuttonclickscost(电话按钮点击成本)、mpeffectiveconsults(有效咨询量)、mpeffectiveconsultscost(有效咨询成本)、mpthreeconsults(高质量咨询量)、mpthreeconsultscost(高质量咨询成本)、advisorycluecount(咨询留线索量)、advisorycluecountcost(咨询留线索量成本)、completePlayCount(播放完成数)、completePlayRatio(播放完成率)、playCount1(25%进度播放数)、playCount2 (50%进度播放数)、playCount3(75%进度播放数)、playCount4(100%进度播放数)、avgPlayTime(平均播放时长)、completePlayCost(播放完成成本)、deeppagevisitconversions(深度页面访问量)、deeppagevisitconversionscost(深度页面访问成本)
          order boolean 是否为降序排列 选填,默认null,按照时间排序:
          true-降序
          false-升序
          startDate string 统计开始时间,格式参考:
          2016-11-25
          必填
          说明:开始时间不能早于2016-11-25
          endDate string 统计结束时间,格式参考:
          2016-11-30
          必填
          说明:不能晚于当前时间,不能早于开始时间
          levelOfDetails number 指定返回的数据层级 选填,默认为账户
          2:账户粒度
          3:计划粒度
          5:单元粒度
          7:创意粒度
          reportType number 实时数据类型 必填
          700:账户报告
          701:计划报告
          702:单元报告
          703:创意报告
          706:地域报告
          725:ocpx报告
          757:媒体ID报告(媒体ID报告目前有权限限制,仅限开通媒体ID定向的账户使用)
          705:程序化创意组合报告
          statIds array(number) 统计范围下的id集合。根据StatRange的不同类型填写不同id 选填,默认NULL,表示统计范围为全账户
          staRange为3时填写计划id
          staRange为5时填写单元id
          staRange为7时填写创意id
          statRange number 统计范围 选填,默认值为2
          2:账户范围:
          3:计划范围
          5:单元范围
          7:创意范围
          注意:统计范围不能细于当前的统计粒度,例如统计粒度为计划,则统计范围不能细到单元
          unitOfTime number 统计时间单位 选填,默认值为5
          取值范围:
          5:分日
          4:分周
          3:分月
          7:分时
          8:请求时间段汇总(endDate-StartDate)
          number number 返回数据条数 选填
          目前实时报告中账户、计划、单元、创意报告最大支持10000条
          默认值1000条
          注意:超过限制或者小于等于0则报错
          producttype number 版位 取值范围:
          0-全部
          1-列表页
          2-详情页
          subject number 推广对象 选填,默认值为0
          0:全部
          1:网站链接
          2:应用下载(IOS)
          3:应用下载(ANDROID)
          注意:账户报告不支持此字段
          bidType array(string) 出价模式 ocpx才有用
          ["3"]:ocpx
          ["5"]:ecpc
          ["3","5"]:ocpx+ecpc
          payMode array(string) 付费模式 ocpx才有用
          ["0","1"]:ocpc
          ["2"]:ocpm
          ["0","1","2"]:ocpx
          materialStyle number 样式类型 选填,默认值为0
          0:全部
          1:单图
          2:三图
          3:大图
          4:视频
          5:橱窗
          6:开屏
          7:横幅
          注意:仅创意报告支持此字段
          pageIndex number 分页 (选填)请求页码
          说明:默认不分页
          当不填写页码或页码参数为<=0时,代表未分页;
          请求页码设置大于0时,代表分页请求(同时需要配合number字段)
          bstype number bstype 选填(不填返回全部)
          0:全部
          1:普通报告
          3:闪投报告
          7:原生RTA

          实时报告返回对象

          字段名称 类型 描述
          ID Long 请求对象的ID(ocpx报告、媒体ID报告,地域报告此字段无用,固定为0)
          name String[] 请求对象的name,数组形式,不同报告形式的不同定义规则见name字段规则
          Date String 统计开始时间
          KPIs String[] 按照请求顺序,返回KPI数据数组
          relateIdsList Long[] 依次记录四个层级id, 账户、计划、单元、创意。
          说明:
          当relateIdsList长度为1时,记录对应的账户id。
          当relateIdsList长度为2时,记录对应的账户id、计划id。
          当relateIdsList长度为3时,记录对应的账户id、计划id、单元id。
          当relateIdsList长度为4时,记录对应的账户id、计划id、单元id、创意id。
          对应id获取不到时用-1指代。

          name字段规则

          其中name字段根据不同的报告类型,数组长度和各个位置代表的意义不一样,规则分别如下:

          报告类型 NAME字段规则
          账户报告 账户名
          计划报告 账户名,计划名
          单元报告 账户名,计划名,单元名
          创意报告 账户名,计划名,单元名,创意名称,标题,图片数量,url
          程序化创意组合报告 账户名,计划名,单元名,创意名,创意URL,组合ID,标题,图片/视频URL,探索状态

          name字段是字符串数组类型,规则中按照“,”分割各个数组位需要填入的实际字段名,若某数组位的字段值为空值,则用“-”代替。

          异步报告请求对象

          字段名称 类型 描述 限制
          performanceData array(string) 指定返回数据 必填(取值范围中任意一个)
          取值范围:
          impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost
          针对不同的物料层级,其合法的取值范围不同,(按照第一个请求的字段排序)请参见规则描述
          说明:impression(展现)、click(点击)、cost(消费)、ctr(点击率)、cpc(平均点击价格)、cpm(千次展现消费)、aggrformsubmitsuccess(表单提交成功量)、aggrordersubmitsuccess(订单提交成功量)、aggreffectiveconsults(有效咨询量)、highqualityconsults(高质量咨询量)、aggrformclicksuccess(表单按钮点击量)、aggrreverseclicks(表单调起按钮点击量)、aggrconcultclicks(咨询按钮点击量)、aggrphoneclicks(电话按钮点击量)、activeconversions(APP激活量)、activecost(APP激活成本)、appregisterconversions(注册量)、appregistercost(注册成本)、apppayconversions(付费量)、apppaycost(付费成本)、 ocpx信息、aggrpageviews(营销页浏览量)、aggrtongjiconversions(百度统计转化量)、effectiveclient(有效获客量-客户自定义量)、effectiveclientcost(有效获客成本-客户自定义成本)、weixincopyconversions(微信复制按钮点击量)、weixincopyconversionscost(微信复制按钮点击成本)、ecbuy(商品下单成功量)、ecbuycost(商品下单成功成本)、ecshoppingcart(加入购物车量)、ecshoppingcartcost(加入购物车成本)、ecfavorite(商品收藏量)、ecfavoritecost(商品收藏成本)、ecpagearrival(商品详情页到达量)、ecpagearrivalcost(商品详情页到达成本)、reservedownloadconversions(预约按钮点击量)、ecpaidsuccess(商品支付成功量)、ecpaidsuccesscost(商品支付成功成本)、phonedialupconversions(电话拨通量)、phonedialupconversionscost(电话拨通成本)、retentions(次日留存量)、retentionscost(次日留存成本)、keybehavior(关键行为量-客户自定义量)、keybehaviorcost(关键行为成本-客户自定义成本)、ordersubmit(商品下单成功量)、deepordersubmitcost(商品下单成功成本)、aggrminiprogramformsubmit(表单提交成功量)、aggrminiprogramformsubmitcost(表单提交成功成本)、mpordersuccess(商品下单成功量)、mpordersuccesscost(商品下单成功成本)、mpcallbuttonclicks(电话按钮点击量)、mpcallbuttonclickscost(电话按钮点击成本)、mpeffectiveconsults(有效咨询量)、mpeffectiveconsultscost(有效咨询成本)、mpthreeconsults(高质量咨询量)、mpthreeconsultscost(高质量咨询成本)、advisorycluecount(咨询留线索量)、advisorycluecountcost(咨询留线索量成本)、completePlayCount(播放完成数)、completePlayRatio(播放完成率)、playCount1(25%进度播放数)、playCount2 (50%进度播放数)、playCount3(75%进度播放数)、playCount4(100%进度播放数)、avgPlayTime(平均播放时长)、completePlayCost(播放完成成本)、deeppagevisitconversions(深度页面访问量)、deeppagevisitconversionscost(深度页面访问成本)
          startDate string 统计开始时间,格式参考:
          2016-11-25
          必填
          2016-12-25
          说明:开始时间不能早于2016-11-25
          endDate string 统计结束时间,格式参考:
          2016-11-30
          必填
          idOnly boolean 是否只需要id 选填;默认为false
          取值范围:
          true:只获取id
          false:既获取id也获取字面
          levelOfDetails number 统计粒度 选填;不同的ReportType对应的默认值和取值范围不同,请参见规则描述
          2:账户粒度
          3:计划粒度
          5:单元粒度
          7:创意粒度
          format number 报告文件格式 选填,默认值为2;
          2:csv格式
          reportType number 报告类型 必填;
          700:账户报告
          701:计划报表
          702:单元报告
          703:创意报告
          706:地域报告
          725:ocpx报告
          757:媒体ID报告(媒体ID报告目前有权限限制,仅限开通媒体ID定向的账户使用)
          705:程序化创意组合报告
          statIds array(number) 统计范围下的id集合。根据StatRange的不同类型填写不同id 选填,默认NULL,表示统计范围为全账户
          staRange为3时填写计划id
          staRange为5时填写单元id
          staRange为7时填写创意id
          statRange number 统计范围 选填,默认值为2;
          2:账户范围
          3:计划范围
          5:单元范围
          7:创意范围
          注意:统计范围不能细于当前的统计粒度,例如统计粒度为计划,则统计范围不能细到单元
          unitOfTime number 统计时间单位 选填,默认值为5
          取值范围:
          5:日报
          4:周报
          3:月报
          7:分时报
          8:请求时间段汇总(endDate-StartDate)
          subject number 推广对象 选填,默认值为0
          0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          注意:账户报告不支持此字段
          materialStyle number 样式类型 0:全部
          1:单图
          2:三图
          3:大图
          4:视频
          5:橱窗
          6:开屏
          7:横幅
          注意:仅创意报告支持此字段
          producttype number 版位 取值范围:
          0-全部
          1-列表页
          2-详情页
          bidType array(string) 出价模式 ocpx才有用
          ["3"]:ocpx
          ["5"]:ecpc
          ["3","5"]:ocpx+ecpc
          payMode array(string) 付费模式 ocpx才有用
          ["0","1"]:ocpc
          ["2"]:ocpm
          ["0","1","2"]:ocpx
          bstype number bstype 选填(不填返回全部)
          0:全部
          1:普通报告
          3:闪投报告
          7:原生RTA

          获取实时报告

          接口描述

          请求账户,计划,单元,创意4种绩效数据报告,请求时提供所需数据报告的条件,返回本次请求数据。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/ReportFeedService/getRealTimeFeedData

          请求参数说明

          字段名称 类型 描述
          realTimeRequestType object 具体类型见实时报告请求对象

          响应参数说明

          字段名称 类型 描述
          - array(object) 具体类型见实时报告返回对象

          请求示例

          POST /v1/feed/cloud/ReportFeedService/getRealTimeFeedData HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
              },
              "body": {
                  "realTimeRequestType": {
                      "producttype": 0,
                      "endDate": "2019-02-22",
                      "levelOfDetails": 2,
                      "number": 1000,
                      "order": true,
                      "performanceData": [
                          "cost",
                          "impression",
                          "click",
                          "cpm",
                          "ctr",
                          "cpc"
                      ],
                      "reportType": 700,
                      "startDate": "2019-02-21",
                      "statRange": 2,
                      "unitOfTime": 7,
                      "bstype":0
                  }
              }
          }

          响应示例

          {
              "header":{
          		"oprs": 1,
          		"failures": [],
          		"succ": 1,
          		"oprtime": 0,
          		"desc": "success",
          		"status": 0
              },
              "body":{
                  "data":[
                      {
                          "id": 1234,
                          "kpis": [
                              "12.3",
                              "100",
                              "10",
                              "123",
                              "0.1",
                              "1.23"
                          ],
                          "name": [
                              "账户名"
                          ],
                          "date": "2019-02-22 17:00"
                      }
                  ]
              }
          }

          获取异步报告

          接口描述

          请求绩效数据报告,请求时提供所需数据报告的条件,返回本次请求的reportId。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/ReportFeedService/getReportFeedId

          请求参数说明

          字段名称 类型 描述
          reportRequestType object 具体类型见异步报告请求对象

          响应参数说明

          字段名称 类型 描述
          reportId string 生成的报告ID,为一串MD5值

          请求示例

          POST /v1/feed/cloud/ReportFeedService/getReportFeedId HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
              },
              "body": {
                  "reportRequestType": {
                      "producttype": 0,
                      "endDate": "2019-02-22",
                      "levelOfDetails": 2,
                      "order": true,
                      "performanceData": [
                          "cost",
                          "impression",
                          "click",
                          "cpm",
                          "ctr",
                          "cpc"
                      ],
                      "reportType": 700,
                      "startDate": "2019-02-21",
                      
                      "statRange": 2,
                      "unitOfTime": 7,
                      "bstype":0
                  }
              }
          }

          响应示例

          {
              "header":{
          		"oprs": 1,
          		"failures": [],
          		"succ": 1,
          		"oprtime": 0,
          		"desc": "success",
          		"status": 0
              },
              "body":{
                  "data":[
                      {
                          "reportId": "8e7e3f2d84a19c5df1415957434b2***"
                      }
                  ]
              }
          }

          获取异步报告状态

          接口描述

          查询报告当前的生成状态。请求中提供报告ID,返回中带有当前报告ID的处理状态。在获取Report下载url前,请调用此方法。待确认报表已生成时,再获取下载的url。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/ReportFeedService/getReportFeedState

          请求参数说明

          字段名称 类型 描述
          reportId string 生成的报告ID,为一串MD5值

          响应参数说明

          字段名称 类型 描述
          isGenerated number 报告生成状态,
          1:等待中
          2:处理中
          3:处理成功
          对于生成失败的报告返回null和对应的错误码

          请求示例

          POST /v1/feed/cloud/ReportFeedService/getReportFeedState HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header":{
          		"opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
              },
              "body":{
                  "reportId": "8e7e3f2d84a19c5df1415957434b2***"
              }
          }

          响应示例

          {
              "header":{
          		"oprs": 1,
          		"failures": [],
          		"succ": 1,
          		"oprtime": 0,
          		"desc": "success",
          		"status": 0
              },
              "body":{
                  "data":[
                      {
                          "isGenerated": 3
                      }
                  ]
              }
          }

          获取异步报告路径

          接口描述

          获取报告下载地址。当报告成功生成后,使用reportId请求,返回相应的报告下载地址。生成的url有效期为1小时,如果超时则需重新调用此方法,获取新的url。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/ReportFeedService/getReportFeedFileUrl

          请求参数说明

          字段名称 类型 描述
          reportId string 生成的报告ID,为一串MD5值

          响应参数说明

          字段名称 类型 描述
          reportFilePath string 下载地址,生成的url有效期为1小时,如果超时则需重新获取新的url
          对于生成失败或者正在生成中报告返回null和对应的错误码

          请求示例

          POST /v1/feed/cloud/ReportFeedService/getReportFeedFileUrl HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header":{
          		"opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
              },
              "body":{
                  "reportId": "8e7e3f2d84a19c5df1415957434b2***"
              }
          }

          响应示例

          {
              "header":{
          		"oprs": 1,
          		"failures": [],
          		"succ": 1,
          		"oprtime": 0,
          		"desc": "success",
          		"status": 0
              },
              "body":{
                  "data":[
                      {
                          "reportFilePath": "http://apidata.baidu.com/***"
                      }
                  ]
              }
          }

          报告规则

          整体规则:实时报告按照请求的顺序返回结果,异步报告相对顺序一致。

          账户报告

          查询条件 取值范围
          reportType 700
          startDate 不能早于20161125
          小时报的起始日期不能早于31天以前
          endDate 不能早于startDate
          levelOfDetails 2 (账户粒度)
          statRange 2 (账户范围)
          unitOfTime 5,4,3,7,8 (日报,周报,月报,分时报,请求时间段汇总)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          performanceData impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost、advisorycluecount、advisorycluecountcost、deeppagevisitconversions、deeppagevisitconversionscost
          说明:可只填写取值范围中任意一个,如:impression

          账户报告说明:materialStyle(样式类型)字段,请求时填写将会报错。

          计划报告

          查询条件 取值范围
          reportType 701
          startDate 不能早于20161125
          小时报的起始日期不能早于31天以前
          endDate 不能早于startDate
          levelOfDetails 3 (计划粒度)
          statRange 2,3(账户范围,计划范围)
          unitOfTime 5,4,3,7,8(日报,周报,月报,分时报,请求时间段汇总)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          performanceData impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost、advisorycluecount、advisorycluecountcost、deeppagevisitconversions、deeppagevisitconversionscost
          说明:可只填写取值范围中任意一个,如:impression

          计划报告说明:不支持materialStyle(样式类型)字段,请求时填写将会报错

          单元报告

          查询条件 取值范围
          reportType 702
          startDate 不能早于20161125
          小时报的起始日期不能早于31天以前
          endDate 不能早于startDate
          levelOfDetails 5(单元粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,7,8 (日报,周报,月报,分时报,请求时间段汇总)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          producttype 0-全部
          1-列表页
          2-详情页
          performanceData impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、ocpctranstype、ocpctargettrans、ocpctargettranscpc、ocpctargettransratio、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost、advisorycluecount、advisorycluecountcost、deeppagevisitconversions、deeppagevisitconversionscost
          说明:可只填写取值范围中任意一个,如:impression

          单元报告说明:不支持materialStyle(样式类型)字段,请求时填写将会报错

          创意报告

          查询条件 取值范围
          reportType 703
          startDate 不能早于20161125
          小时报的起始日期不能早于31天以前
          endDate 不能早于startDate
          levelOfDetails 7(创意粒度)
          statRange 2,3,5,7(账户范围,计划范围,单元范围,创意范围)
          unitOfTime 5,4,3,8,7(日报,周报,月报,请求时间段汇总,分时报)
          materialStyle 0:全部
          1:单图
          2:三图
          3:大图
          4:视频
          5:橱窗
          6:开屏
          7:横幅
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          producttype 0-全部
          1-列表页
          2-详情页
          performanceData impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、appregisterconversions、appregistercost、apppayconversions、apppaycost、ocpctranstype、ocpctargettrans、ocpctargettranscpc、ocpctargettransratio、aggrpageviews、aggrtongjiconversions、effectiveclient、effectiveclientcost、weixincopyconversions、weixincopyconversionscost、ecbuy、ecbuycost、ecshoppingcart、ecshoppingcartcost、ecfavorite、ecfavoritecost、ecpagearrival、ecpagearrivalcost、reservedownloadconversions、ecpaidsuccess、ecpaidsuccesscost、phonedialupconversions、phonedialupconversionscost、retentions、retentionscost、keybehavior、keybehaviorcost、ordersubmit、deepordersubmitcost、aggrminiprogramformsubmit、aggrminiprogramformsubmitcost、mpordersuccess、mpordersuccesscost、mpcallbuttonclicks、mpcallbuttonclickscost、mpeffectiveconsults、mpeffectiveconsultscost、mpthreeconsults、mpthreeconsultscost、advisorycluecount、advisorycluecountcost、completePlayCount、completePlayRatio、playCount1、playCount2、playCount3、playCount4、avgPlayTime、completePlayCost、deeppagevisitconversions、deeppagevisitconversionscost
          说明:可只填写取值范围中任意一个,如:impression

          ocpx报告

          查询条件 取值范围
          reportType 725
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 200(固定传值)
          statRange 2(账户范围)
          unitOfTime 5,4,3,8(日报,周报,月报,请求时间段汇总)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          bidType ["3"]:ocpx
          ["5"]:ecpc
          ["3","5"]:ocpx+ecpc
          payMode ["0","1"]:ocpc
          ["2"]:ocpm
          ["0","1","2"]:ocpx
          performanceData date(时间)
          unitinfo(单元信息)
          planinfo(计划信息)
          paysum(消费)
          ocpcstagestatus(转化阶段)
          ocpcstage2starttime(进入第二阶段时间)
          clks(点击)
          shows(展示)
          ocpctranstype(转化目标)
          ocpctargettrans(目标转化量)
          bidType(出价模式)
          paymode(付费模式)
          ocpctargettransratio(目标转化率)
          ocpctargettranscpc(目标转化成本)
          ocpclabstatus(是否实验室)
          registeruv(注册)
          consumeuv(付费)
          advisorycluecount(咨询留线索量)
          advisorycluecountcost(咨询留线索量成本)
          说明:clks,shows,date三个字段必填,其他字段可只填写取值范围中任意一个

          媒体ID报告(媒体ID报告目前有权限限制,仅限开通媒体ID定向的账户使用)

          查询条件 取值范围
          reportType 757
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2(账户范围) 3(计划范围) 5(单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,请求时段汇总)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          performanceData mediaId(媒体ID)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          aggrformsubmitsuccess(落地页转化-表单提交成功量)
          formsubmitcost(落地页转化-表单提交成功成本)
          aggrordersubmitsuccess(落地页转化-订单提交成功量)
          ordersubmitcost(落地页转化-订单提交成功成本)
          aggreffectiveconsults(落地页转化-有效咨询量)
          effectiveconsultcost(落地页转化-有效咨询成本)
          highqualityconsults(落地页转化-高质量咨询量)
          highqualityconsultscost(落地页转化-高质量咨询成本)
          aggrformclicksuccess(落地页转化-表单按钮点击量)
          aggrreverseclicks(落地页转化-表单调起按钮点击量)
          aggrconcultclicks(落地页转化-咨询按钮点击量)
          aggrphoneclicks(落地页转化-电话按钮点击量)
          activeconversions(APP转化-APP激活量)
          activecost(APP转化-APP激活成本)
          registeruv(APP转化-注册量)
          registeruvcost(APP转化-注册成本)
          consumeuv(APP转化-付费量)
          consumeuvcost(APP转化-付费成本)
          aggrpageviews(营销页浏览量)
          aggrtongjiconversions(百度统计转化量)
          effectiveclient(有效获客量-客户自定义量)
          effectiveclientcost(有效获客成本-客户自定义成本)
          weixincopyconversions(微信复制按钮点击量)
          weixincopyconversionscost(微信复制按钮点击成本)
          ecbuy(商品下单成功量)
          ecbuycost(商品下单成功成本)
          ecshoppingcart(加入购物车量)
          ecshoppingcartcost(加入购物车成本)
          ecfavorite(商品收藏量)
          ecfavoritecost(商品收藏成本)
          ecpagearrival(商品详情页到达量)
          ecpagearrivalcost(商品详情页到达成本)
          reservedownloadconversions(预约按钮点击量)
          ecpaidsuccess(商品支付成功量)
          ecpaidsuccesscost(商品支付成功成本)
          phonedialupconversions(电话拨通量)
          phonedialupconversionscost(电话拨通成本)
          retentions(次日留存量)
          retentionscost(次日留存成本)
          keybehavior(关键行为量-客户自定义量)
          keybehaviorcost(关键行为成本-客户自定义成本)
          ordersubmit(商品下单成功量)
          deepordersubmitcost(商品下单成功成本)
          aggrminiprogramformsubmit(表单提交成功量)
          aggrminiprogramformsubmitcost(表单提交成功成本)
          mpordersuccess(商品下单成功量)
          mpordersuccesscost(商品下单成功成本)
          mpcallbuttonclicks(电话按钮点击量)
          mpcallbuttonclickscost(电话按钮点击成本)
          mpeffectiveconsults(有效咨询量)
          mpeffectiveconsultscost(有效咨询成本)
          mpthreeconsults(高质量咨询量)
          mpthreeconsultscost(高质量咨询成本)
          deeppagevisitconversions(深度页面访问量)
          deeppagevisitconversionscost(深度页面访问成本)
          说明:mediaId字段必填,其他字段可只填写取值范围中任意一个

          地域报告

          查询条件 取值范围
          reportType 706
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3(日报,周报,月报)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          6:门店推广
          7:电商
          performanceData prov(省)
          city(市)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:prov字段必填,city字段选填,click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          小程序报告

          查询条件 取值范围
          reportType 754
          startDate 不能早于20161125
          endDate 不能早于startDate, unitOfTime=7时,endDate-startDatea<=31
          levelOfDetails 7(创意粒度)
          statRange 3,4,5(计划范围,单元范围,创意范围)
          unitOfTime 3,4,5,7,8(分月,分周,分日,分时,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          bstype 3(推广对象为商品且subject=0,其他推广对象不传该字段)
          performanceData shows(展现)
          click(点击)
          cpcpay(消费)
          cpc(平均点击价格)
          ctr(点击率)
          cpm(千次展现消费)

          意图词报告

          查询条件 取值范围
          reportType 730
          startDate 不能早于20161125
          endDate 时间选择跨度不得超过1年、起始时间不得晚于结束时间
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 3,4,5(分月,分周,分日)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          bstype 3(推广对象为商品且subject=0,其他推广对象不传该字段)
          performanceData shows(展现)
          click(点击)
          paysum(消费)
          cpc(平均点击价格)
          ctr(点击率)
          cpm(千次展现消费)

          程序化创意组合报告

          查询条件 取值范围
          reportType 705
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 7(创意粒度)
          statRange 2,7(账户范围,创意范围)
          unitOfTime 5,4,3,8(日报,周报,月报,请求时间段汇总)
          materialStyle 0:全部
          1:单图
          2:三图
          3:大图
          4:视频
          8:互动图
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)

          | | producttype | 0-全部
          1-列表页
          2-详情页 | | performanceData | impression、click、cost、ctr、cpc、cpm、aggrformsubmitsuccess、aggrordersubmitsuccess、aggreffectiveconsults、highqualityconsults、aggrformclicksuccess、aggrreverseclicks、aggrconcultclicks、aggrphoneclicks、activeconversions、activecost、deeppagevisitconversions、deeppagevisitconversionscost
          说明:可只填写取值范围中任意一个,如:impression |

          性别年龄学历报告

          查询条件 取值范围
          reportType 711
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData education(学历)
          genderinfo(性别)
          ageinfo(年龄)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:education、genderinfo和ageinfo只能三选一,不能同时请求。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          平台网络报告

          查询条件 取值范围
          reportType 717
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData feedostype(平台)
          nettype(网络)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:feedostype和nettype只能三选一,不能同时请求。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          商圈报告

          查询条件 取值范围
          reportType 746
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData feedregion(商圈)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:feedregion必填。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          场所报告

          查询条件 取值范围
          reportType 718
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData place(场所)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:place必填。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          APP分类报告

          查询条件 取值范围
          reportType 747
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData feedAppClass(APP一级分类)
          feedAppClass2(APP二级分类)
          feedAppClass3(APP三级分类)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:feedAppClass、feedAppClass2和feedAppClass3可以单独请求,也可以同时请求。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          APP名称报告

          查询条件 取值范围
          reportType 748
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData feedApp(APP名称)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:feedApp必填。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          人生阶段报告

          查询条件 取值范围
          reportType 751
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData lifestage(人生阶段)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:lifestage必填。click,impression,cost,ctr,cpc,cpm字段中选填任意一个

          文章类型报告

          查询条件 取值范围
          reportType 745
          startDate 不能早于20161125
          endDate 不能早于startDate
          levelOfDetails 2(账户粒度)
          statRange 2,3,5(账户范围,计划范围,单元范围)
          unitOfTime 5,4,3,8(日报,周报,月报,全部)
          subject 0:全部
          1:网站链接
          2:APP(IOS)
          3:APP(ANDROID)
          4:百度小程序
          6:门店推广
          7:电商
          performanceData feedTextSim(文章类型)
          click(点击)
          impression(展示)
          cost(消费)
          ctr(点击率)
          cpc(平均点击价格)
          cpm(千次展现消费)
          说明:feedTextSim必填。click,impression,cost,ctr,cpc,cpm字段中选填任意一个
          上一篇
          商品组模块
          下一篇
          批量物料下载模块