Lingxing
切换旧版

查询沃尔玛 - 广告 - SB广告 - 广告活动

POST/basicOpen/multiplatform/ads/reportCampaignSbList

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ads/reportCampaignSbListHTTPSPOST1

请求参数

advertiserIdsarray<any>
广告账号ID列表,BigInteger数组,必填,必须至少选择一个店铺
campaignTypearray<any>
广告活动类型列表,String数组,必填,枚举值:sponsoredProducts-manual(SP手动), sponsoredProducts-auto(SP自动), sba(SB品牌广告), video(SV视频广告)。注意:查询SB广告报告必须且只能携带sba
endDatestring
结束日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
startDatestring
开始日期,必填,格式:yyyy-MM-dd,且 startDate 和 endDate 间隔不能超过31天
campaignIdsarray<any>
广告活动ID列表,Long数组,按广告活动ID筛选
dayinteger
归因天数,数据归因天数,枚举值:3, 14, 30,默认14天
orderFieldstring
排序字段,支持对查询结果中的任意字段进行排序(驼峰命名)。包括:基础指标(numAdsShown/numAdsClicks/adSpend)、销售指标(attributedSales/attributedOrders/attributedUnits/advertisedSkuSales/advertisedSkuUnits)、关联指标(otherSkuSales/otherSkuUnits)、品牌新买家指标(ntbOrders/ntbRevenue/ntbUnits)、计算指标(cpc/ctr/cvr/acos/roas/aov/cpa)、时间字段(startDate/endDate/entityCreateAt)等所有返回的报表字段。不传时默认按广告花费倒序
orderTypestring
排序类型,枚举值:ASC-升序, DESC-降序,不传时默认ASC
pageNuminteger
页码,分页时的页码,从1开始
pageSizeinteger
每页大小,分页时每页显示的记录数,最大200
pagingboolean
是否分页,默认为true
realtimeinteger
实时数据标识,0-非实时, 1-实时数据
searchTextstring
搜索文本,模糊搜索广告活动名称(campaign_name)
statusarray<any>
广告活动状态列表,String数组,枚举值:enabled-启用, paused-暂停, scheduled-已安排, rescheduled-重新安排, live-运行中, proposal-提议, completed-已完成

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/reportCampaignSbList?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "advertiserIds": [123456789012345,987654321098765],
    "campaignType": ["sba"],
    "endDate": "2024-12-31",
    "startDate": "2024-01-01",
    "campaignIds": [123456789,987654321],
    "day": 14,
    "orderField": "adSpend",
    "orderType": "DESC",
    "pageNum": 1,
    "pageSize": 20,
    "paging": "1",
    "realtime": 0,
    "searchText": "双十一大促活动",
    "status": ["enabled","live"]
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
listarray<object>必填
列表数据,广告活动报表详细数据列表
隐藏子属性
acosstring必填
广告成本占比(ACoS),计算公式:广告花费 / 广告销售额 * 100%
示例 20.5
adSpendstring必填
广告花费,广告投放的总花费金额
示例 2530.45
advertisedSkuSalesstring必填
直接销售额,广告直接点击归因销售额
示例 6789.01
advertisedSkuUnitsstring必填
直接销量,广告直接点击归因销量
示例 123
advertiserIdstring必填
广告账号ID
示例 987654321098765
aovstring必填
平均订单值(AOV),计算公式:广告销售额 / 广告订单
示例 58.9
appliedTemplatearray<object>必填
应用的分时策略模板信息,AppliedTemplate对象数组
隐藏子属性
benchmarkFixedValstring必填
基准固定值,分时策略的固定基准值
示例 1.5
benchmarkTypestring必填
基准类型,枚举值:1-固定值, 2-动态值
示例 1
curBenchmarkValstring必填
当前基准值,当前实际使用的基准值
示例 1.8
effectiveTimeobject必填
生效时间范围,EffectiveTime对象
隐藏子属性
beginstring必填
开始时间,格式:yyyy-MM-dd HH:mm:ss
示例 2024-01-01 00:00:00
endstring必填
结束时间,格式:yyyy-MM-dd HH:mm:ss
示例 2024-12-31 23:59:59
idstring必填
模板ID,分时策略模板的唯一标识
示例 100234
taskNamestring必填
任务名称,分时策略任务名称
示例 晚高峰竞价提升策略
taskStatusstring必填
任务状态,枚举值:0-未启用, 1-已启用, 2-已暂停
示例 1
taskTypestring必填
任务类型,枚举值:BID_ADJUSTMENT-竞价调整, STATUS_CONTROL-状态控制, BUDGET_ADJUSTMENT-预算调整
示例 BID_ADJUSTMENT
timezonestring必填
时区,如:America/Los_Angeles
示例 America/Los_Angeles
attributedOrdersstring必填
广告订单数,归因总订单数
示例 210
attributedSalesstring必填
广告销售额,归因总销售额
示例 12345.67
attributedUnitsstring必填
广告销量,归因总销量
示例 234
benchmarkValstring必填
基准值,分时策略的基准值
示例 100
biddingStrategyobject必填
竞价策略,JSON格式字符串
示例 {"type":"auto","adjustments":[{"predicate":"placementTop","percentage":50}]}
隐藏子属性
biddingStrategyStatusstring必填
竞价策略状态,strategy为TROAS时返回
示例 active
strategystring必填
竞价策略,枚举值:DYNAMIC - 动态竞价,FIXED - 固定竞价, TROAS - 目标竞价
示例 TROAS
troasstring必填
支出回报率,strategy为TROAS时返回
示例 5
budgetTypestring必填
预算类型,枚举值:daily-每日预算, total-总预算, both-两者都有
示例 daily
campaignIdstring必填
广告活动ID
示例 123456789
campaignNamestring必填
广告活动名称
示例 双十一大促活动
campaignStatusstring必填
广告活动状态,枚举值:enabled-启用, paused-暂停, scheduled-已安排, rescheduled-重新安排, live-运行中, proposal-提议, completed-已完成
示例 live
campaignTypestring必填
广告活动类型,枚举值:sponsoredProducts-SP广告, sba-SB品牌广告, video-SV视频广告
示例 sba
completeViewRevenuestring必填
完整观看收入,【仅SV视频广告】
示例 1234.56
cpastring必填
平均订单成本(CPA),计算公式:广告花费 / 广告订单
示例 6.78
cpcstring必填
点击成本(CPC),计算公式:广告花费 / 点击量
示例 0.85
ctrstring必填
点击率(CTR),计算公式:点击量 / 曝光量 * 100%
示例 2.15
cvrstring必填
转化率(CVR),计算公式:广告订单 / 点击量 * 100%
示例 8.95
dailyBudgetstring必填
广告活动每日预算
示例 150
endDatestring必填
广告活动结束日期,格式:yyyy-MM-dd
示例 2024-12-31
entityCreateAtstring必填
创建时间,实体创建时间
示例 2024-11-12 10:30:00
haloCompleteViewRevenuestring必填
光晕完整观看收入,【仅SV视频广告】
示例 567.89
isApplyTimestring必填
是否应用分时策略
示例 1
keystring必填
唯一键,用于前端列表展示
示例 123456789
mpAdvertiserNamestring必填
广告账号名称
示例 Walmart广告账号A
mpSellerNamestring必填
店铺名称
示例 Walmart官方旗舰店
ntbOrderRatestring必填
品牌新买家订单转化率,计算公式:ntbOrders / numAdsClicks * 100%
示例 2.3
ntbOrdersstring必填
品牌新买家订单数,首次购买该品牌的买家产生的订单数
示例 54
ntbOrdersPercentstring必填
品牌新买家订单占比,计算公式:ntbOrders / attributedOrders * 100%
示例 25.8
ntbRevenuestring必填
品牌新买家销售额,首次购买该品牌的买家产生的销售额
示例 3456.78
ntbRevenuePercentstring必填
品牌新买家销售额占比,计算公式:ntbRevenue / attributedSales * 100%
示例 28
ntbUnitsstring必填
品牌新买家销量,首次购买该品牌的买家购买数量
示例 67
ntbUnitsPercentstring必填
品牌新买家销量占比,计算公式:ntbUnits / attributedUnits * 100%
示例 28.6
numAdsClicksstring必填
广告点击量,广告被点击的总次数
示例 2345
numAdsShownstring必填
曝光次数,广告被展示的总次数
示例 109012
otherSkuSalesstring必填
关联销售额,间接归因销售额
示例 5555.44
otherSkuUnitsstring必填
关联销量,间接归因销量
示例 111
reportTagstring必填
报表标签,枚举值:REALTIME-实时数据标识
示例 REALTIME
roasstring必填
投入产出比(ROAS),计算公式:广告销售额 / 广告花费
示例 4.89
rolloverstring必填
是否结转,前一天未用的每日预算是否应结转到第二天的每日预算
示例 1
startDatestring必填
广告活动开始日期,格式:yyyy-MM-dd
示例 2024-01-01
targetingTypestring必填
投放类型,枚举值:manual-手动投放, auto-自动投放
示例 manual
totalBudgetstring必填
广告活动总预算
示例 5000
totalCompleteViewOrdersstring必填
完整观看订单总数,【仅SV视频广告】
示例 45
totalCompleteViewUnitsstring必填
完整观看销量总数,【仅SV视频广告】
示例 56
video5SecondViewsstring必填
视频5秒观看次数,【仅SV视频广告】
示例 3456
videoCompleteViewsstring必填
视频完整观看次数,【仅SV视频广告】
示例 1234
videoFirstQuartileViewsstring必填
视频第一四分位观看次数,【仅SV视频广告】
示例 2345
videoImpressionsstring必填
视频曝光量,【仅SV视频广告】
示例 45678
videoMidpointViewsstring必填
视频中点观看次数,【仅SV视频广告】
示例 1890
videoThirdQuartileViewsstring必填
视频第三四分位观看次数,【仅SV视频广告】
示例 1567
videoUnmutesstring必填
视频取消静音次数,【仅SV视频广告】
示例 789
viewThroughOrdersstring必填
浏览订单数,【仅SV视频广告】
示例 67
viewThroughSalesstring必填
浏览销售额,【仅SV视频广告】
示例 2345.67
viewThroughUnitsSoldstring必填
浏览销量,【仅SV视频广告】
示例 89
viewableImpressionsstring必填
可见曝光量,【仅SV视频广告】
示例 34567
totalstring必填
总记录数,返回符合条件的数据总数
示例 456
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

{
    "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
}