文档中心 > API类目 > 阿里妈妈-UniDesk

alibaba.ud.event.upload (UD业务事件回传)

UD业务事件回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
event_service_request EventServiceRequest 可选 事件请求相关的信息
  • └ pub_request_id
  • String
  • 可选
  • 0babd50600001273635da90c05e4fc54
  • 媒体的请求id,与trackid二选一必填
  • └ event_type
  • Number
  • 必须
  • 12
  • 转化事件,枚举:12-提交订单(字节APP内付款),3-付款(其他媒体使用),28-退款(字节使用)
  • └ tb_gmv_total_price
  • String
  • 可选
  • 123.0
  • 订单gmv金额,当event_type传12和28时必填
  • └ tb_auction_id
  • Number
  • 可选
  • 682757872889
  • 商品ID
  • └ tb_event_timestamp
  • Number
  • 必须
  • 1672221789
  • 转化时间发生时间戳
  • └ tb_trade_parent_id
  • Number
  • 可选
  • 1779808514810777486
  • 父订单id,与订单ID至少有一个必填
  • └ tb_seller_id
  • Number
  • 可选
  • 2208312033390
  • 商家id
  • └ tb_status
  • Number
  • 可选
  • 0
  • 订单状态
  • └ tb_alipay_total_price
  • String
  • 可选
  • 123.00
  • 订单支付金额,当event_type传3时必填
  • └ tb_trade_id
  • Number
  • 可选
  • 1779808514810777486
  • 订单id,与父订单ID至少有一个必填
  • └ channel_id
  • Number
  • 必须
  • 105
  • 媒体渠道,枚举:105-快手,103-字节
  • └ track_id
  • String
  • 可选
  • trackid
  • 字节trackid,与pub_request_id二选一必填

响应参数

名称 类型 示例值 描述
id String 1234567890 traceid
status Number 0 0为成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaUdEventUploadRequest req = new AlibabaUdEventUploadRequest();
AlibabaUdEventUploadRequest.EventServiceRequest obj1 = new AlibabaUdEventUploadRequest.EventServiceRequest();
obj1.setPubRequestId("0babd50600001273635da90c05e4fc54");
obj1.setEventType(12L);
obj1.setTbGmvTotalPrice("123.0");
obj1.setTbAuctionId(682757872889L);
obj1.setTbEventTimestamp(1672221789L);
obj1.setTbTradeParentId(1779808514810777486L);
obj1.setTbSellerId(2208312033390L);
obj1.setTbStatus(0L);
obj1.setTbAlipayTotalPrice("123.00");
obj1.setTbTradeId(1779808514810777486L);
obj1.setChannelId(105L);
obj1.setTrackId("trackid");
req.setEventServiceRequest(obj1);
AlibabaUdEventUploadResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ud_event_upload_response>
    <id>1234567890</id>
    <status>0</status>
</alibaba_ud_event_upload_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

返回
顶部