跳到主要内容

交易

接口: https://app.partnerboost.com/api.php?mod=medium&op=transaction

认证:Partner API 认证

必填参数

Key说明
token渠道 API Token
begin_date交易周期。格式:YYYY-MM-DD。交易周期与校验周期二者必填其一。
end_date格式:YYYY-MM-DD
validation_date_begin校验周期。格式:YYYY-MM-DD。交易周期与校验周期二者必填其一。
validation_date_end格式:YYYY-MM-DD

* 必须提供交易周期(begin_date/end_date校验周期之一。

可选参数

Key说明
type返回格式:json(默认)或 xml
order_id订单 ID
status佣金状态:PendingApprovedRejectedNormalAll
order_type按订单类型筛选。可选:amz_attribution(AMZ-Attribution Commission — Amazon attribution 订单)、amz_creator_boost(AMZ-Creator Boost Commission)、amz_cpc(Amazon CPC)、wmt_attribution(WMT-Attribution Commission)、wmt_affiliate_boost(WMT-Affiliate Boost Commission)、dtc(DTC Commission)、tiktok(TikTok Commission)、paid_placement(Paid Placement Fee)、merchant_bonus(Merchant Bonus)
uiduid,自定义追踪变量
brand_id品牌 ID,一串数字,如 66303
mcid品牌唯一标识,一串字符,如 ulike0
page当前页码
limit每页交易数,最多 2000

返回字段

Key说明
channel_id渠道 ID
total_page总页数
total_trans销售交易总数
total_items按商品拆分的交易总数
partnerboost_idPartnerBoost 系统唯一 ID
brand_id品牌 ID,一串数字,如 66303
mcid品牌唯一标识,一串字符,如 ulike0
merchant_name品牌名称
order_id订单 ID
order_time交易时间
sale_amount销售金额
sale_comm销售佣金
status佣金状态
uiduid,自定义追踪变量
uid2uid2,自定义追踪变量
uid3uid3,自定义追踪变量
uid4uid4,自定义追踪变量
uid5uid5,自定义追踪变量
click_ref唯一点击 ID
prod_id商品 ID
order_unit订单件数
comm_rate佣金比例
validation_date交易校验日期
note状态变更原因
customer_country客户国家。为空表示商家未提供
voucher_code结账时使用的优惠码
paid_status是否已向媒体付款。1 = 已付,0 = 未付
last_update_time最近一次从广告主更新交易状态的时间
payment_currency订单币种,以及向你支付该订单佣金时使用的币种
order_type订单类型(如 AMZ-Attribution Commission、TikTok Commission 等)