淘宝开放平台

登录
文档中心 > API类目 > 国际站外贸直通车API

国际站外贸直通车API

alibaba.scbp.ad.report.get.target.report (定向报告)

定向报告

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_context TopContextDto 必须 用户信息
  • └ product_line_id
  • Number
  • 必须
  • 110101
  • 产品线id
  • └ product_id
  • Number
  • 可选
  • 110101010
  • 产品id
target_report_operation TargetReportOperationDto 必须 请求参数
  • └ type
  • String
  • 必须
  • crowd
  • crowd/region
  • └ date_begin
  • String
  • 必须
  • 2021-01-01
  • 开始时间(yyyy-MM-dd)
  • └ date_end
  • String
  • 必须
  • 2021-01-01
  • 结束时间(yyyy-MM-dd)
  • └ campaign_type
  • Number
  • 可选
  • 1
  • 营销目标
  • └ campaign_id
  • Number
  • 可选
  • 1
  • 计划ID

响应参数

名称 类型 示例值 描述
result TargetReportDto {} 返回数据
  • target_effect_list
  • TargetEffectDto []
  • []
  • 返回实体集合
  • └ subject
  • String
  • test
  • 标题
  • └ option_value
  • String
  • 1
  • 选项值
  • └ tag_ref_type
  • Number
  • 13
  • 13:地域标签 14：人群标签
  • └ stat_date
  • String
  • 2021-01-01
  • 日期(yyyy-MM-dd)
  • └ impr
  • Number
  • 1
  • 曝光
  • └ click
  • Number
  • 1
  • 点击
  • └ cost
  • Number
  • 1
  • 消耗
  • └ online_min
  • Number
  • 1
  • 推广时长

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaScbpAdReportGetTargetReportRequest req = new AlibabaScbpAdReportGetTargetReportRequest();
AlibabaScbpAdReportGetTargetReportRequest.TopContextDto obj1 = new AlibabaScbpAdReportGetTargetReportRequest.TopContextDto();
obj1.setProductLineId(110101L);
obj1.setProductId(110101010L);
req.setTopContext(obj1);
AlibabaScbpAdReportGetTargetReportRequest.TargetReportOperationDto obj2 = new AlibabaScbpAdReportGetTargetReportRequest.TargetReportOperationDto();
obj2.setType("crowd");
obj2.setDateBegin("2021-01-01");
obj2.setDateEnd("2021-01-01");
obj2.setCampaignType(1L);
obj2.setCampaignId(1L);
req.setTargetReportOperation(obj2);
AlibabaScbpAdReportGetTargetReportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<alibaba_scbp_ad_report_get_target_report_response>
    <result>
        <target_effect_list>
            <target_effect_dto>
                <subject>test</subject>
                <option_value>1</option_value>
                <tag_ref_type>13</tag_ref_type>
                <stat_date>2021-01-01</stat_date>
                <impr>1</impr>
                <click>1</click>
                <cost>1</cost>
                <online_min>1</online_min>
            </target_effect_dto>
        </target_effect_list>
    </result>
</alibaba_scbp_ad_report_get_target_report_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部