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

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

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

提供给媒体在曝光广告前调用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
profile String 可选 预留json参数,与手淘团队单独沟通
oaid_md5 String 可选 0f7a929446fb7daf16a8eb6f2e160725 oaid的md5值, 32位小写
idfa_md5 String 可选 0f7a929446fb7daf16a8eb6f2e160725 idfa的md5值, 32位小写
imei_md5 String 可选 0f7a929446fb7daf16a8eb6f2e160725 imei的md5值, 32位小写
oaid String 可选 77CE527B70CB45AD991D8535BF94388914436004019A9D5BC74C30E80BE184F1 oaid的原生值
idfa String 可选 76B17F93-F503-4CF4-A05E-7A9FUECDA144 idfa的原生值
imei String 可选 864162033703542 imei的原生值
os String 可选 0 用户所使用设备的系统, 0: android, 1: ios, 2: windowsphone, 3: other
advertising_space_id String 必须 2187 大航海广告位,在大航海平台申请
channel String 必须 1 渠道标识,在大航海平台申请
caid_md5 String 可选 20220111_9c252c39a9b5b46ff84852be1279392f md5加密后的caid, 32位小写,前面拼接上caid版本号,当前支持20220111、20211207版本

响应参数

名称 类型 示例值 描述
task_id_list String [] 123456, 1234567 在大航海平台可投放的任务ID列表
errcode Number 0 错误码, 0: 成功;1:限流;2:服务不可用
result Boolean true true: 目标用户;false: 非目标用户
task_id String 123456 在大航海平台推荐的任务ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UsergrowthDhhDeliveryAskRequest req = new UsergrowthDhhDeliveryAskRequest();
req.setProfile("无");
req.setOaidMd5("0f7a929446fb7daf16a8eb6f2e160725");
req.setIdfaMd5("0f7a929446fb7daf16a8eb6f2e160725");
req.setImeiMd5("0f7a929446fb7daf16a8eb6f2e160725");
req.setOaid("77CE527B70CB45AD991D8535BF94388914436004019A9D5BC74C30E80BE184F1");
req.setIdfa("76B17F93-F503-4CF4-A05E-7A9FUECDA144");
req.setImei("864162033703542");
req.setOs("0");
req.setAdvertisingSpaceId("2187");
req.setChannel("1");
req.setCaidMd5("20220111_9c252c39a9b5b46ff84852be1279392f");
UsergrowthDhhDeliveryAskResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<usergrowth_dhh_delivery_ask_response>
    <task_id_list>
        <string>123456</string>
        <string>1234567</string>
    </task_id_list>
    <errcode>0</errcode>
    <result>true</result>
    <task_id>123456</task_id>
</usergrowth_dhh_delivery_ask_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.redirect-read-timeout 请求超时 请稍后重试
isp.call-limited 调用次数超限 请合理调整调用次数
isp.isp.trade-service-unavailable 服务异常,请稍后重试 服务异常,请稍后重试

API工具

如何获得此API

FAQ

返回
顶部