轻易云
注册体验

领星ERPSB广告活动 - 广告位报告接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
广告 / 报告 · POST · 请求参数 6 个(必填 3) · 响应参数 31 个 · 限流令牌桶容量 10
更新日期
2026-11-21

SB广告活动 - 广告位报告

POST/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
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1next_token分页游标string—可选分页游标,使用上次响应中的 next_token。首次请求无需传入;与 offset 同时传入时,以 next_token 为准
2sid店铺idinteger—必填店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
3profile_idVC广告店铺profile_idinteger—必填VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
4report_date报表日期string—必填报表日期,格式:Y-m-d
5offset分页偏移量integer—可选分页偏移量,默认0
6length分页长度integer—可选分页长度,默认15

接口响应参数

序号字段名称类型默认值必填描述
1next_token分页游标stringODAwMDAwMDAwMDAwMDAyNDE3必填分页游标,作为 next_token 传入下一次请求
2code状态码integer0必填状态码,0 成功
3message提示消息string操作成功必填提示消息
4error_details错误信息array<any>—必填错误信息
5request_id请求链路idstring478WOD3-7404-9BDF-8F41-01F0401D1305必填请求链路id
6response_time响应时间string2023-02-17 09:59:19必填响应时间
7total总数integer1必填总数
8data响应数据array<object>—必填响应数据
8.1clicks点击量number14必填点击量
8.2cost花费number12.61必填花费
8.3profile_id亚马逊店铺数字idnumber121923590660074必填亚马逊店铺数字id
8.4impressions展示量number865必填展示量
8.5report_date报表日期string2021-06-23必填报表日期
8.6campaign_id广告活动idnumber162632371880150必填广告活动id
8.7placement_type广告位类型stringOtheron-Amazon必填广告位类型
8.8orders订单数number3必填订单数
8.9new_to_brand_orders品牌新买家订单数量number—必填品牌新买家订单数量
8.10new_to_brand_units品牌新买家销量number—必填品牌新买家销量
8.11new_to_brand_sales品牌新买家销售额number0必填品牌新买家销售额
8.12new_to_brand_order_percentage品牌新买家订单百分比number0必填品牌新买家订单百分比
8.13new_to_brand_order_rate品牌新买家转换率number0必填品牌新买家转换率
8.14sales销售额number42.48必填销售额
8.15creative_type广告类型stringvideo必填广告类型: default=》SB video=》SBV 因亚马逊接口变更,已作废,具体创意类型请以SB广告创意对应ad_group_id ad_id对应的 creative->type 为准
8.16units销量number453必填销量
8.17same_units直接成交量number453必填直接成交量
8.18videofirstquartileviews播放25%的次数number1002必填播放25%的次数
8.19videomidpointviews播放50%的次数number100必填播放50%的次数
8.20videothirdquartileviews播放75%的次数number52必填播放75%的次数
8.21video5secondviews5秒观看次数number1223必填5秒观看次数
8.22video5secondviewrate5秒观看率number22.52必填5秒观看率
8.23branded_searches品牌搜索次数number322必填品牌搜索次数

领星ERP的接口:SB广告活动 - 广告位报告(/pb/openapi/newad/hsaCampaignPlacementReports),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。