/pb/openapi/newad/hsaCampaignPlacementReports{
"operation": {
"method": "POST",
"path": "/pb/openapi/newad/hsaCampaignPlacementReports"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"sid": 109,
"report_date": "2022-06-01",
"offset": 0,
"length": 15
},
"responseExample": {
"code": 0,
"message": "操作成功",
"error_details": [],
"request_id": "478WOD3-7404-9BDF-8F41-01F0401D1305",
"response_time": "2023-02-24 10:56:58",
"total": 1,
"data": [
{
"clicks": 14,
"cost": 12.61,
"profile_id": 121923590660074,
"impressions": 865,
"report_date": "2021-06-23",
"campaign_id": 162632371880150,
"placement_type": "Otheron-Amazon",
"orders": 3,
"same_orders": 3,
"new_to_brand_orders": null,
"new_to_brand_units": null,
"new_to_brand_sales": null,
"same_sales": 42.48,
"new_to_brand_order_percentage": null,
"new_to_brand_order_rate": null,
"sales": 42.48,
"creative_type": "video",
"videofirstquartileviews": 1002,
"videomidpointviews": 100,
"videothirdquartileviews": 52,
"video5secondviews": 1223,
"video5secondviewrate": 22.52,
"branded_searches": 322
}
]
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 6 | 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 | 478WOD3-7404-9BDF-8F41-01F0401D1305 | 必填 | 请求链路id |
| 6 | response_time | 响应时间 | string | 2023-02-17 09:59:19 | 必填 | 响应时间 |
| 7 | total | 总数 | integer | 1 | 必填 | 总数 |
| 8 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 8.1 | clicks | 点击量 | number | 14 | 必填 | 点击量 |
| 8.2 | cost | 花费 | number | 12.61 | 必填 | 花费 |
| 8.3 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | 必填 | 亚马逊店铺数字id |
| 8.4 | impressions | 展示量 | number | 865 | 必填 | 展示量 |
| 8.5 | report_date | 报表日期 | string | 2021-06-23 | 必填 | 报表日期 |
| 8.6 | campaign_id | 广告活动id | number | 162632371880150 | 必填 | 广告活动id |
| 8.7 | placement_type | 广告位类型 | string | Otheron-Amazon | 必填 | 广告位类型 |
| 8.8 | orders | 订单数 | number | 3 | 必填 | 订单数 |
| 8.9 | new_to_brand_orders | 品牌新买家订单数量 | number | — | 必填 | 品牌新买家订单数量 |
| 8.10 | new_to_brand_units | 品牌新买家销量 | number | — | 必填 | 品牌新买家销量 |
| 8.11 | new_to_brand_sales | 品牌新买家销售额 | number | 0 | 必填 | 品牌新买家销售额 |
| 8.12 | new_to_brand_order_percentage | 品牌新买家订单百分比 | number | 0 | 必填 | 品牌新买家订单百分比 |
| 8.13 | new_to_brand_order_rate | 品牌新买家转换率 | number | 0 | 必填 | 品牌新买家转换率 |
| 8.14 | sales | 销售额 | number | 42.48 | 必填 | 销售额 |
| 8.15 | creative_type | 广告类型 | string | video | 必填 | 广告类型: default=》SB video=》SBV 因亚马逊接口变更,已作废,具体创意类型请以SB广告创意对应ad_group_id ad_id对应的 creative->type 为准 |
| 8.16 | units | 销量 | number | 453 | 必填 | 销量 |
| 8.17 | same_units | 直接成交量 | number | 453 | 必填 | 直接成交量 |
| 8.18 | videofirstquartileviews | 播放25%的次数 | number | 1002 | 必填 | 播放25%的次数 |
| 8.19 | videomidpointviews | 播放50%的次数 | number | 100 | 必填 | 播放50%的次数 |
| 8.20 | videothirdquartileviews | 播放75%的次数 | number | 52 | 必填 | 播放75%的次数 |
| 8.21 | video5secondviews | 5秒观看次数 | number | 1223 | 必填 | 5秒观看次数 |
| 8.22 | video5secondviewrate | 5秒观看率 | number | 22.52 | 必填 | 5秒观看率 |
| 8.23 | branded_searches | 品牌搜索次数 | number | 322 | 必填 | 品牌搜索次数 |
领星ERP的接口:SB广告活动 - 广告位报告(/pb/openapi/newad/hsaCampaignPlacementReports),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。