/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认值0 |
| 2 | length | 分页大小 | integer | — | 可选 | 分页大小,默认20 |
| 3 | invoice_id | 广告发票编号列表 | string | — | 必填 | 广告发票编号列表,支持批量查询,英文逗号分割,最多支持100个 示例:CDLPWKJPR-21,CDLPWKJPR-22 |
| 4 | sid | 店铺id | integer | — | 必填 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 5 | ads_type | 广告类型 | array<any> | — | 可选 | 广告类型: SPONSORED PRODUCTS SPONSORED DISPLAY SPONSORED BRANDS SPONSORED BRANDS VIDEO |
| 6 | search_type | 搜索类型 | string | — | 可选 | 搜索类型: ads_campaign【对应页面广告活动】 item【对应页面承担商品】 |
| 7 | search_value | 搜索值 | string | — | 可选 | 搜索值 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 提示消息 | string | success | 必填 | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-04-07 12:11:12 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 7.1 | invoice_id | 广告发票编号列表 | string | CDLPWKJPR-21,CDLPWKJPR-22 | 必填 | 广告发票编号列表 |
| 7.2 | campaign_name | 广告活动 | string | shampoo brush_SB_221122 | 必填 | 广告活动 |
| 7.3 | campaign_id | 活动id | string | 103754268477832 | 必填 | 活动id |
| 7.4 | ads_type | 广告类型 | string | SPONSORED BRANDS | 必填 | 广告类型 |
| 7.5 | price_type | 计价方式 | string | CPC | 必填 | 计价方式 |
| 7.6 | cost_event_count | 点击量 | number | 26 | 必填 | 点击量 |
| 7.7 | currency_icon | 币种符号 | string | € | 必填 | 币种符号 |
| 7.8 | cost_amount | 费用 | number | 10.92 | 必填 | 费用 |
| 7.9 | cost_per_unit | 平均点击单价 | number | 0.42 | 必填 | 平均点击单价 |
| 7.10 | other_allocation_fee | 其他费分摊 | number | 0 | 必填 | 其他费分摊 |
| 7.11 | items | 承担商品 | array<any> | ["B07P6X4CJ7","B095WCH2TD","B09L12TZ2S"] | 必填 | 承担商品 |
领星ERP的接口:查询广告发票活动列表(/bd/profit/report/open/report/ads/invoice/campaign/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。