Lingxing
切换旧版

修改SB广告活动

POST/basicOpen/adReport/manage/putSbCampaign

支持批量修改SB广告活动的状态、预算、分时策略基准值及竞价配置。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/manage/putSbCampaignHTTPSPOST1

请求参数

sidinteger
店铺sid,与profileId至少传一个
profileIdinteger
Amazon Ads Profile ID,与sid至少传一个
campaignsarray<object>必填
本次要处理的广告活动,单次最多1000条
隐藏子属性
campaignIdinteger必填
广告活动ID
statestring
状态
enabled/ENABLED:启用
paused/PAUSED:暂停
budgetnumber
每日预算
isBaseValueinteger
是否同时调整分时策略基准值
1:是
0:否
baseTypeinteger
分时策略基准值类型
1:固定值
2:计算值
baseValuenumber
分时策略基准值,baseType为1时需要传入
biddingobject
竞价配置
隐藏子属性
bidOptimizationboolean
是否启用竞价优化;为true时不能传bidAdjustmentsByPlacement
bidAdjustmentsByPlacementarray<object>
广告位竞价调整列表;bidOptimization为true时不能传
隐藏子属性
placementstring
广告位
HOME:首页广告位
DETAIL_PAGE:商品详情页广告位
OTHER:其他广告位
TOP_OF_SEARCH:搜索结果顶部广告位
percentageinteger
广告位竞价调整比例,范围-99至900

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/putSbCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": 9090,
    "campaigns": [
        {
            "campaignId": 414070570476640,
            "state": "paused",
            "budget": 20,
            "isBaseValue": 1,
            "baseType": 1,
            "baseValue": 1.25,
            "bidding": {
                "bidOptimization": false,
                "bidAdjustmentsByPlacement": [
                    {
                        "placement": "TOP_OF_SEARCH",
                        "percentage": 25
                    }
                ],
                "shopperCohortBidAdjustments": [
                    {
                        "percentage": 25,
                        "audienceSegments": [
                            {
                                "audienceId": 1,
                                "audienceSegmentType": "SPONSORED_ADS_AMC"
                            }
                        ],
                        "shopperCohortType": "AUDIENCE_SEGMENT"
                    }
                ]
            }
        }
    ]
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-18 12:00:00
dataobject必填
响应数据
隐藏子属性
apiResultarray<object>必填
广告活动处理结果列表
隐藏子属性
codestring必填
处理结果代码,SUCCESS表示成功
示例 SUCCESS
campaignIdinteger必填
广告活动ID
示例 414070570476640
descriptionstring必填
处理说明,失败时返回失败原因
示例 操作成功

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-18 12:00:00",
    "data": {
        "apiResult": [
            {
                "code": "SUCCESS",
                "campaignId": 414070570476640,
                "description": "操作成功"
            }
        ]
    }
}