/bd/profit/report/open/report/ads/invoice/campaign/list{
"operation": {
"method": "POST",
"path": "/bd/profit/report/open/report/ads/invoice/campaign/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"invoice_id": "CDLPWKJPR-21,CDLPWKJPR-22",
"sid": 136
},
"responseExample": {
"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.94,
"cost_per_unit": 0.97,
"other_allocation_fee": 0
}
],
"error_details": null,
"request_id": "656b0028-22ed-45d0-ad25-28f04f21f324.1721879425928",
"response_time": "2024-07-25 11:50:25",
"total": 1
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认值0 |
| 2 | length | 分页大小 | integer | — | Optional | 分页大小,默认20 |
| 3 | invoice_id | 广告发票编号列表 | string | — | Required | 广告发票编号列表,支持批量查询,英文逗号分割,最多支持100个 示例:CDLPWKJPR-21,CDLPWKJPR-22 |
| 4 | sid | 店铺id | integer | — | Required | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 5 | ads_type | 广告类型 | array<any> | — | Optional | 广告类型: SPONSORED PRODUCTS SPONSORED DISPLAY SPONSORED BRANDS SPONSORED BRANDS VIDEO |
| 6 | search_type | 搜索类型 | string | — | Optional | 搜索类型: ads_campaign【对应页面广告活动】 item【对应页面承担商品】 |
| 7 | search_value | 搜索值 | string | — | Optional | 搜索值 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 提示消息 | string | success | Required | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-04-07 12:11:12 | Required | 响应时间 |
| 6 | total | 总数 | integer | 1 | Required | 总数 |
| 7 | data | 响应数据 | array<object> | — | Required | 响应数据 |
| 7.1 | invoice_id | 广告发票编号列表 | string | CDLPWKJPR-21,CDLPWKJPR-22 | Required | 广告发票编号列表 |
| 7.2 | campaign_name | 广告活动 | string | shampoo brush_SB_221122 | Required | 广告活动 |
| 7.3 | campaign_id | 活动id | string | 103754268477832 | Required | 活动id |
| 7.4 | ads_type | 广告类型 | string | SPONSORED BRANDS | Required | 广告类型 |
| 7.5 | price_type | 计价方式 | string | CPC | Required | 计价方式 |
| 7.6 | cost_event_count | 点击量 | number | 26 | Required | 点击量 |
| 7.7 | currency_icon | 币种符号 | string | € | Required | 币种符号 |
| 7.8 | cost_amount | 费用 | number | 10.92 | Required | 费用 |
| 7.9 | cost_per_unit | 平均点击单价 | number | 0.42 | Required | 平均点击单价 |
| 7.10 | other_allocation_fee | 其他费分摊 | number | 0 | Required | 其他费分摊 |
| 7.11 | items | 承担商品 | array<any> | ["B07P6X4CJ7","B095WCH2TD","B09L12TZ2S"] | Required | 承担商品 |
The 查询广告发票活动列表 API (/bd/profit/report/open/report/ads/invoice/campaign/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.