轻易云
注册体验

领星ERP分页查询广告活动报告列表接口

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

分页查询广告活动报告列表

POST/basicOpen/multiplatform/ads/shopee/campaign/report/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/shopee/campaign/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/shopee/campaign/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"page\": {\n        \"page\": 1,\n        \"length\": 20,\n        \"orderField\": \"cost\",\n        \"orderType\": \"desc\"\n    },\n    \"period\": {\n        \"startDate\": \"2026-03-01\",\n        \"endDate\": \"2026-03-17\"\n    },\n    \"filter\": {\n        \"shopIds\": [10001,10002],\n        \"campaignIds\": [20001,20002],\n        \"campaignName\": \"春季大促\",\n        \"statusCodes\": [\"ongoing\",\"paused\"],\n        \"placementCategories\": [\"search\",\"discovery\"],\n        \"itemIds\": [30001,30002]\n    }\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
      "total": 128,
      "page": 1,
      "length": 20,
      "list": [
        {
          "dimension": "campaign-20001",
          "itemIds": [
            "30001",
            "30002"
          ],
          "currencyCode": "USD",
          "campaignId": 20001,
          "campaignName": "Shopee 春季大促",
          "storeId": 10001,
          "shopId": 900001,
          "lxName": "Shopee-SG-001",
          "statusCode": "ongoing",
          "statusDisplayName": "进行中",
          "startTime": "2026-03-01 00:00:00",
          "endTime": "2026-03-31 23:59:59",
          "targetType": "manual",
          "targetTypeDisplayName": "手动",
          "biddingType": "auto",
          "biddingTypeDisplayName": "自动",
          "placementCategory": "search",
          "placementCategoryDisplayName": "搜索",
          "campaignBudget": 1000.5,
          "roasTarget": 2.5,
          "dailyDiscoverStatus": "active",
          "dailyDiscoverBid": 0.3,
          "youMayAlsoLikeStatus": "inactive",
          "youMayAlsoLikeBid": 0.25,
          "impression": 15000,
          "clicks": 850,
          "cost": 320.5,
          "directOrder": 35,
          "broadOrder": 12,
          "directItemSold": 42,
          "broadItemSold": 16,
          "directGmv": 980.6,
          "broadGmv": 210.4,
          "clickPercent": 12.36,
          "ctr": 5.67,
          "cpc": 0.38,
          "directCvr": 4.12,
          "broadCvr": 1.41,
          "directCpa": 9.16,
          "broadCpa": 26.71,
          "directRoas": 3.06,
          "broadRoas": 0.66,
          "directAcos": 32.68,
          "broadAcos": 152.33
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1page分页参数对象object—必填分页参数对象
1.1page当前页码number—必填当前页码,从 1 开始
1.2length每页大小number—必填每页大小
1.3orderField排序字段string—必填排序字段,按返回字段名称排序
1.4orderType排序类型string—必填排序类型: asc 升序 desc 降序
2period时间范围对象object—必填时间范围对象
2.1startDate开始日期string—必填开始日期,格式:yyyy-MM-dd
2.2endDate结束日期string—必填结束日期,格式:yyyy-MM-dd
3filter筛选条件对象object—可选筛选条件对象
3.1shopIds店铺ID列表(复选array<any>—可选店铺ID列表(复选,为空则代表全部)
3.2campaignIds广告活动ID列表(复选array<any>—可选广告活动ID列表(复选,为空则代表全部)
3.3campaignName广告活动名称(模糊搜索)string—可选广告活动名称(模糊搜索)
3.4statusCodes广告活动状态列表(复选array<any>—可选广告活动状态列表(复选,为空时为全部): ongoing 进行中 scheduled 已计划 ended 已结束 paused 已暂停 deleted 已删除 closed 已关闭
3.5placementCategories广告位类别列表(复选array<any>—可选广告位类别列表(复选,为空时为全部): search 搜索 discovery 展示 all 全部
3.6itemIds商品ID列表(复选array<any>—可选商品ID列表(复选,为空则代表全部)

接口响应参数

序号字段名称类型默认值必填描述
1code状态码number0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>[]必填数据校验失败时的错误详情
4request_id请求链路idstringccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035必填请求链路id
5response_time响应时间string2025-10-23 00:47:29必填响应时间
6data响应数据object—必填响应数据
6.1total总记录数number128必填总记录数
6.2page当前页码number1必填当前页码
6.3length每页大小number20必填每页大小
6.4list数据列表array<object>—必填数据列表
6.4.1dimension唯一标识stringcampaign-20001可选唯一标识
6.4.2itemIds商品ID列表array<any>["30001","30002"]必填商品ID列表
6.4.3currencyCode币种代码stringUSD可选币种代码
6.4.4campaignId广告活动IDnumber20001可选广告活动ID
6.4.5campaignName广告活动名称stringShopee 春季大促可选广告活动名称
6.4.6storeId店铺IDnumber10001可选店铺ID
6.4.7shopIdShopee 店铺IDnumber900001可选Shopee 店铺ID
6.4.8lxName店铺展示名称stringShopee-SG-001可选店铺展示名称
6.4.9statusCode广告活动状态编码stringongoing可选广告活动状态编码: ongoing 进行中 scheduled 已计划 ended 已结束 paused 已暂停 deleted 已删除 closed 已关闭
6.4.10statusDisplayName状态显示名称(国际化)string进行中可选状态显示名称(国际化)
6.4.11startTime广告活动开始时间string2026-03-01 00:00:00可选广告活动开始时间
6.4.12endTime广告活动结束时间string2026-03-31 23:59:59可选广告活动结束时间
6.4.13targetType预算类型stringmanual可选预算类型: auto 自动 manual 手动
6.4.14targetTypeDisplayName预算类型显示名称(国际化)string手动可选预算类型显示名称(国际化)
6.4.15biddingType竞价类型stringauto可选竞价类型: auto 自动 manual 手动
6.4.16biddingTypeDisplayName竞价类型显示名称(国际化)string自动可选竞价类型显示名称(国际化)
6.4.17placementCategory广告位类别stringsearch可选广告位类别: search 搜索 discovery 展示 all 全部
6.4.18placementCategoryDisplayName广告位类别显示名称(国际化)string搜索可选广告位类别显示名称(国际化)
6.4.19campaignBudget广告活动预算number1000.5可选广告活动预算
6.4.20roasTarget目标ROASnumber2.5可选目标ROAS
6.4.21dailyDiscoverStatus每日发现广告位状态stringactive可选每日发现广告位状态: active 启用 inactive 停用
6.4.22dailyDiscoverBid每日发现广告位竞价number0.3可选每日发现广告位竞价
6.4.23youMayAlsoLikeStatus猜你喜欢广告位状态stringinactive可选猜你喜欢广告位状态: active 启用 inactive 停用
6.4.24youMayAlsoLikeBid猜你喜欢广告位竞价number0.25可选猜你喜欢广告位竞价
6.4.25impression曝光量number15000可选曝光量
6.4.26clicks点击量number850可选点击量
6.4.27cost广告花费number320.5可选广告花费
6.4.28directOrder广告订单(直接订单)number35可选广告订单(直接订单)
6.4.29broadOrder间接订单number12可选间接订单
6.4.30directItemSold广告销量(直接售出商品数)number42可选广告销量(直接售出商品数)
6.4.31broadItemSold间接销量(间接售出商品数)number16可选间接销量(间接售出商品数)
6.4.32directGmv广告GMV(直接GMV)number980.6可选广告GMV(直接GMV)
6.4.33broadGmv间接GMVnumber210.4可选间接GMV
6.4.34clickPercent点击百分比(点击量占查询结果总点击量的百分比)number12.36可选点击百分比(点击量占查询结果总点击量的百分比)
6.4.35ctrctrnumber5.67可选CTR - 点击率(点击量/曝光量 * 100%)
6.4.36cpcCPC - 每次点击成本(广告花费/点击量)number0.38可选CPC - 每次点击成本(广告花费/点击量)
6.4.37directCvrdirectCvrnumber4.12可选CVR - 转化率(广告订单/点击量 * 100%)
6.4.38broadCvrbroadCvrnumber1.41可选间接CVR - 间接转化率(间接订单/点击量 * 100%)
6.4.39directCpaCPA - 每笔订单花费(广告花费/广告订单)number9.16可选CPA - 每笔订单花费(广告花费/广告订单)
6.4.40broadCpabroadCpanumber26.71可选间接CPA - 每笔间接订单花费(广告花费/间接订单)
6.4.41directRoasdirectRoasnumber3.06可选广告ROAS - 广告支出回报率(广告GMV/广告花费)
6.4.42broadRoasbroadRoasnumber0.66可选间接ROAS - 间接广告支出回报率(间接GMV/广告花费)
6.4.43directAcosdirectAcosnumber32.68可选广告ACoS - 广告销售成本(广告花费/广告GMV * 100%)
6.4.44broadAcosbroadAcosnumber152.33可选间接ACoS - 间接广告销售成本(广告花费/间接GMV * 100%)

领星ERP的接口:分页查询广告活动报告列表(/basicOpen/multiplatform/ads/shopee/campaign/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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