接口: 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 | 佣金状态:Pending、Approved、Rejected、Normal、All |
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) |
uid | uid,自定义追踪变量 |
brand_id | 品牌 ID,一串数字,如 66303 |
mcid | 品牌唯一标识,一串字符,如 ulike0 |
page | 当前页码 |
limit | 每页交易数,最多 2000 |
返回字段
| Key | 说明 |
|---|
channel_id | 渠道 ID |
total_page | 总页数 |
total_trans | 销售交易总数 |
total_items | 按商品拆分的交易总数 |
partnerboost_id | PartnerBoost 系统唯一 ID |
brand_id | 品牌 ID,一串数字,如 66303 |
mcid | 品牌唯一标识,一串字符,如 ulike0 |
merchant_name | 品牌名称 |
order_id | 订单 ID |
order_time | 交易时间 |
sale_amount | 销售金额 |
sale_comm | 销售佣金 |
status | 佣金状态 |
uid | uid,自定义追踪变量 |
uid2 | uid2,自定义追踪变量 |
uid3 | uid3,自定义追踪变量 |
uid4 | uid4,自定义追踪变量 |
uid5 | uid5,自定义追踪变量 |
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 等) |