taobao.brandhub.specialshow.rpt.adgroup.get (品牌号品牌特秀单元报表数据查询)

获取品牌号品牌特秀广告adgroup分日报表数据,只能查询近90天内的数据,包括展现量,点击量等

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_date String 必须 2019-04-07 开始时间(最多可查询最近90天)
solution_id String 可选 123 指定计划id
task_id String 可选 123 指定任务id
end_date String 必须 2019-06-01 截至时间(最晚到昨天)
page_index String 可选 1 当前页数
page_size String 可选 20 可选页数

响应参数

名称 类型 示例值 描述
error_param String intenal-error 错误信息
adgroup_rpt_list Result [] {200} 返回结果
  • └ thedate
  • String
  • 2019-05-01
  • 日期
  • └ solution_id
  • Number
  • 12345
  • 计划id
  • └ solution_name
  • String
  • 计划1
  • 计划名称
  • └ target_name
  • String
  • 定向条件
  • 定向条件
  • └ task_id
  • Number
  • 12345
  • 单元id
  • └ task_name
  • String
  • 单元名称
  • 单元名称
  • └ impression
  • String
  • 12345
  • 展现
  • └ click
  • String
  • 1234
  • 点击
  • └ uv
  • String
  • 123
  • 访客数
  • └ click_uv
  • String
  • 1234
  • 点击访客数
  • └ ctr
  • String
  • 0.123
  • 点击率
  • └ uv_ctr
  • String
  • 0.123
  • 访客点击率

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BrandhubSpecialshowRptAdgroupGetRequest req = new BrandhubSpecialshowRptAdgroupGetRequest();
req.setStartDate("2019-04-07");
req.setSolutionId("123");
req.setTaskId("123");
req.setEndDate("2019-06-01");
req.setPageIndex("1");
req.setPageSize("20");
BrandhubSpecialshowRptAdgroupGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<brandhub_specialshow_rpt_adgroup_get_response>
    <error_param>intenal-error</error_param>
    <adgroup_rpt_list>
        <result>
            <thedate>2019-05-01</thedate>
            <solution_id>12345</solution_id>
            <solution_name>计划1</solution_name>
            <target_name>定向条件</target_name>
            <task_id>12345</task_id>
            <task_name>单元名称</task_name>
            <impression>12345</impression>
            <click>1234</click>
            <uv>123</uv>
            <click_uv>1234</click_uv>
            <ctr>0.123</ctr>
            <uv_ctr>0.123</uv_ctr>
        </result>
    </adgroup_rpt_list>
</brandhub_specialshow_rpt_adgroup_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部