文档中心 > API类目 > 手淘用户增长

taobao.usergrowth.dhh.delivery.batchask (广告曝光前判定批量接口V2)

广告曝光前判定批量接口V2

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
oaid_md5 String 可选 ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52 md5加密后的oaid列表, 32位小写, 多个使用,分隔, 最多支持20个
idfa_md5 String 可选 ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52 md5加密后的oaid列表, 32位小写, 多个使用,分隔, 最多支持20个
imei_md5 String 可选 ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52 md5加密后的imei列表, 32位小写, 多个使用,分隔, 最多支持20个
advertising_space_id String 必须 2187 巨浪广告位id,在巨浪平台申请
channel String 必须 2000803434043 巨浪渠道id,在巨浪平台申请
caid_md5 String 可选 20220111_9c252c39a9b5b46ff84852be1279392f,20211207_ff8446b22b4a7472ecbbba69e56cc7e6 md5加密后的caid列表, 32位小写,前面拼接上caid版本号,当前支持20220111、20211207版本, 多个使用,分隔, 最多支持20个。

响应参数

名称 类型 示例值 描述
result BatchAskResultV2 返回值
  • └ errcode
  • Number
  • 0
  • 错误码, 0: 成功;1:限流;2:服务不可用
  • results
  • BatchAskResultItem []
  • 匹配的设备与其任务信息列表
  • └ task_id_list
  • String []
  • 675300124
  • 在巨浪平台可投放的任务ID列表
  • └ oaid_md5
  • String
  • 4c15077c9ad983de48d9094fd679835d
  • oaid的md5值, 32位小写
  • └ idfa_md5
  • String
  • 4c15077c9ad983de48d9094fd679835d
  • idfa的md5值, 32位小写
  • └ imei_md5
  • String
  • 4c15077c9ad983de48d9094fd679835d
  • imei的md5值, 32位小写
  • └ task_id
  • String
  • 675300124
  • 该设备要做的大航海的任务id
  • └ caid_md5
  • String
  • 20220111_9c252c39a9b5b46ff84852be1279392f
  • caid的md5值, 32位小写,前面拼接上caid版本号,当前支持20220111、20211207版本

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UsergrowthDhhDeliveryBatchaskRequest req = new UsergrowthDhhDeliveryBatchaskRequest();
req.setOaidMd5("ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52");
req.setIdfaMd5("ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52");
req.setImeiMd5("ce62ba73b0078116df9bf453bce31b51, ce62ba73b0078116df9bf453bce31b52");
req.setAdvertisingSpaceId("2187");
req.setChannel("2000803434043");
req.setCaidMd5("20220111_9c252c39a9b5b46ff84852be1279392f,20211207_ff8446b22b4a7472ecbbba69e56cc7e6");
UsergrowthDhhDeliveryBatchaskResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<usergrowth_dhh_delivery_batchask_response>
    <result>
        <errcode>0</errcode>
        <results>
            <batch_ask_result_item>
                <task_id_list>
                    <string>675300124</string>
                </task_id_list>
                <oaid_md5>4c15077c9ad983de48d9094fd679835d</oaid_md5>
                <idfa_md5>4c15077c9ad983de48d9094fd679835d</idfa_md5>
                <imei_md5>4c15077c9ad983de48d9094fd679835d</imei_md5>
                <task_id>675300124</task_id>
                <caid_md5>20220111_9c252c39a9b5b46ff84852be1279392f</caid_md5>
            </batch_ask_result_item>
        </results>
    </result>
</usergrowth_dhh_delivery_batchask_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>

错误码解释

错误码 错误描述 解决方案
isp.service-unavailable 请求异常 请稍后重试
isp.redirect-read-timeout 请求超时 请稍后重试
isp.call-limited 调用次数超限 请合理调整请求次数

API工具

如何获得此API

FAQ

返回
顶部