/pb/openapi/newad/spCampaignReports{
"operation": {
"method": "POST",
"path": "/pb/openapi/newad/spCampaignReports"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"sid": 109,
"report_date": "2022-06-01",
"show_detail": 1,
"offset": 0,
"length": 15
},
"responseExample": {
"code": 0,
"message": "操作成功",
"error_details": [],
"request_id": "DHJ9190-7404-9BDF-3F41-01F0401D1315",
"response_time": "2023-02-17 09:59:19",
"total": 124,
"data": [
{
"targeting_type": "auto",
"impressions": 2121,
"clicks": 194,
"cost": 414.87,
"report_date": "2022-12-13",
"profile_id": 121923590660074,
"campaign_id": 85689331875413,
"same_orders": 197,
"orders": 197,
"same_sales": 3123.96,
"sales": 3123.96,
"units": 197,
"same_units": 197,
"same_orders_1d": 197,
"orders_1d": 197,
"same_sales_1d": 3123.96,
"sales_1d": 3123.96,
"units_1d": 197,
"same_units_1d": 197,
"same_orders_7d": 197,
"orders_7d": 197,
"same_sales_7d": 3123.96,
"sales_7d": 3123.96,
"units_7d": 197,
"same_units_7d": 197,
"same_orders_14d": 197,
"orders_14d": 197,
"same_sales_14d": 3123.96,
"sales_14d": 3123.96,
"units_14d": 197,
"same_units_14d": 197,
"units_30d": 197,
"same_units_30d": 197,
"same_orders_30d": 197,
"orders_30d": 197,
"same_sales_30d": 3123.96,
"sales_30d": 3123.96
}
]
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | next_token | 分页游标 | string | — | 可选 | 分页游标,使用上次响应中的 next_token。首次请求无需传入;与 offset 同时传入时,以 next_token 为准 |
| 2 | sid | 店铺id | integer | — | 必填 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 3 | profile_id | VC广告店铺profile_id | integer | — | 必填 | VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填 |
| 4 | report_date | 报告日期 | string | — | 必填 | 报告日期,格式:Y-m-d |
| 5 | show_detail | 是否展示完整归因期信息【默认0】 | integer | — | 可选 | 是否展示完整归因期信息【默认0】:0 否,1 是 |
| 6 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 7 | length | 分页长度 | integer | — | 可选 | 分页长度,默认15 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | next_token | 分页游标 | string | ODAwMDAwMDAwMDAwMDAyNDE3 | 必填 | 分页游标,作为 next_token 传入下一次请求 |
| 2 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 3 | message | 提示消息 | string | 操作成功 | 必填 | 提示消息 |
| 4 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 5 | request_id | 请求链路id | string | DHJ9190-7404-9BDF-3F41-01F0401D1315 | 必填 | 请求链路id |
| 6 | response_time | 响应时间 | string | 2023-02-17 09:59:19 | 必填 | 响应时间 |
| 7 | total | 总数 | integer | 1 | 必填 | 总数 |
| 8 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 8.1 | targeting_type | 投放类型 | string | auto | 可选 | 投放类型。受亚马逊报表限制,该字段可能返回 null;请通过 campaign_id 调用 SP广告活动 接口获取对应的 targeting_type |
| 8.2 | impressions | 展示量 | number | 5894 | 必填 | 展示量 |
| 8.3 | clicks | 点击量 | number | 748 | 必填 | 点击量 |
| 8.4 | cost | 花费 | number | 348.85 | 必填 | 花费 |
| 8.5 | report_date | 报表日期 | string | 2022-06-22 | 必填 | 报表日期 |
| 8.6 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | 必填 | 亚马逊店铺数字id |
| 8.7 | campaign_id | 广告活动id | number | 83080499191276 | 必填 | 广告活动id |
| 8.8 | same_orders | 直接成交订单数 | number | 600 | 必填 | 直接成交订单数 |
| 8.9 | same_orders_1d | same_orders_1d | number | 197 | 可选 | 直接成交订单数(1d)【show_detail=1时返回字段】 |
| 8.10 | same_orders_7d | same_orders_7d | number | 197 | 可选 | 直接成交订单数(7d)【show_detail=1时返回字段】 |
| 8.11 | same_orders_14d | same_orders_14d | number | 197 | 可选 | 直接成交订单数(14d)【show_detail=1时返回字段】 |
| 8.12 | same_orders_30d | same_orders_30d | number | 197 | 可选 | 直接成交订单数(30d)【show_detail=1时返回字段】 |
| 8.13 | orders | 订单数 | number | 600 | 必填 | 订单数 |
| 8.14 | orders_1d | orders_1d | number | 197 | 可选 | 订单数(1d)【show_detail=1时返回字段】 |
| 8.15 | orders_7d | orders_7d | number | 197 | 可选 | 订单数(7d)【show_detail=1时返回字段】 |
| 8.16 | orders_14d | orders_14d | number | 197 | 可选 | 订单数(14d)【show_detail=1时返回字段】 |
| 8.17 | orders_30d | orders_30d | number | 197 | 可选 | 订单数(30d)【show_detail=1时返回字段】 |
| 8.18 | same_sales | 直接成交销售额 | number | 820.43 | 必填 | 直接成交销售额 |
| 8.19 | same_sales_1d | same_sales_1d | number | 3123.96 | 可选 | 直接成交销售额(1d)【show_detail=1时返回字段】 |
| 8.20 | same_sales_7d | same_sales_7d | number | 3123.96 | 可选 | 直接成交销售额(7d)【show_detail=1时返回字段】 |
| 8.21 | same_sales_14d | same_sales_14d | number | 3123.96 | 可选 | 直接成交销售额(14d)【show_detail=1时返回字段】 |
| 8.22 | same_sales_30d | same_sales_30d | number | 3123.96 | 可选 | 直接成交销售额(30d)【show_detail=1时返回字段】 |
| 8.23 | sales | 销售额 | number | 820.43 | 必填 | 销售额 |
| 8.24 | sales_1d | sales_1d | number | 3123.96 | 可选 | 销售额(1d)【show_detail=1时返回字段】 |
| 8.25 | sales_7d | sales_7d | number | 3123.96 | 可选 | 销售额(7d)【show_detail=1时返回字段】 |
| 8.26 | sales_14d | sales_14d | number | 3123.96 | 可选 | 销售额(14d)【show_detail=1时返回字段】 |
| 8.27 | sales_30d | sales_30d | number | 3123.96 | 可选 | 销售额(30d)【show_detail=1时返回字段】 |
| 8.28 | units | 销量 | number | 453 | 必填 | 销量 |
| 8.29 | units_1d | units_1d | number | 197 | 可选 | 销量(1d)【show_detail=1时返回字段】 |
| 8.30 | units_7d | units_7d | number | 197 | 可选 | 销量(7d)【show_detail=1时返回字段】 |
| 8.31 | units_14d | units_14d | number | 197 | 可选 | 销量(14d)【show_detail=1时返回字段】 |
| 8.32 | units_30d | units_30d | number | 197 | 可选 | 销量(30d)【show_detail=1时返回字段】 |
| 8.33 | same_units | 直接成交量 | number | 453 | 必填 | 直接成交量 |
| 8.34 | same_units_1d | same_units_1d | number | 197 | 可选 | 直接成交量(1d)【show_detail=1时返回字段】 |
| 8.35 | same_units_7d | same_units_7d | number | 197 | 可选 | 直接成交量(7d)【show_detail=1时返回字段】 |
| 8.36 | same_units_14d | same_units_14d | number | 197 | 可选 | 直接成交量(14d)【show_detail=1时返回字段】 |
| 8.37 | same_units_30d | same_units_30d | number | 197 | 可选 | 直接成交量(30d)【show_detail=1时返回字段】 |
领星ERP的接口:SP广告活动报表(/pb/openapi/newad/spCampaignReports),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。