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

taobao.tbk.thor.creative.launch (淘宝客-推广者-媒体智能化投放)

媒体广告创意的智能化投放

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req LaunchRequst 必须 入参
  • └ id
  • String
  • 可选
  • 23123
  • 媒体生成的唯一请求ID
  • └ version
  • Number
  • 必须
  • 1
  • 协议的版本号,当前协议版本号为1
  • device
  • Device
  • 必须
  • 设备信息, idfa/imei/imei_md5/oaid/mac必填其中之一
  • └ osv
  • String
  • 可选
  • 4.2.4
  • 操作系统版本号
  • └ os
  • String
  • 可选
  • iOS
  • 操作系统
  • └ ip
  • String
  • 可选
  • 110.23.32.9
  • 设备IP地址
  • └ idfa
  • String
  • 可选
  • 9C287922-EE26-4501-94B5-DDE6F83E1475
  • iOS 6.0及以上的 idfa 号
  • └ imei_md5
  • String
  • 可选
  • 52CF20235A5A6346
  • 原始imei转大写之后的md5值,大写形式
  • └ imei
  • String
  • 可选
  • 358000046760359
  • 安卓设备的 imei 号;明文,长度<=16位,数字或字符
  • └ device_type
  • Number
  • 可选
  • 0
  • 0-手机 1-平板 2-PC 3-互联网电视
  • └ oaid
  • String
  • 可选
  • 47befdff-fb1f-4b96-ddff-bf3fb77f744e
  • 安卓Q版本的设备号,可输入多值以英文逗号分割,最多10个
  • └ mac
  • String
  • 可选
  • 07-16-76-00-02-86
  • 设备的mac地址
  • └ network
  • Number
  • 可选
  • 0
  • 设备所处的网络环境 0-未识别 1-wifi 2-2g 3-3g 4-4g 5-5g
  • └ adzone_id
  • String
  • 必须
  • 12345
  • 推广位id
  • └ scene_type
  • String
  • 可选
  • scene
  • 场景类型,挑量场景必传指定值
  • tag_type
  • Tag
  • 可选
  • 标签类型
  • └ alipay
  • Boolean
  • 可选
  • true
  • 是否安装支付宝,是传true,不是传false
  • └ etao
  • Boolean
  • 可选
  • false
  • 是否安装一淘,是传true,不是传false
  • └ auth_cart
  • Boolean
  • 可选
  • true
  • 是否已授权淘宝购物车,是传true,不是传false

响应参数

