Lingxing
切换旧版

查询广告发票活动列表

POST/bd/profit/report/open/report/ads/invoice/campaign/list

基本信息

API Path请求协议请求方式令牌桶容量
/bd/profit/report/open/report/ads/invoice/campaign/listHTTPSPOST10

请求参数

offsetinteger
分页偏移量,默认值0
lengthinteger
分页大小,默认20
invoice_idstring必填
广告发票编号列表,支持批量查询,英文逗号分割,最多支持100个
示例:CDLPWKJPR-21,CDLPWKJPR-22
sidinteger必填
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
ads_typearray<any>
广告类型:
SPONSORED PRODUCTS
SPONSORED DISPLAY
SPONSORED BRANDS
SPONSORED BRANDS VIDEO
search_typestring
搜索类型:
ads_campaign【对应页面广告活动】
item【对应页面承担商品】
search_valuestring
搜索值

请求示例

{
    "invoice_id": "CDLPWKJPR-21,CDLPWKJPR-22",
    "sid": 136
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
提示消息
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C
response_timestring必填
响应时间
示例 2023-04-07 12:11:12
totalinteger必填
总数
示例 1
dataarray<object>必填
响应数据
隐藏子属性
invoice_idstring必填
广告发票编号列表
示例 CDLPWKJPR-21,CDLPWKJPR-22
campaign_namestring必填
广告活动
示例 shampoo brush_SB_221122
campaign_idstring必填
活动id
示例 103754268477832
ads_typestring必填
广告类型
示例 SPONSORED BRANDS
price_typestring必填
计价方式
示例 CPC
cost_event_countnumber必填
点击量
示例 26
currency_iconstring必填
币种符号
示例 €
cost_amountnumber必填
费用
示例 10.92
cost_per_unitnumber必填
平均点击单价
示例 0.42
other_allocation_feenumber必填
其他费分摊
示例 0
itemsarray<any>必填
承担商品
示例 ["B07P6X4CJ7","B095WCH2TD","B09L12TZ2S"]

返回成功示例

{
    "code": 0,
    "message": null,
    "data": [
        {
            "invoice_id": "CDLPWKJPR-21,CDLPWKJPR-22",
            "items": [
                "HM300-BLACK"
            ],
            "campaign_name": "HM300-Green-pink yoga pants for women-2024-04-11-09:39:41-勿归档",
            "campaign_id": "337037646660608",
            "ads_type": "SPONSORED PRODUCTS",
            "price_type": "CPC",
            "cost_event_count": 2,
            "currency_icon": "$",
            "cost_amount": 1.9400,
            "cost_per_unit": 0.9700,
            "other_allocation_fee": 0.0000
        }
    ],
    "error_details": null,
    "request_id": "656b0028-22ed-45d0-ad25-28f04f21f324.1721879425928",
    "response_time": "2024-07-25 11:50:25",
    "total": 1
}