轻易云
注册体验

领星ERPSP广告小时数据接口

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

SP广告小时数据

POST/pb/openapi/newad/spAdvertiseHourData
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/spAdvertiseHourData"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "data": [
      {
        "profile_id": 2537307927915183,
        "report_date": "2024-05-25",
        "hour": 9,
        "campaign_id": 93889904442110,
        "ad_id": 559437347444970,
        "asin": "B07VC7ZN6P",
        "impressions": 4,
        "clicks": 7,
        "cost": 5.18,
        "same_orders": 1,
        "orders": 6,
        "same_sales": 36.93,
        "sales": 71.82,
        "same_units": 3,
        "units": 5,
        "match_type": "TARGETING_EXPRESSION_PREDEFINED",
        "ctr": 1.75,
        "cpc": 0.74,
        "cvr": 0.8571,
        "cpa": 0.86,
        "acos": 0.0721,
        "roas": 13.86,
        "group_id": 332914711385626,
        "msku": null,
        "targeting_id": 371645786382332,
        "targeting": "complements"
      }
    ],
    "total": 1,
    "error_details": [],
    "request_id": "42d2ba31-e50e-44e4-8870-5b4d945a52ae",
    "response_time": "2024-05-28 17:31:17"
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1report_date报告日期string—必填报告日期,格式:Y-m-d 只能查询最近60天
2campaign_id广告活动idnumber—必填广告活动id
3campaign_ids广告活动id列表array<any>—必填广告活动id列表,最多传50个
4agg_dimension聚合维度string—必填聚合维度: ad 广告维度 both_ad_target 广告+投放维度

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message提示消息string操作成功必填提示消息
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstringDHJ9190-7404-9BDF-3F41-01F0401D1315必填请求链路id
5response_time响应时间string2023-02-17 09:59:19必填响应时间
6total总数integer1必填总数
7data响应数据array<object>—必填响应数据
7.1profile_id店铺idnumber2537307927915183必填店铺id
7.2report_date报告日期string2024-05-25必填报告日期
7.3hour小时number9必填小时: 0 表示0-1点之间 1 表示 1-2点之间 以此类推
7.4campaign_id广告活动idnumber93889904442110必填广告活动id
7.5ad_id广告idnumber559437347444970必填广告id
7.6mskumskustring—必填msku
7.7asinasinobjectB07VC7ZN6P必填asin
7.8impressions曝光量object4必填曝光量
7.9clicks点击量number7必填点击量
7.10cost花费object5.18必填花费
7.11same_orders直接成交订单number1必填直接成交订单
7.12orders订单数number6必填订单数
7.13same_sales直接销售额number36.93必填直接销售额
7.14sales销售额number71.82必填销售额
7.15same_units直接成交销量number3必填直接成交销量
7.16units销量number5必填销量
7.17match_type匹配方式(当聚合维度为stringTARGETING_EXPRESSION_PREDEFINED必填匹配方式(当聚合维度为:both_ad_target 该字段有值)
7.18targeting_id投放id(当聚合维度为number371645786382332必填投放id(当聚合维度为:both_ad_target 该字段有值)
7.19targeting投放表达式(当聚合维度为stringcomplements必填投放表达式(当聚合维度为:both_ad_target 该字段有值)
7.20ctr点击/曝光number1.75必填点击/曝光
7.21cpc花费/点击number0.74必填花费/点击
7.22cvr订单数/点击number0.8571必填订单数/点击
7.23cpa花费/订单数number0.86必填花费/订单数
7.24acos花费/销售额number0.0721必填花费/销售额
7.25roas销售额/花费number13.86必填销售额/花费
7.26group_id广告组idnumber332914711385626必填广告组id

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

需要对接这个接口?

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