轻易云
注册体验

领星ERP查询沃尔玛 - 广告 - SB广告 - 页面类型接口

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

查询沃尔玛 - 广告 - SB广告 - 页面类型

POST/basicOpen/multiplatform/ads/reportPageTypeSbList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/reportPageTypeSbList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/reportPageTypeSbList?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"advertiserIds\": [123456789012345,987654321098765],\n    \"campaignType\": [\"sba\"],\n    \"endDate\": \"2024-12-31\",\n    \"startDate\": \"2024-01-01\",\n    \"adGroupIds\": [123456789,987654321],\n    \"campaignIds\": [123456789,987654321],\n    \"day\": 14,\n    \"orderField\": \"adSpend\",\n    \"orderType\": \"DESC\",\n    \"pageNum\": 1,\n    \"pageSize\": 20,\n    \"pageType\": [\"item\",\"search\"],\n    \"paging\": \"1\",\n    \"searchText\": \"双十一促销活动\",\n    \"searchType\": \"value\",\n    \"status\": [\"enabled\",\"live\"]\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视频广告)。注意:查询SB广告报告必须且只能携带sba
3endDate结束日期string—可选结束日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
4startDate开始日期string—可选开始日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
5adGroupIds广告组ID列表array<any>—可选广告组ID列表,Long数组,按广告组ID筛选
6campaignIds广告活动ID列表array<any>—可选广告活动ID列表,Long数组,按广告活动ID筛选
7day归因天数integer—可选归因天数,数据归因天数,枚举值:3, 14, 30,默认14天
8orderField排序字段string—可选排序字段,支持对查询结果中的任意字段进行排序(驼峰命名)。包括:基础指标(numAdsShown/numAdsClicks/adSpend)、销售指标(attributedSales/attributedOrders/attributedUnits/advertisedSkuSales/advertisedSkuUnits)、关联指标(otherSkuSales/otherSkuUnits)、品牌新买家指标(ntbOrders/ntbRevenue/ntbUnits)、计算指标(cpc/ctr/cvr/acos/roas/aov/cpa)、时间字段(startDate/endDate/entityCreateAt)等所有返回的报表字段。不传时默认按广告花费倒序
9orderType排序类型string—可选排序类型,枚举值:ASC-升序, DESC-降序,不传时默认ASC
10pageNum页码integer—可选页码,分页时的页码,从1开始
11pageSize每页大小integer—可选每页大小,分页时每页显示的记录数,最大200
12pageType页面类型列表array<any>—可选页面类型列表,String数组,枚举值:browse-浏览, item-商品, search-搜索, topic-主题, category-分类, homepage-首页, other-其他
13paging是否分页boolean—可选是否分页,默认为true
14searchText搜索文本string—可选搜索文本,模糊搜索广告活动名称(campaign_name)
15searchType搜索类型string—可选搜索类型,目前不用传
16status广告活动状态列表array<any>—可选广告活动状态列表,String数组,枚举值:enabled-启用, paused-暂停, scheduled-已安排, rescheduled-重新安排, live-运行中, proposal-提议, completed-已完成

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1list列表数据array<object>—必填列表数据,页面类型报表详细数据列表
2.1.1acos广告成本占比(ACoS)string16.3必填广告成本占比(ACoS),计算公式:广告花费 / 广告销售额 * 100%
2.1.2adGroupId广告组IDstring456789123必填广告组ID
2.1.3adGroupName广告组名称string热销商品广告组必填广告组名称
2.1.4adSpend广告花费string1226.34必填广告花费,广告投放的总花费金额
2.1.5advertisedSkuSales直接销售额string6789.12必填直接销售额,广告直接点击归因销售额
2.1.6advertisedSkuUnits直接销量string112必填直接销量,广告直接点击归因销量
2.1.7advertiserId广告账号IDstring987654321098765必填广告账号ID
2.1.8aov平均订单值(AOV)string68.9必填平均订单值(AOV),计算公式:广告销售额 / 广告订单
2.1.9attributedOrders广告订单数string178必填广告订单数,归因总订单数
2.1.10attributedSales广告销售额string12256.01必填广告销售额,归因总销售额
2.1.11attributedUnits广告销量string178必填广告销量,归因总销量
2.1.12campaignAndTargetingName广告活动和投放类型组合stringsba-手动定向必填广告活动和投放类型组合,格式:campaignType+targetingType
2.1.13campaignId广告活动IDstring123456789必填广告活动ID
2.1.14campaignName广告活动名称string双十一大促活动必填广告活动名称
2.1.15campaignStatus广告活动状态stringlive必填广告活动状态,枚举值:enabled-启用, paused-暂停, scheduled-已安排, rescheduled-重新安排, live-运行中, proposal-提议, completed-已完成
2.1.16campaignType广告活动类型stringsba必填广告活动类型,枚举值:sponsoredProducts-SP广告, sba-SB品牌广告, video-SV视频广告
2.1.17cpa平均订单成本(CPA)string6.89必填平均订单成本(CPA),计算公式:广告花费 / 广告订单
2.1.18cpc点击成本(CPC)string0.57必填点击成本(CPC),计算公式:广告花费 / 点击量
2.1.19ctr点击率(CTR)string2.35必填点击率(CTR),计算公式:点击量 / 曝光量 * 100%
2.1.20cvr转化率(CVR)string8.34必填转化率(CVR),计算公式:广告订单 / 点击量 * 100%
2.1.21date日期string2024-11-12必填日期,数据统计日期,格式:yyyy-MM-dd
2.1.22entityCreateAt创建时间string2024-11-12 10:30:00必填创建时间,实体创建时间
2.1.23inStoreAdvertisedSales实体店广告销售额(未使用)string0必填实体店广告销售额(未使用)
2.1.24inStoreAttributedSales实体店销售额string1234.56必填实体店销售额,实体店归因总销售额
2.1.25inStoreOrders实体店订单数string34必填实体店订单数,实体店归因订单数
2.1.26inStoreOtherSales实体店关联销售额string567.89必填实体店关联销售额,实体店间接归因销售额
2.1.27inStoreUnitsSold实体店销量string89必填实体店销量,实体店归因销量
2.1.28key唯一键string20241112_item_456789123必填唯一键,用于前端列表展示
2.1.29mpAdvertiserName广告账号名称stringWalmart广告账号A必填广告账号名称
2.1.30mpSellerName店铺名称stringWalmart官方旗舰店必填店铺名称
2.1.31ntbOrderRate品牌新买家订单转化率string2.44必填品牌新买家订单转化率,计算公式:ntbOrders / numAdsClicks * 100%
2.1.32ntbOrders品牌新买家订单数string52必填品牌新买家订单数,首次购买该品牌的买家产生的订单数
2.1.33ntbOrdersPercent品牌新买家订单占比string29.2必填品牌新买家订单占比,计算公式:ntbOrders / attributedOrders * 100%
2.1.34ntbRevenue品牌新买家销售额string3367.45必填品牌新买家销售额,首次购买该品牌的买家产生的销售额
2.1.35ntbRevenuePercent品牌新买家销售额占比string27.5必填品牌新买家销售额占比,计算公式:ntbRevenue / attributedSales * 100%
2.1.36ntbUnits品牌新买家销量string52必填品牌新买家销量,首次购买该品牌的买家购买数量
2.1.37ntbUnitsPercent品牌新买家销量占比string29.2必填品牌新买家销量占比,计算公式:ntbUnits / attributedUnits * 100%
2.1.38numAdsClicks广告点击量string2134必填广告点击量,广告被点击的总次数
2.1.39numAdsShown曝光次数string90789必填曝光次数,广告被展示的总次数
2.1.40otherSkuSales关联销售额string4567.89必填关联销售额,间接归因销售额
2.1.41otherSkuUnits关联销量string66必填关联销量,间接归因销量
2.1.42pageType页面类型stringitem必填页面类型,枚举值:browse-浏览, item-商品, search-搜索, topic-主题, category-分类, homepage-首页, other-其他
2.1.43roas投入产出比(ROAS)string6.12必填投入产出比(ROAS),计算公式:广告销售额 / 广告花费
2.2total总记录数string1245必填总记录数,返回符合条件的数据总数
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

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

需要对接这个接口?

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