文档中心 > API类目 > 飞猪商业化API

alitrip.bp.ad.click.report (飞猪商业化点击埋点上报接口)

飞猪商业化点击埋点上报接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
click_request FliggyAdCommonClickRequest 必须 入参
  • └ ext
  • String
  • 必须
  • {"m":123456, "oid":123}
  • 物料透传字段
  • └ trace_id
  • String
  • 必须
  • 123adcab55EABL876
  • 广告请求唯一id
  • └ os
  • String
  • 可选
  • ios
  • 操作系统
  • └ campaign_id
  • String
  • 必须
  • 1111111
  • 计划id
  • └ ip
  • String
  • 可选
  • 123.123.239.218
  • ip
  • └ original_bid_price
  • Number
  • 必须
  • 234
  • 原始出价,单位:分
  • └ click_id
  • String
  • 必须
  • 9482726_2
  • 点击唯一id
  • └ settle_price
  • Number
  • 必须
  • 234
  • 结算价,单位:分
  • └ pid
  • String
  • 必须
  • 272727
  • 资源位id
  • └ cpx
  • String
  • 必须
  • CPC
  • 结算方式:CPC/CPM等
  • └ user_id
  • String
  • 可选
  • 2762920
  • 请求uid
  • └ device_id
  • String
  • 必须
  • bajsi37833m
  • 设备id
  • └ ad_group_id
  • String
  • 必须
  • 1233456|bp
  • 单元id
  • └ bid_price
  • Number
  • 必须
  • 234
  • 竞价,单位:分
  • └ et
  • Number
  • 必须
  • 1732180704293
  • 行为发生事件戳(毫秒)
  • └ report_channel
  • String
  • 必须
  • bmap
  • 上报渠道
  • └ pos
  • Number
  • 必须
  • 1
  • 广告透出坑位
  • └ res_field
  • String
  • 可选
  • xx
  • 预留字段
  • └ ts
  • Number
  • 必须
  • 1732180704293
  • 广告召回时间戳
  • └ material_id
  • String
  • 可选
  • 123455
  • 酒店shid或itemId

响应参数

名称 类型 示例值 描述
result TrackBaseResult 返回上报结果
  • └ success
  • Boolean
  • true
  • 埋点上报是否成功
  • └ error_code
  • String
  • param_error
  • 错误码
  • └ error_msg
  • String
  • 服务调用失败
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBpAdClickReportRequest req = new AlitripBpAdClickReportRequest();
AlitripBpAdClickReportRequest.FliggyAdCommonClickRequest obj1 = new AlitripBpAdClickReportRequest.FliggyAdCommonClickRequest();
obj1.setExt("{\"m\":123456, \"oid\":123}");
obj1.setTraceId("123adcab55EABL876");
obj1.setOs("ios");
obj1.setCampaignId("1111111");
obj1.setIp("123.123.239.218");
obj1.setOriginalBidPrice(234L);
obj1.setClickId("9482726_2");
obj1.setSettlePrice(234L);
obj1.setPid("272727");
obj1.setCpx("CPC");
obj1.setUserId("2762920");
obj1.setDeviceId("bajsi37833m");
obj1.setAdGroupId("1233456|bp");
obj1.setBidPrice(234L);
obj1.setEt(1732180704293L);
obj1.setReportChannel("bmap");
obj1.setPos(1L);
obj1.setResField("xx");
obj1.setTs(1732180704293L);
obj1.setMaterialId("123455");
req.setClickRequest(obj1);
AlitripBpAdClickReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bp_ad_click_report_response>
    <result>
        <success>true</success>
        <error_code>param_error</error_code>
        <error_msg>服务调用失败</error_msg>
    </result>
</alitrip_bp_ad_click_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

返回
顶部