轻易云
注册体验

领星ERPSP投放小时数据接口

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

SP投放小时数据

POST/pb/openapi/newad/spTargetHourData
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/spTargetHourData"
  },
  "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": 23,
        "campaign_id": 532580134831120,
        "ad_id": 347244425807704,
        "asin": "B085M7XMJF",
        "match_type": "EXACT",
        "impressions": 34,
        "clicks": 7,
        "cost": 3.52,
        "same_orders": 2,
        "orders": 1,
        "same_sales": 28.89,
        "sales": 54.03,
        "same_units": 3,
        "units": 11,
        "ctr": 0.2059,
        "cpc": 0.5,
        "cvr": 0.1429,
        "cpa": 3.52,
        "acos": 0.0651,
        "roas": 15.35,
        "group_id": 287918863539910,
        "msku": null,
        "targeting_id": 339153487021379,
        "targeting": "spotting scope with rangefinder"
      }
    ],
    "total": 1167,
    "next_token": null,
    "error_details": [],
    "request_id": "f884f0a6-f1e9-49d1-b144-a85ee4b57ed9",
    "response_time": "2024-05-28 17:38:00"
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1report_date报告日期string—必填报告日期,格式:Y-m-d 只能查询最近61天(最早为当天往前第61天,最晚为当天,含两端)
2campaign_id广告活动idnumber—可选广告活动id,必须为正整数;与campaign_ids至少传入一个,两者会合并去重
3campaign_ids广告活动id列表array<any>—可选广告活动id列表,与campaign_id合并去重后最多50个,元素必须为正整数
4agg_dimension聚合维度(区分大小写)string—必填聚合维度(区分大小写): target 投放维度 both_ad_target 广告+投放维度 both_target_placement 投放+广告位placement维度 all_ad_target_placement 广告+投放+广告位placement维度

接口响应参数

序号字段名称类型默认值必填描述
1code状态码number0必填状态码,0 成功
2message提示消息string操作成功必填提示消息
3total总数(等于data数组的条数)number1167必填总数(等于data数组的条数)
4next_token游标分页tokenstring—必填游标分页token,本接口无分页,恒为null
5error_details错误信息array<any>—必填错误信息
6request_id请求链路idstringf884f0a6-f1e9-49d1-b144-a85ee4b57ed9必填请求链路id
7response_time响应时间string2024-05-28 17:38:00必填响应时间
8data响应数据array<object>—必填响应数据
8.1profile_id店铺idnumber2537307927915183必填店铺id
8.2report_date报告日期string2024-05-25必填报告日期
8.3hour小时number23必填小时: 0 表示0-1点之间 1 表示 1-2点之间 以此类推
8.4campaign_id广告活动idnumber532580134831120必填广告活动id
8.5ad_idad_idnumber347244425807704必填广告id【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回】
8.6asinasinstringB085M7XMJF必填广告对应asin【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回;匹配不到广告信息时为null】
8.7mskumskustring—必填广告对应msku【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回;匹配不到广告信息时为null】
8.8match_typematch_typestringEXACT必填匹配方式【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回;数据仅存在于转化表时可能为null】
8.9targeting_idtargeting_idnumber339153487021379必填投放id【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回】
8.10targetingtargetingstringspotting scope with rangefinder必填投放表达式【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回;数据仅存在于转化表时可能为null】
8.11placementplacementstring—必填广告位【agg_dimension 为 both_target_placement 或 all_ad_target_placement 时返回】
8.12impressions曝光量(无流量数据时为0)number34必填曝光量(无流量数据时为0)
8.13clicks点击量(无流量数据时为0)number7必填点击量(无流量数据时为0)
8.14cost花费(无流量数据时为0)number3.52必填花费(无流量数据时为0)
8.15same_orders直接成交订单(无转化数据时为0)number2必填直接成交订单(无转化数据时为0)
8.16orders订单数(无转化数据时为0)number1必填订单数(无转化数据时为0)
8.17same_sales直接销售额(无转化数据时为0)number28.89必填直接销售额(无转化数据时为0)
8.18sales销售额(无转化数据时为0)number54.03必填销售额(无转化数据时为0)
8.19same_units直接成交销量(无转化数据时为0)number3必填直接成交销量(无转化数据时为0)
8.20units销量(无转化数据时为0)number11必填销量(无转化数据时为0)
8.21ctr点击/曝光【保留4位小数number0.2059必填点击/曝光【保留4位小数;曝光量为0时为null】
8.22cpc花费/点击【保留2位小数number0.5必填花费/点击【保留2位小数;点击量为0时为null】
8.23cvr订单数/点击【保留4位小数number0.1429必填订单数/点击【保留4位小数;点击量为0时为null】
8.24cpa花费/订单数【保留2位小数number3.52必填花费/订单数【保留2位小数;订单数为0时为null】
8.25acos花费/销售额【保留4位小数number0.0651必填花费/销售额【保留4位小数;销售额为0时为null】
8.26roas销售额/花费【保留2位小数number15.35必填销售额/花费【保留2位小数;花费为0时为null】
8.27group_id广告组idnumber287918863539910必填广告组id

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

需要对接这个接口?

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