Lingxing
切换旧版

修改SP广告活动和广告位

POST/basicOpen/adReport/manage/putSpCampaign

支持调整SP广告活动的竞价策略、预算、广告位等配置

接口信息

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

请求参数

sidnumber必填
sid 和 profileId 必传一个
profileIdinteger
sid 和 profileId 必传一个
campaignsarray<object>必填
广告活动列表
隐藏子属性
campaignIdnumber必填
广告活动id
statestring
有效状态：enabled-启用
paused-暂停
budgetobject
预算对象
隐藏子属性
budgetTypestring
预算类型 固定传daily
budgetnumber
预算金额
isBaseValuenumber必填
是否调整基准值：1-是
0-否
baseTypestring
调整基准值类型：1-固定值
2-系统反推
baseValuestring
固定值时传 基准值
isBasePlacementAllnumber
是否同步更新分时策略广告位基准值：1-是
0或不传-不调整
dynamicBiddingobject
广告位竞价配置
隐藏子属性
strategystring
竞价策略：AUTO_FOR_SALES-动态竞价-提高和降低
LEGACY_FOR_SALES-动态竞价-只降低
MANUAL-固定竞价
placementBiddingarray<object>
广告位相关参数
隐藏子属性
placementstring
广告位：PLACEMENT_PRODUCT_PAGE-商品页面
PLACEMENT_TOP-搜索结果顶部(首页)
PLACEMENT_REST_OF_SEARCH-搜索结果的其余位置
SITE_AMAZON_BUSINESS-亚马逊企业购
percentagenumber
广告位百分比

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/putSpCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": 9090,
    "campaigns": [
        {
            "campaignId": 414070570476640,
            "isBaseValue": 0,
            "isBasePlacementAll": 1,
            "dynamicBidding": {
                "strategy": "LEGACY_FOR_SALES",
                "placementBidding": [
                    {
                        "placement": "PLACEMENT_PRODUCT_PAGE",
                        "percentage": 38
                    },
                    {
                        "placement": "PLACEMENT_TOP",
                        "percentage": 25
                    },
                    {
                        "placement": "PLACEMENT_REST_OF_SEARCH",
                        "percentage": 15
                    },
                    {
                        "placement": "SITE_AMAZON_BUSINESS",
                        "percentage": 10
                    }
                ]
            }
        }
    ]
}'

返回结果

Json Object

codenumber必填
示例 1
successboolean必填
示例 true
dataobject必填
隐藏子属性
apiResultarray<object>必填
示例 详见返回成功示例
隐藏子属性
codestring必填
SUCCESS 成功 其他为失败
示例 SUCCESS
campaignIdstring
成功时返回 广告活动id
示例 468467189609276
descriptionstring
不成功时返回错误的原因
messagestring必填
示例 success
request_idstring必填
链路id
示例 f0763238_fed4_4f06_ae05_0f864e1c78b2
response_timestring必填
响应时间
error_detailsarray<any>必填
错误信息

返回成功示例

{
    "code": 1,
    "success": true,
    "data": {
        "apiResult": [{
                "code": "SUCCESS",
                "campaignId": "468467189609276"
            },
            {
                "code": "SUCCESS",
                "campaignId": "67532229161080"
            },
            {
                "code": "SUCCESS",
                "campaignId": "393233412099415"
            },
            {
                "code": "entityStateError",
                "description": "Archived entity cannot be modified"
            }
        ]
    },
    "message": "success",
    "request_id": "ed914dcf_fe5a_4ec3_8e92_c72f1dd95081",
    "response_time":"2025-05-21 00:00:00"
}

返回失败示例

{
    "success": false,
    "data": [],
    "message": "程序内部错误",
    "error_details":["参数错误：只支持seller账号，不支持vendor账号【reqId】:aa163c0f_e16d_43f5_835c_1214d83cbd94"],
    "code": 0,
    "request_id": "ed914dcf_fe5a_4ec3_8e92_c72f1dd95081",
    "response_time":"2025-05-21 00:00:00"
}