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

alibaba.alihealth.yt.wt.media.report (外投媒体上报)

外投媒体上报

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
isv_media_report_request IsvMediaReportRequest 可选 上报参数配置
  • └ gmv
  • Number
  • 必须
  • 100
  • 回传金额,单位到分
  • └ item_id
  • String
  • 必须
  • 234234
  • 商品id
  • └ item_name
  • String
  • 必须
  • 324234
  • 商品名称
  • └ parent_order_id
  • Number
  • 必须
  • 23432432
  • 父清单id
  • └ channel_id
  • Number
  • 必须
  • 1
  • 渠道ID:1-抖音1.0,2-抖音2.0,3-快手,4-腾讯,5-B站,6-UC,7-百度
  • └ item_count
  • Number
  • 可选
  • 1
  • 订单,购买商品数量
  • └ cid
  • String
  • 可选
  • 2343242
  • cid加密,从订单列表获取
  • └ advertiser_id
  • Number
  • 可选
  • 234324
  • 媒体广告id
  • └ event_name
  • String
  • 可选
  • in_app_order
  • 媒体上报事件:抖音:in_app_order-下单,add_to_cart-加购;快手:14-下单;腾讯:COMPLETE_ORDER-下单;B站:ORDER_PLACE-支付;UC:1000-下单;百度:45-下单
  • └ platform
  • String
  • 可选
  • isv上报主体标识
  • isv上报主体标识,如果不填,默认是使用官方的
  • └ app_access_token
  • String
  • 可选
  • 媒体回传的账户的appAccessToken, 如果渠道不强制,可以为空
  • 媒体回传的账户的appAccessToken, 如果渠道不强制,可以为空
  • └ account_token
  • String
  • 可选
  • 回传账户的token,不强制,可以为空
  • 回传账户的token,不强制,可以为空(注意区分和appAccessToken的区别,传错会导致上报失败)

响应参数

名称 类型 示例值 描述
result Result Result
  • └ success
  • Boolean
  • true
  • true表示成功
  • └ model
  • String
  • {"code":130,"message":"本次请求失败,数据未计入转化。本次请求缺少必需的信息数据,请及时增加以下回传字段:tec_gent, order_id, order_cnt, pay_amont, product_id, product_name, shop_name, ecom_platform, product_price, product_category, product_pic_url。详情见:https://bytedance.feishu.cn/docx/ZrzEd4n2SoNJRwxFu0VcGUxxnle"}
  • 媒体返回数据
  • └ msg_info
  • String
  • 错误信息
  • 错误信息
  • └ msg_code
  • String
  • 错误码
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthYtWtMediaReportRequest req = new AlibabaAlihealthYtWtMediaReportRequest();
AlibabaAlihealthYtWtMediaReportRequest.IsvMediaReportRequest obj1 = new AlibabaAlihealthYtWtMediaReportRequest.IsvMediaReportRequest();
obj1.setGmv(100L);
obj1.setItemId("234234");
obj1.setItemName("324234");
obj1.setParentOrderId(23432432L);
obj1.setChannelId(1L);
obj1.setItemCount(1L);
obj1.setCid("2343242");
obj1.setAdvertiserId(234324L);
obj1.setEventName("in_app_order");
obj1.setPlatform("isv上报主体标识");
obj1.setAppAccessToken("媒体回传的账户的appAccessToken, 如果渠道不强制,可以为空");
obj1.setAccountToken("回传账户的token,不强制,可以为空");
req.setIsvMediaReportRequest(obj1);
AlibabaAlihealthYtWtMediaReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_yt_wt_media_report_response>
    <result>
        <success>true</success>
        <model>{&quot;code&quot;:130,&quot;message&quot;:&quot;本次请求失败,数据未计入转化。本次请求缺少必需的信息数据,请及时增加以下回传字段:tec_gent, order_id, order_cnt, pay_amont, product_id, product_name, shop_name, ecom_platform, product_price, product_category, product_pic_url。详情见:https://bytedance.feishu.cn/docx/ZrzEd4n2SoNJRwxFu0VcGUxxnle&quot;}</model>
        <msg_info>错误信息</msg_info>
        <msg_code>错误码</msg_code>
    </result>
</alibaba_alihealth_yt_wt_media_report_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

返回
顶部