/basicOpen/multiplatform/ads/reportAdItemSpList{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/ads/reportAdItemSpList"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/reportAdItemSpList?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"advertiserIds\": [123456789012345,987654321098765],\n \"campaignType\": [\"sponsoredProducts-manual\",\"sponsoredProducts-auto\"],\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 \"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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | advertiserIds | 广告账号ID列表 | array<any> | — | Optional | 广告账号ID列表,BigInteger数组,必填,必须至少选择一个店铺 |
| 2 | campaignType | 广告活动类型列表 | array<any> | — | Optional | 广告活动类型列表,String数组,必填,枚举值:sponsoredProducts-manual(SP手动), sponsoredProducts-auto(SP自动), sba(SB品牌广告), video(SV视频广告)。注意:查询SP广告报告必须且只能携带sponsoredProducts-manual和sponsoredProducts-auto |
| 3 | endDate | 结束日期 | string | — | Optional | 结束日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天 |
| 4 | startDate | 开始日期 | string | — | Optional | 开始日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天 |
| 5 | adGroupIds | 广告组ID列表 | array<any> | — | Optional | 广告组ID列表,Long数组,按广告组ID筛选 |
| 6 | campaignIds | 广告活动ID列表 | array<any> | — | Optional | 广告活动ID列表,Long数组,按广告活动ID筛选 |
| 7 | day | 归因天数 | integer | — | Optional | 归因天数,数据归因天数,枚举值:3, 14, 30,默认14天 |
| 8 | orderField | 排序字段 | 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)等所有返回的报表字段。不传时默认按广告花费倒序 |
| 9 | orderType | 排序类型 | string | — | Optional | 排序类型,枚举值:ASC-升序, DESC-降序,不传时默认ASC |
| 10 | pageNum | 页码 | integer | — | Optional | 页码,分页时的页码,从1开始 |
| 11 | pageSize | 每页大小 | integer | — | Optional | 每页大小,分页时每页显示的记录数,最大200 |
| 12 | paging | 是否分页 | boolean | — | Optional | 是否分页,默认为true |
| 13 | searchText | 搜索文本 | string | — | Optional | 搜索文本,模糊搜索广告名称(ad_name) |
| 14 | searchType | 搜索类型 | string | — | Optional | 搜索类型,目前不用传 |
| 15 | status | 广告状态列表 | array<any> | — | Optional | 广告状态列表,String数组,枚举值:enabled-启用, disabled-禁用 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 响应码 | integer | — | Required | 响应码 |
| 2 | data | 返回数据 | object | — | Required | 返回数据 |
| 2.1 | list | 列表数据 | array<object> | — | Required | 列表数据,广告项报表详细数据列表 |
| 2.1.1 | acos | 广告成本占比(ACoS) | string | 22.5 | Required | 广告成本占比(ACoS),计算公式:广告花费 / 广告销售额 * 100% |
| 2.1.2 | adGroupId | 广告组ID | string | 456789123 | Required | 广告组ID |
| 2.1.3 | adGroupName | 广告组名称 | string | 热销商品广告组 | Required | 广告组名称 |
| 2.1.4 | adGroupStatus | 广告组状态 | string | enabled | Required | 广告组状态,枚举值:enabled-启用, disabled-禁用,delete-归档 |
| 2.1.5 | adItemId | 广告项ID | string | 789456123 | Required | 广告项ID |
| 2.1.6 | adName | 广告名称 | string | 双十一爆款商品广告 | Required | 广告名称 |
| 2.1.7 | adSpend | 广告花费 | string | 456.78 | Required | 广告花费,广告投放的总花费金额 |
| 2.1.8 | adStatus | 广告状态 | string | enabled | Required | 广告状态,枚举值:enabled-启用, disabled-禁用, deleted-已删除 |
| 2.1.9 | addDate | 添加日期 | string | 2024-10-15 | Required | 添加日期,格式:yyyy-MM-dd |
| 2.1.10 | advertisedSkuSales | 直接销售额 | string | 3456.78 | Required | 直接销售额,广告直接点击归因销售额 |
| 2.1.11 | advertisedSkuUnits | 直接销量 | string | 89 | Required | 直接销量,广告直接点击归因销量 |
| 2.1.12 | advertiserId | 广告账号ID | string | 987654321098765 | Required | 广告账号ID |
| 2.1.13 | aov | 平均订单值(AOV) | string | 45.67 | Required | 平均订单值(AOV),计算公式:广告销售额 / 广告订单 |
| 2.1.14 | appliedTemplate | 应用的分时策略模板信息 | array<object> | — | Required | 应用的分时策略模板信息,AppliedTemplate对象数组 |
| 2.1.14.1 | benchmarkFixedVal | 基准固定值 | string | 1.5 | Required | 基准固定值,分时策略的固定基准值 |
| 2.1.14.2 | benchmarkType | 基准类型 | string | 1 | Required | 基准类型,枚举值:1-固定值, 2-动态值 |
| 2.1.14.3 | curBenchmarkVal | 当前基准值 | string | 1.8 | Required | 当前基准值,当前实际使用的基准值 |
| 2.1.14.4 | effectiveTime | 生效时间范围 | object | — | Required | 生效时间范围,EffectiveTime对象 |
| 2.1.14.4.1 | begin | 开始时间 | string | 2024-01-01 00:00:00 | Required | 开始时间,格式:yyyy-MM-dd HH:mm:ss |
| 2.1.14.4.2 | end | 结束时间 | string | 2024-12-31 23:59:59 | Required | 结束时间,格式:yyyy-MM-dd HH:mm:ss |
| 2.1.14.5 | id | 模板ID | string | 100234 | Required | 模板ID,分时策略模板的唯一标识 |
| 2.1.14.6 | taskName | 任务名称 | string | 晚高峰竞价提升策略 | Required | 任务名称,分时策略任务名称 |
| 2.1.14.7 | taskStatus | 任务状态 | string | 1 | Required | 任务状态,枚举值:0-未启用, 1-已启用, 2-已暂停 |
| 2.1.14.8 | taskType | 任务类型 | string | BID_ADJUSTMENT | Required | 任务类型,枚举值:BID_ADJUSTMENT-竞价调整, STATUS_CONTROL-状态控制, BUDGET_ADJUSTMENT-预算调整 |
| 2.1.14.9 | timezone | 时区 | string | America/Los_Angeles | Required | 时区,如:America/Los_Angeles |
| 2.1.15 | attributedOrders | 广告订单数 | string | 112 | Required | 广告订单数,归因总订单数 |
| 2.1.16 | attributedSales | 广告销售额 | string | 5678.9 | Required | 广告销售额,归因总销售额 |
| 2.1.17 | attributedUnits | 广告销量 | string | 156 | Required | 广告销量,归因总销量 |
| 2.1.18 | benchmarkVal | 基准值 | string | 1.5 | Required | 基准值,分时策略的基准值 |
| 2.1.19 | bid | 竞价 | string | 0.85 | Required | 竞价,当前出价金额 |
| 2.1.20 | campaignAndTargetingType | 广告活动和投放类型组合 | string | sponsoredProducts-手动定向 | Required | 广告活动和投放类型组合,格式:campaignType+targetingType |
| 2.1.21 | campaignId | 广告活动ID | string | 123456789 | Required | 广告活动ID |
| 2.1.22 | campaignName | 广告活动名称 | string | 双十一大促活动 | Required | 广告活动名称 |
| 2.1.23 | campaignStatus | 广告活动状态 | string | live | Required | 广告活动状态,枚举值:enabled-启用, paused-暂停, scheduled-已安排, rescheduled-重新安排, live-运行中, proposal-提议, completed-已完成 |
| 2.1.24 | campaignType | 广告活动类型 | string | sponsoredProducts | Required | 广告活动类型,枚举值:sponsoredProducts-SP广告, sba-SB品牌广告, video-SV视频广告 |
| 2.1.25 | cpa | 平均订单成本(CPA) | string | 3.25 | Required | 平均订单成本(CPA),计算公式:广告花费 / 广告订单 |
| 2.1.26 | cpc | 点击成本(CPC) | string | 0.45 | Required | 点击成本(CPC),计算公式:广告花费 / 点击量 |
| 2.1.27 | ctr | 点击率(CTR) | string | 1.85 | Required | 点击率(CTR),计算公式:点击量 / 曝光量 * 100% |
| 2.1.28 | cvr | 转化率(CVR) | string | 9.07 | Required | 转化率(CVR),计算公式:广告订单 / 点击量 * 100% |
| 2.1.29 | entityCreateAt | 创建时间 | string | 2024-11-12 10:30:00 | Required | 创建时间,实体创建时间 |
| 2.1.30 | isApplyTime | 是否应用分时策略 | string | 1 | Required | 是否应用分时策略 |
| 2.1.31 | itemId | 商品ID | string | 987654321 | Required | 商品ID |
| 2.1.32 | itemImageUrl | 商品图片URL | string | https://i5.walmartimages.com/asr/123456.jpeg | Required | 商品图片URL |
| 2.1.33 | itemPageUrl | 商品详情页URL | string | https://www.walmart.com/ip/123456789 | Required | 商品详情页URL,商品在平台的链接地址 |
| 2.1.34 | key | 唯一键 | string | 123456789 | Required | 唯一键,用于前端列表展示,取值为adItemId或itemId |
| 2.1.35 | mpAdvertiserName | 广告账号名称 | string | Walmart广告账号A | Required | 广告账号名称 |
| 2.1.36 | mpSellerName | 店铺名称 | string | Walmart官方旗舰店 | Required | 店铺名称 |
| 2.1.37 | ntbOrderRate | 品牌新买家订单转化率 | string | 2.59 | Required | 品牌新买家订单转化率,计算公式:ntbOrders / numAdsClicks * 100% |
| 2.1.38 | ntbOrders | 品牌新买家订单数 | string | 32 | Required | 品牌新买家订单数,首次购买该品牌的买家产生的订单数 |
| 2.1.39 | ntbOrdersPercent | 品牌新买家订单占比 | string | 28.5 | Required | 品牌新买家订单占比,计算公式:ntbOrders / attributedOrders * 100% |
| 2.1.40 | ntbRevenue | 品牌新买家销售额 | string | 1234.56 | Required | 品牌新买家销售额,首次购买该品牌的买家产生的销售额 |
| 2.1.41 | ntbRevenuePercent | 品牌新买家销售额占比 | string | 21.7 | Required | 品牌新买家销售额占比,计算公式:ntbRevenue / attributedSales * 100% |
| 2.1.42 | ntbUnits | 品牌新买家销量 | string | 45 | Required | 品牌新买家销量,首次购买该品牌的买家购买数量 |
| 2.1.43 | ntbUnitsPercent | 品牌新买家销量占比 | string | 28.8 | Required | 品牌新买家销量占比,计算公式:ntbUnits / attributedUnits * 100% |
| 2.1.44 | numAdsClicks | 广告点击量 | string | 1234 | Required | 广告点击量,广告被点击的总次数 |
| 2.1.45 | numAdsShown | 曝光次数 | string | 67890 | Required | 曝光次数,广告被展示的总次数 |
| 2.1.46 | otherSkuSales | 关联销售额 | string | 2222.33 | Required | 关联销售额,间接归因销售额 |
| 2.1.47 | otherSkuUnits | 关联销量 | string | 67 | Required | 关联销量,间接归因销量 |
| 2.1.48 | reviewReason | 审核拒绝原因 | string | — | Required | 审核拒绝原因 |
| 2.1.49 | reviewStatus | 审核状态 | string | approved | Required | 审核状态 |
| 2.1.50 | roas | 投入产出比(ROAS) | string | 4.56 | Required | 投入产出比(ROAS),计算公式:广告销售额 / 广告花费 |
| 2.1.51 | suggestedBid | 建议竞价 | string | 1.25 | Required | 建议竞价,系统推荐的竞价金额 |
| 2.2 | total | 总记录数 | string | 2345 | Required | 总记录数,返回符合条件的数据总数 |
| 3 | error_details | 错误详情 | array<any> | — | Required | 错误详情 |
| 4 | message | 提示信息 | string | — | Required | 提示信息 |
| 5 | request_id | 请求id | string | — | Required | 请求id |
| 6 | response_time | 响应时间 | string | — | Required | 响应时间 |
| 7 | total | 总记录数 | integer | — | Required | 总记录数 |
The 查询沃尔玛 - 广告 - SP广告 - 广告 API (/basicOpen/multiplatform/ads/reportAdItemSpList) 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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.