SP广告活动

POST/pb/openapi/newad/spCampaigns

注：小时数据来源于Amazon Marketing Stream，只提供授权后的；因亚马逊会修正数据，小时和天数据可能会存在差异。

接口信息

API Path	请求协议	请求方式	令牌桶容量
`/pb/openapi/newad/spCampaigns`	HTTPS	POST	10

请求头

标签	必填	说明	类型	示例
X-API-VERSION	是	1.【兼容旧版本】不加此头部标签，offset 为分页页码，从1开始；值为 2 时，表示 offset 为分页偏移量，从0开始 2.推荐使用X-API-VERSION:2	[int]	2

请求参数

sidinteger必填

店铺id ，对应查询亚马逊店铺列表接口对应字段【sid】

profile_idinteger必填

VC广告店铺profile_id，对应查询广告账号列表接口对应字段【profile_id】，sid跟profile_id其中一个必填

statestring

状态：【不传默认为所有】
enabled
paused
archived

offsetinteger

分页偏移量，默认0

lengthinteger

分页长度，默认15

next_tokenstring

分页游标，上次分页结果中的next_token
(第一次分页无需填写，当next_token 和 offset同时存在时以next_token为主

返回结果

Json Object

codeinteger必填

状态码，0 成功

示例 0

messagestring必填

提示消息

示例操作成功

error_detailsarray<any>必填

错误信息

request_idstring必填

请求链路id

示例 nd8492d4-7a15-11ed-b162-0242ac1c0004

response_timestring必填

响应时间

示例 2022-11-03 14:09:15

totalinteger必填

总数

示例 1

next_tokenstring必填

分页游标，填入下次请求中的next_token

示例 "ODAwMDAwMDAwMDAwMDAyNDE3"

dataarray<object>必填

响应数据

隐藏子属性

campaign_idnumber必填

广告活动id

示例 1711935301143

lastOverBudgetAtstring必填

超预算时间

示例 2026-10-08 12:34:56

profile_idnumber必填

亚马逊店铺数字id

示例 121923590660074

namestring必填

广告活动名称

示例 PVC Pouch-Label (A4/20P)_auto_20210810

campaign_typestring必填

广告活动类型

示例 sponsoredProducts

targeting_typestring必填

投放类型

示例 auto

premium_bid_adjustmentnumber必填

溢价报价调整

示例 1

daily_budgetnumber必填

每日预算

示例 10

start_datestring必填

起始日期

示例 2021-08-09 00:00:00

end_datestring必填

结束日期

示例 2021-08-09 00:00:00

creation_datenumber必填

创建日期

示例 1628567183000

last_updated_datenumber必填

最后更新时间

示例 1632985461000

statestring必填

状态

示例 enabled

serving_statusstring必填

服务状态

示例 CAMPAIGN_STATUS_ENABLED

biddingstring必填

竞价策略【json格式】

示例 {"strategy": "legacyForSales", "adjustments":[{"predicate":"placementProductPage","percentage":44}]}

portfolio_idnumber必填

广告组合id

示例 935301143

tagsarray<object>必填

标签信息

隐藏子属性

parentstring必填

父标签

示例 t1

childstring必填

子标签

示例 tttsadw

附加说明

bidding 竞价策略 json 内容字段说明如下：

strategy：竞价策略

legacyForSales：动态竞价 – 降低 (Dynamic Bidding - Down Only)； autoForSales：动态竞价 – 提高和降低 (Dynamic Bidding - Up and Down)； manual：固定竞价 (Fixed Bidding)；

adjustments：竞价调整

adjustments>>predicate 根据展示位置调整竞价，枚举值：placementTop、placementProductPage； adjustments>>percentage 调整竞价的百分比；