taobao.brand.brandshop.rpt.creative.get (品专计划维度报表数据透出)

获取品牌专区创意维度分日报表数据,只能查询近90天内的数据,包括展现量,点击量等

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traffic_type String 必须 1,2,4,5 流量类型 1: PC站内, 2: PC站外 , 4: 无线站内, 5: 无线站外,支持多种一起查询,如1,2,4,5
start_date String 必须 2017-03-07 开始时间(最多可查询最近90天)
end_date String 必须 2017-06-03 截至时间(最晚到昨天)
effect Number 可选 15
  • 默认值:15
  • 转化周期默认15天,3,7,15
    page_index String 可选 1 当前页数
    page_size String 可选 20 每页条数

    响应参数

    名称 类型 示例值 描述
    error_param String intenal-error 错误信息
    campaign_rpt_list Result [] {200} 返回结果
    • └ thedate
    • String
    • 2016-03-15
    • 日期
    • └ impression
    • Number
    • 111
    • 展现量
    • └ click
    • Number
    • 22
    • 点击量
    • └ ctr
    • String
    • 12
    • 点击率
    • └ cost
    • String
    • 11
    • 花费(元)
    • └ cpm
    • String
    • 1
    • 千次展现成本
    • └ cpc
    • String
    • 1
    • 点击单价
    • └ favitemtotal
    • Number
    • 1
    • 宝贝收藏数
    • └ transactionshippingtotal
    • Number
    • 1
    • 展示成交笔数
    • └ favshoptotal
    • Number
    • 1
    • 店铺收藏数
    • └ carttotal
    • Number
    • 1
    • 宝贝加购数
    • └ transactiontotal
    • String
    • 1
    • 展示成交金额
    • └ roi
    • String
    • 1
    • 展示回报率
    • └ cvr
    • String
    • 1
    • 展示转化率
    • └ click_transactionshipping
    • Number
    • 1
    • 点击成交笔数
    • └ click_transactiontotal
    • String
    • 1
    • 点击成交金额
    • └ click_roi
    • String
    • 1
    • 点击回报率
    • └ click_cvr
    • String
    • 1
    • 点击转化率
    • └ click_uv
    • Number
    • 1
    • 点击访客数
    • └ uv
    • Number
    • 1
    • 触达访客数
    • └ uv_new
    • Number
    • 1
    • 触达新访客数
    • └ campaigntitle
    • String
    • 测试campaign
    • 推广计划名称
    • └ campaignid
    • Number
    • 12345678
    • 推广计划id
    • └ adgroupid
    • Number
    • 123443
    • 推广组id
    • └ adgrouptitle
    • String
    • 推广单元名称
    • 推广组名称
    • └ creativeid
    • Number
    • 1
    • 创意id
    • └ creativetitle
    • String
    • 创意标题
    • 创意标题

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    BrandBrandshopRptCreativeGetRequest req = new BrandBrandshopRptCreativeGetRequest();
    req.setTrafficType("1,2,4,5");
    req.setStartDate("2017-03-07");
    req.setEndDate("2017-06-03");
    req.setEffect(15L);
    req.setPageIndex("1");
    req.setPageSize("20");
    BrandBrandshopRptCreativeGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <brand_brandshop_rpt_creative_get_response>
        <error_param>intenal-error</error_param>
        <campaign_rpt_list>
            <result>
                <thedate>2016-03-15</thedate>
                <impression>111</impression>
                <click>22</click>
                <ctr>12</ctr>
                <cost>11</cost>
                <cpm>1</cpm>
                <cpc>1</cpc>
                <favitemtotal>1</favitemtotal>
                <transactionshippingtotal>1</transactionshippingtotal>
                <favshoptotal>1</favshoptotal>
                <carttotal>1</carttotal>
                <transactiontotal>1</transactiontotal>
                <roi>1</roi>
                <cvr>1</cvr>
                <click_transactionshipping>1</click_transactionshipping>
                <click_transactiontotal>1</click_transactiontotal>
                <click_roi>1</click_roi>
                <click_cvr>1</click_cvr>
                <click_uv>1</click_uv>
                <uv>1</uv>
                <uv_new>1</uv_new>
                <campaigntitle>测试campaign</campaigntitle>
                <campaignid>12345678</campaignid>
                <adgroupid>123443</adgroupid>
                <adgrouptitle>推广单元名称</adgrouptitle>
                <creativeid>1</creativeid>
                <creativetitle>创意标题</creativetitle>
            </result>
        </campaign_rpt_list>
    </brand_brandshop_rpt_creative_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

    返回
    顶部