文档中心 > API类目 > 淘宝客API

taobao.tbk.sc.ucrowd.report.get (淘宝客-服务商-人群推广效果)

服务商使用。支持淘宝客通过入参人群标签id,获得人群的推广和转化效果数据。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ucrowd_id Number 必须 123 人群标签id
report_date String 必须 2020-12-30 报表日期,支持:月、日,示例:2020-12,2020-12-30

响应参数

名称 类型 示例值 描述
data RpcResult data
  • ucrowd_report
  • DwsUnionAppDto
  • ucrowd_report
  • └ alipay_user_num_in_ucrowd
  • Number
  • 30
  • 人群内成交人数
  • └ alipay_user_num
  • Number
  • 33
  • 支付人数
  • └ pre_pub_share_fee
  • String
  • 100.1
  • 付款预估收入。指买家付款金额为基数,预估您可能获得的收入。因买家退款等原因,可能与结算预估收入不一致
  • └ alipay_amt
  • String
  • 1111.22
  • 支付金额
  • └ alipay_num
  • Number
  • 2323
  • 支付订单数
  • └ click_uv_union
  • Number
  • 12
  • 点击人数
  • └ click_pv_union
  • Number
  • 20
  • 点击数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScUcrowdReportGetRequest req = new TbkScUcrowdReportGetRequest();
req.setUcrowdId(123L);
req.setReportDate("2020-12-30");
TbkScUcrowdReportGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_sc_ucrowd_report_get_response>
    <data>
        <ucrowd_report>
            <alipay_user_num_in_ucrowd>30</alipay_user_num_in_ucrowd>
            <alipay_user_num>33</alipay_user_num>
            <pre_pub_share_fee>100.1</pre_pub_share_fee>
            <alipay_amt>1111.22</alipay_amt>
            <alipay_num>2323</alipay_num>
            <click_uv_union>12</click_uv_union>
            <click_pv_union>20</click_pv_union>
        </ucrowd_report>
    </data>
</tbk_sc_ucrowd_report_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

返回
顶部