Qeasy Cloud
Get Started

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

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 广告 / Walmart广告 · POST · 请求参数 17 个(必填 0) · 响应参数 46 个 · 限流令牌桶容量 1
Updated At
2026-11-21

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

POST/basicOpen/multiplatform/ads/queryAdGroupSvList
Factory
{
  "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1advertiserIds广告账号ID列表array<any>—Optional广告账号ID列表,BigInteger数组,必须至少选择一个店铺
2campaignType广告活动类型列表array<any>—Optional广告活动类型列表,String数组,枚举值:sponsoredProducts-manual(SP手动), sponsoredProducts-auto(SP自动), sba(SB品牌广告), video(SV视频广告)。不传时默认查询所有类型
3dateKey天数据聚合维度string—Optional天数据聚合维度,枚举值:day-按天, week-按周, month-按月。【仅天维度接口使用】
4endDate结束日期string—Optional结束日期,格式: yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
5startDate开始日期string—Optional开始日期,格式: yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
6campaignIds广告活动ID列表array<any>—Optional广告活动ID列表,Long数组,按广告活动ID筛选广告组
7companyId公司IDinteger—Optional公司ID
8day归因天数integer—Optional归因天数,数据归因天数,枚举值:3, 14, 30。默认14天
9operationSourceType操作来源string—Optional操作来源,默认网页操作
10orderField排序字段string—Optional排序字段,支持对查询结果中的任意字段进行排序(驼峰命名)。包括但不限于: 基础指标(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—Optional排序类型,枚举值:ASC-升序, DESC-降序。不传时默认ASC
12pageNum页码integer—Optional页码,分页时的页码,从1开始
13pageSize每页大小integer—Optional每页大小,分页时每页显示的记录数
14paging是否分页boolean—Optional是否分页,默认为true
15searchText搜索文本string—Optional搜索文本,模糊搜索广告组名称(ad_group_name)
16searchType搜索类型string—Optional搜索类型,目前不用传
17status广告组状态列表array<any>—Optional广告组状态列表,String数组,枚举值:enabled-启用, disabled-禁用, delete-归档

Response Parameters

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

The 查询沃尔玛 - 广告 - SV广告 - 广告组 API (/basicOpen/multiplatform/ads/queryAdGroupSvList) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.