注意:以下文档只适用于TOP接口,请谨慎使用!

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

taobao.tbk.dsp.rta.consumer.match (淘宝客-推广者-目标用户批量匹配)

对DSP开放,通过设备号与联盟任务id,判断用户是否属于目标任务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
qmt_id_list String 必须 11 任务id,最多5个任务
device_d_t_o_list DeviceDTO 必须 设备信息,最多10个设备,IMEI,IDFA,OAID:需用MD5加密,32位小写 CAID:设备号原始值
  • └ device_type
  • String
  • 可选
  • 11
  • 设备类型,IMEI, IDFA, OAID, CAID
  • └ device_value
  • String
  • 可选
  • 11
  • 设备值
  • └ device_version
  • String
  • 可选
  • 1
  • 设备版本号,入参CAID需传入

响应参数

名称 类型 示例值 描述
data DspRtaResult [] data
  • └ device_type
  • String
  • 11
  • 设备类型
  • └ device_value
  • String
  • 11
  • 设备值
  • match_result
  • MatchRes []
  • {"12": 1}
  • 任务匹配结果,key:任务id,value:1-命中该任务
  • └ task_id
  • String
  • 11
  • 任务id
  • └ status
  • Number
  • 1
  • 0-不符合任务要求,1-符合任务要求

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDspRtaConsumerMatchRequest req = new TbkDspRtaConsumerMatchRequest();
req.setQmtIdList("11");
TbkDspRtaConsumerMatchRequest.DeviceDTO obj1 = new TbkDspRtaConsumerMatchRequest.DeviceDTO();
obj1.setDeviceType("11");
obj1.setDeviceValue("11");
obj1.setDeviceVersion("1");
req.setDeviceDTOList(obj1);
TbkDspRtaConsumerMatchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dsp_rta_consumer_match_response>
    <data>
        <dsp_rta_result>
            <device_type>11</device_type>
            <device_value>11</device_value>
            <match_result>
                <match_res>
                    <task_id>11</task_id>
                    <status>1</status>
                </match_res>
            </match_result>
        </dsp_rta_result>
    </data>
</tbk_dsp_rta_consumer_match_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

返回
顶部