文档中心 > API类目 > 万相台无界API

taobao.universalbp.new.report.chargesum (账户花费数据汇总)

消耗汇总

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
report_query_v_o ReportQueryVO 必须 reportQueryVO
  • └ split_type
  • String
  • 可选
  • hour
  • 汇总类型 sum-汇总,hour-分时,day-分天,week-分周,month-分月
  • └ unify_type
  • String
  • 可选
  • zhai
  • 归因口径,zhai-末次点击归因, mta-mta归因
  • └ start_time
  • String
  • 可选
  • 2023-06-06
  • 开始时间
  • └ end_time
  • String
  • 可选
  • 2023-06-12
  • 结束时间
  • └ effect_equal
  • Number
  • 可选
  • 15
  • 归因周期,1、3、7、15、30
  • └ biz_code_in_list
  • String []
  • 可选
  • [onebpDisplay]
  • 场景筛选code
  • └ query_domains
  • String []
  • 可选
  • [account, campaign]
  • 聚合维度,可用值和选择对应报表类型一致
  • └ query_field_in_list
  • String []
  • 可选
  • adPv
  • 需要下载的指标数据
  • └ rpt_type
  • String
  • 可选
  • crowd
  • 报表类型
  • └ offset
  • Number
  • 可选
  • 10
  • 偏移量
  • └ page_size
  • Number
  • 可选
  • 10
  • 页面大小

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • top_charge_sum_v_o
  • TopChargeSumVO
  • 结果集
  • └ total_charge
  • String
  • 2690.00
  • 总花费
  • └ crowd_scene_charge
  • String
  • 2690.00
  • 消费者运营花费
  • └ item_scene_charge
  • String
  • 2690.00
  • 货品运营花费
  • └ activity_scene_charge
  • String
  • 2690.00
  • 活动场景消耗
  • └ display_charge
  • String
  • 2690.00
  • 人群场景
  • └ search_charge
  • String
  • 2690.00
  • 关键词场景
  • └ content_scene_charge
  • String
  • 2690.00
  • 内容场景
  • └ shop_scene_charge
  • String
  • 2690.00
  • 店铺运营消耗
  • └ multi_aim_scene_charge
  • String
  • 2690.00
  • 多目标智投
  • └ onebp_site_charge
  • String
  • 2690.00
  • 全站推广
  • └ ybq_gift_charge
  • String
  • 2690.00
  • 新品一笔钱消耗
  • └ guarantee_pack_charge
  • String
  • 2690.00
  • 确定性保障套餐包消耗

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewReportChargesumRequest req = new UniversalbpNewReportChargesumRequest();
UniversalbpNewReportChargesumRequest.TopServiceContext obj1 = new UniversalbpNewReportChargesumRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewReportChargesumRequest.ReportQueryVO obj2 = new UniversalbpNewReportChargesumRequest.ReportQueryVO();
obj2.setSplitType("hour");
obj2.setUnifyType("zhai");
obj2.setStartTime("2023-06-06");
obj2.setEndTime("2023-06-12");
obj2.setEffectEqual(15L);
obj2.setBizCodeInList("onebpDisplay");
obj2.setQueryDomains("account, campaign");
obj2.setQueryFieldInList("adPv");
obj2.setRptType("crowd");
obj2.setOffset(10L);
obj2.setPageSize(10L);
req.setReportQueryVO(obj2);
UniversalbpNewReportChargesumResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_report_chargesum_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <top_charge_sum_v_o>
            <total_charge>2690.00</total_charge>
            <crowd_scene_charge>2690.00</crowd_scene_charge>
            <item_scene_charge>2690.00</item_scene_charge>
            <activity_scene_charge>2690.00</activity_scene_charge>
            <display_charge>2690.00</display_charge>
            <search_charge>2690.00</search_charge>
            <content_scene_charge>2690.00</content_scene_charge>
            <shop_scene_charge>2690.00</shop_scene_charge>
            <multi_aim_scene_charge>2690.00</multi_aim_scene_charge>
            <onebp_site_charge>2690.00</onebp_site_charge>
            <ybq_gift_charge>2690.00</ybq_gift_charge>
            <guarantee_pack_charge>2690.00</guarantee_pack_charge>
        </top_charge_sum_v_o>
    </top_result>
</universalbp_new_report_chargesum_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

返回
顶部