轻易云
注册体验

领星ERP查询沃尔玛 - 广告 - SV广告 - 广告组接口

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

查询沃尔玛 - 广告 - SV广告 - 广告组

POST/basicOpen/multiplatform/ads/queryAdGroupSvList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/queryAdGroupSvList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryAdGroupSvList?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"advertiserIds\": [\"123456789\",\"987654321\"],\n    \"campaignType\": [\"video\"],\n    \"dateKey\": \"day\",\n    \"endDate\": \"2024-12-31\",\n    \"startDate\": \"2024-01-01\",\n    \"campaignIds\": [\"100001\",\"100002\"],\n    \"companyId\": 10001,\n    \"day\": 14,\n    \"operationSourceType\": \"web\",\n    \"orderField\": \"adSpend\",\n    \"orderType\": \"DESC\",\n    \"pageNum\": 1,\n    \"pageSize\": 50,\n    \"paging\": \"1\",\n    \"searchText\": \"测试广告组\",\n    \"searchType\": \"value\",\n    \"status\": [\"enabled\",\"disabled\"]\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
      "list": [],
      "total": 100
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1advertiserIds广告账号ID列表array<any>—可选广告账号ID列表,BigInteger数组,必须至少选择一个店铺
2campaignType广告活动类型列表array<any>—可选广告活动类型列表,String数组,枚举值:sponsoredProducts-manual(SP手动), sponsoredProducts-auto(SP自动), sba(SB品牌广告), video(SV视频广告)。不传时默认查询所有类型
3dateKey天数据聚合维度string—可选天数据聚合维度,枚举值:day-按天, week-按周, month-按月。【仅天维度接口使用】
4endDate结束日期string—可选结束日期,格式: yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
5startDate开始日期string—可选开始日期,格式: yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
6campaignIds广告活动ID列表array<any>—可选广告活动ID列表,Long数组,按广告活动ID筛选广告组
7companyId公司IDinteger—可选公司ID
8day归因天数integer—可选归因天数,数据归因天数,枚举值:3, 14, 30。默认14天
9operationSourceType操作来源string—可选操作来源,默认网页操作
10orderField排序字段string—可选排序字段,支持对查询结果中的任意字段进行排序(驼峰命名)。包括但不限于: 基础指标(numAdsShown/numAdsClicks/adSpend)、销售指标(attributedSales/attributedOrders/attributedUnits/advertisedSkuSales/advertisedSkuUnits)、关联指标(otherSkuSales/otherSkuUnits)、品牌新买家指标(ntbOrders/ntbRevenue/ntbUnits)、计算指标(cpc/ctr/cvr/acos/roas/aov/cpa)、时间字段(startDate/endDate/entityCreateAt)等所有返回的报表字段。不传时默认按广告花费倒序
11orderType排序类型string—可选排序类型,枚举值:ASC-升序, DESC-降序。不传时默认ASC
12pageNum页码integer—可选页码,分页时的页码,从1开始
13pageSize每页大小integer—可选每页大小,分页时每页显示的记录数
14paging是否分页boolean—可选是否分页,默认为true
15searchText搜索文本string—可选搜索文本,模糊搜索广告组名称(ad_group_name)
16searchType搜索类型string—可选搜索类型,目前不用传
17status广告组状态列表array<any>—可选广告组状态列表,String数组,枚举值:enabled-启用, disabled-禁用, delete-归档

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1list广告组列表数据array<object>—必填广告组列表数据
2.1.1acos广告成本销售比(ACOS)string23.5必填广告成本销售比(ACOS),计算公式:adSpend / attributedSales
2.1.2adGroupId广告组IDstring8765432109必填广告组ID
2.1.3adGroupName广告组名称string冬季促销广告组必填广告组名称
2.1.4adGroupStatus广告组状态stringenabled必填广告组状态,枚举值:enabled-启用, disabled-禁用, delete-归档
2.1.5adSpend广告花费string1058.75必填广告花费
2.1.6advertisedSkuSales广告SKU销售额string3250.75必填广告SKU销售额
2.1.7advertisedSkuUnits广告SKU销售单元数string156必填广告SKU销售单元数
2.1.8advertiserId广告账号IDstring123456789012345必填广告账号ID
2.1.9aov平均订单价值(AOV)string35.5必填平均订单价值(AOV),计算公式:attributedSales / attributedOrders
2.1.10attributedOrders归因订单数string125必填归因订单数,广告带来的总订单数
2.1.11attributedSales归因销售额string4500.25必填归因销售额,广告带来的总销售额
2.1.12attributedUnits归因销售单元数string194必填归因销售单元数,广告带来的总销售单元数
2.1.13campaignId广告活动IDstring9876543210必填广告活动ID
2.1.14campaignName广告活动名称string2024春季促销活动必填广告活动名称
2.1.15campaignStatus广告活动状态stringenabled必填广告活动状态,枚举值:enabled-启用, disabled-禁用, delete-归档
2.1.16campaignType广告活动类型stringvideo必填广告活动类型,枚举值:sponsoredProducts-manual(SP手动), sponsoredProducts-auto(SP自动), sba(SB品牌广告), video(SV视频广告)
2.1.17cpa单次转化成本(CPA)string8.5必填单次转化成本(CPA),计算公式:adSpend / attributedOrders
2.1.18cpc单次点击成本(CPC)string0.45必填单次点击成本(CPC),计算公式:adSpend / numAdsClicks
2.1.19ctr点击率(CTR)string2.15必填点击率(CTR),计算公式:numAdsClicks / numAdsShown
2.1.20cvr转化率(CVR)string5.32必填转化率(CVR),计算公式:attributedOrders / numAdsClicks
2.1.21entityCreateAt实体创建时间string2024-01-15 10:30:00必填实体创建时间
2.1.22key唯一标识键stringadGroup_8765432109必填唯一标识键
2.1.23mpAdvertiserName广告账号名称string沃尔玛广告账号A必填广告账号名称
2.1.24mpSellerName店铺名称string我的沃尔玛店铺必填店铺名称
2.1.25ntbOrderRate品牌新买家订单率string33.6必填品牌新买家订单率
2.1.26ntbOrders品牌新买家订单数string42必填品牌新买家订单数
2.1.27ntbOrdersPercent品牌新买家订单占比百分比string35.5必填品牌新买家订单占比百分比
2.1.28ntbRevenue品牌新买家销售额string1850.5必填品牌新买家销售额
2.1.29ntbRevenuePercent品牌新买家销售额占比百分比string38.2必填品牌新买家销售额占比百分比
2.1.30ntbUnits品牌新买家购买单元数string45必填品牌新买家购买单元数
2.1.31ntbUnitsPercent品牌新买家购买单元占比百分比string32.8必填品牌新买家购买单元占比百分比
2.1.32numAdsClicks广告点击次数string2350必填广告点击次数
2.1.33numAdsShown广告展示次数string109250必填广告展示次数
2.1.34otherSkuSales其他SKU销售额string850.25必填其他SKU销售额,关联销售额
2.1.35otherSkuUnits其他SKU销售单元数string38必填其他SKU销售单元数,关联销售单元数
2.1.36roas广告投入产出比(ROAS)string4.25必填广告投入产出比(ROAS),计算公式:attributedSales / adSpend
2.1.37targetingType定向类型stringauto必填定向类型
2.2total总记录数string1500必填总记录数
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:查询沃尔玛 - 广告 - SV广告 - 广告组(/basicOpen/multiplatform/ads/queryAdGroupSvList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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