名称 类型 示例值 描述
result IntelligentLaunchDTO 广告请求结果
  • └ click_through_url
  • String
  • https://srd.simba.taobao.com/erd
  • 点击地址,在触发点击时,通过此地址到达落地页
  • └ image_url4
  • String
  • https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg
  • 第四个图片,多图素材样式使用
  • └ impression_tracking_url
  • String
  • http://trace.thor.alimama.com/trace/impression
  • 曝光监测地址
  • └ deeplink_url
  • String
  • tbopen://m.taobao.com/tbopen/index.html?&xx=xxx
  • APP唤醒地址,若此字段非空,APP应首先通过此url唤醒目标app;若唤醒失败,则改为通过click_through_url到达落地页
  • └ pid
  • String
  • mm_11_22_33
  • 媒体pid
  • └ title
  • String
  • 卫衣男宽松连帽套头潮嘻哈黑色青年休闲潮牌
  • 广告标题
  • └ creative_id
  • String
  • 1563552188
  • 广告创意的唯一标志
  • └ creative_type
  • Number
  • 1
  • 1-图文(大图) 2-图文(三图) 3-视频
  • └ image_url2
  • String
  • https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg
  • 第二个图片,多图素材样式使用
  • └ image_url
  • String
  • https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg
  • 广告展示素材对应的URL
  • └ image_url3
  • String
  • https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg
  • 第三个图片,多图素材样式使用
  • └ id
  • String
  • 1
  • 与Request中的id相同
  • └ desc
  • String
  • 返回广告成功
  • 状态码描述
  • └ status
  • Number
  • 0
  • 广告请求状态码,具体参考状态说明
  • └ material_type
  • Number
  • 1
  • 物料类型 超红 预售会场
  • banner
  • ImageItemDto
  • banner
  • └ item_id
  • String
  • 1
  • 图案对象的唯一ID
  • └ type
  • Number
  • 1
  • 图案对象类型,1-横幅,2-图标
  • └ bgd_url
  • String
  • img
  • 底图,多图素材样式使用
  • └ icon_url
  • String
  • img
  • 图标,多图素材样式使用
  • └ title
  • String
  • title
  • 文案标题
  • └ click_through_url
  • String
  • https://srd.simba.taobao.com/erd
  • 点击地址,H5链接
  • └ deep_link_url
  • String
  • tbopen://m.taobao.com/tbopen/index.html?&xx=xxx
  • APP唤醒地址
  • icon_list
  • ImageItemDto []
  • 图标按钮组
  • └ bgd_url
  • String
  • img
  • 底图,多图素材样式使用
  • └ icon_url
  • String
  • img
  • 图标,多图素材样式使用
  • └ title
  • String
  • 文案标题
  • 文案标题
  • └ click_through_url
  • String
  • https://srd.simba.taobao.com/erd
  • 点击地址,H5链接
  • └ deep_link_url
  • String
  • tbopen://m.taobao.com/tbopen/index.html?&xx=xxx
  • APP唤醒地址
  • └ item_id
  • String
  • 1
  • 图案对象的唯一ID
  • └ type
  • String
  • 1
  • 图案对象类型,1-横幅,2-图标
  • sp_item_list
  • SpItemDto []
  • 挑量返回物料列表信息
  • └ item_id
  • String
  • 556633720749
  • 商品id
  • └ title
  • String
  • 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款
  • 商品标题
  • └ img_url
  • String
  • //img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
  • 商品主图
  • └ final_price
  • String
  • 79.9
  • 商品到手价
  • └ original_price
  • String
  • 179.9
  • 商品原价
  • └ coupon_amount
  • String
  • 40元
  • 优惠券面额
  • └ last_update_time
  • String
  • 1641902677949
  • 最后更新时间,毫秒时间戳
  • └ url
  • String
  • https://detail.m.tmall.com/item.htm?id=661311239171
  • 商品链接
  • └ deeplink
  • String
  • http://cdn.s.aliyun.com/L1/aaa.png?itemId=661311239171&etao_adv_param=XP8l
  • 商品跳转deeplink链接
  • └ platform_name
  • String
  • etao
  • 平台名称
  • └ coupon_desc
  • String
  • 约省
  • 优惠券描述
  • oaid_status_list
  • OaidStatusDto []
  • oaid对应的广告状态
  • └ oaid
  • String
  • 47befdff-fb1f-4b96-ddff-bf3fb77f744e
  • 安卓Q版本的设备号
  • └ status
  • Number
  • 0
  • 广告请求状态码,具体参考状态说明

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkThorCreativeLaunchRequest req = new TbkThorCreativeLaunchRequest();
TbkThorCreativeLaunchRequest.LaunchRequst obj1 = new TbkThorCreativeLaunchRequest.LaunchRequst();
obj1.setId("23123");
obj1.setVersion(1L);
TbkThorCreativeLaunchRequest.Device obj2 = new TbkThorCreativeLaunchRequest.Device();
obj2.setOsv("4.2.4");
obj2.setOs("iOS");
obj2.setIp("110.23.32.9");
obj2.setIdfa("9C287922-EE26-4501-94B5-DDE6F83E1475");
obj2.setImeiMd5("52CF20235A5A6346");
obj2.setImei("358000046760359");
obj2.setDeviceType(0L);
obj2.setOaid("47befdff-fb1f-4b96-ddff-bf3fb77f744e");
obj2.setMac("07-16-76-00-02-86");
obj2.setNetwork(0L);
obj1.setDevice(obj2);
obj1.setAdzoneId("12345");
obj1.setSceneType("scene");
TbkThorCreativeLaunchRequest.Tag obj3 = new TbkThorCreativeLaunchRequest.Tag();
obj3.setAlipay(true);
obj3.setEtao(false);
obj3.setAuthCart(true);
obj1.setTagType(obj3);
req.setReq(obj1);
TbkThorCreativeLaunchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_thor_creative_launch_response>
    <result>
        <click_through_url>https://srd.simba.taobao.com/erd</click_through_url>
        <image_url4>https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg</image_url4>
        <impression_tracking_url>http://trace.thor.alimama.com/trace/impression</impression_tracking_url>
        <deeplink_url>tbopen://m.taobao.com/tbopen/index.html?&amp;xx=xxx</deeplink_url>
        <pid>mm_11_22_33</pid>
        <title>卫衣男宽松连帽套头潮嘻哈黑色青年休闲潮牌</title>
        <creative_id>1563552188</creative_id>
        <creative_type>1</creative_type>
        <image_url2>https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg</image_url2>
        <image_url>https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg</image_url>
        <image_url3>https://ossgw.alicdn.com/alp/1582902016290-108-108.jpg</image_url3>
        <id>1</id>
        <desc>返回广告成功</desc>
        <status>0</status>
        <material_type>1</material_type>
        <banner>
            <item_id>1</item_id>
            <type>1</type>
            <bgd_url>img</bgd_url>
            <icon_url>img</icon_url>
            <title>title</title>
            <click_through_url>https://srd.simba.taobao.com/erd</click_through_url>
            <deep_link_url>tbopen://m.taobao.com/tbopen/index.html?&amp;xx=xxx</deep_link_url>
        </banner>
        <icon_list>
            <image_item_dto>
                <bgd_url>img</bgd_url>
                <icon_url>img</icon_url>
                <title>文案标题</title>
                <click_through_url>https://srd.simba.taobao.com/erd</click_through_url>
                <deep_link_url>tbopen://m.taobao.com/tbopen/index.html?&amp;xx=xxx</deep_link_url>
                <item_id>1</item_id>
                <type>1</type>
            </image_item_dto>
        </icon_list>
        <sp_item_list>
            <sp_item_dto>
                <item_id>556633720749</item_id>
                <title>毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款</title>
                <img_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</img_url>
                <final_price>79.9</final_price>
                <original_price>179.9</original_price>
                <coupon_amount>40元</coupon_amount>
                <last_update_time>1641902677949</last_update_time>
                <url>https://detail.m.tmall.com/item.htm?id=661311239171</url>
                <deeplink>http://cdn.s.aliyun.com/L1/aaa.png?itemId=661311239171&amp;etao_adv_param=XP8l</deeplink>
                <platform_name>etao</platform_name>
                <coupon_desc>约省</coupon_desc>
            </sp_item_dto>
        </sp_item_list>
        <oaid_status_list>
            <oaid_status_dto>
                <oaid>47befdff-fb1f-4b96-ddff-bf3fb77f744e</oaid>
                <status>0</status>
            </oaid_status_dto>
        </oaid_status_list>
    </result>
</tbk_thor_creative_launch_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

返回
顶部