Lingxing
切换旧版

创建 SB 广告活动

POST/basicOpen/adReport/manage/postSbCampaign

接口信息

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

请求参数

profileIdstring必填
广告店铺唯一标识,必须属于当前授权企业;使用数字字符串避免长整数精度丢失。本文件记录用户提供的广告店铺标识调用方式。
campaignsarray<object>必填
待创建的品牌推广广告活动;每次提交 1~10 个。
最少1项
最多10项
隐藏子属性
adProductstring必填
SPONSORED_BRANDS 表示品牌推广广告。
autoCreationSettingsobject
是否允许亚马逊根据推广商品自动创建投放目标。
隐藏子属性
autoCreateTargetsboolean
true=允许亚马逊根据推广商品自动创建投放目标
false=不允许。
brandIdstring
广告活动关联的品牌唯一标识。
budgetsarray<object>必填
品牌推广活动的预算列表,须且仅包含一项预算。
最少1项
隐藏子属性
budgetTypestring必填
MONETARY 表示货币金额预算。
budgetValueobject必填
预算值类型包装;品牌推广使用货币预算。
隐藏子属性
monetaryBudgetValueobject必填
货币预算的包装对象。
隐藏子属性
monetaryBudgetobject必填
以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。
隐藏子属性
valuenumber必填
以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。
recurrenceTimePeriodstring必填
DAILY=每日预算
LIFETIME=广告活动全生命周期预算。
costTypestring必填
CPC=按点击计费
CPM=按千次展示计费
FIXED_PRICE=特定广告位固定价格
VCPM=按千次可见展示计费。
countriesarray<any>
影响广告投放范围的国家代码列表;品牌推广最多一个国家。
endDateTimestring
广告活动结束日期,格式为 yyyy-MM-dd,例如 2026-10-10;不得早于开始日期。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告活动。
marketplacesarray<any>必填
广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配
US 表示美国站。
最少1项
namestring必填
用于识别和管理广告活动的名称。
optimizationsobject
活动竞价配置与营销目标优化设置。
隐藏子属性
bidSettingsobject
活动竞价策略和竞价调整配置。
隐藏子属性
bidAdjustmentsobject
按广告位或受众配置的竞价调整。
隐藏子属性
audienceBidAdjustmentsarray<object>
官方定义的受众竞价调整列表,最多一项。
隐藏子属性
audienceIdstring
应用竞价调整的受众唯一标识,可不传或传空字符串;有值时应为当前广告店铺可用的受众。
percentageinteger必填
以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
placementBidAdjustmentsarray<object>
按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。
隐藏子属性
percentageinteger必填
以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
placementstring必填
HOME_PAGE=首页
PRODUCT_PAGE=商品详情页及相关非搜索广告位
REST_OF_SEARCH=搜索结果其余位置
TOP_OF_SEARCH=搜索结果顶部。
shopperSegmentBidAdjustmentsarray<object>
官方标记为待废弃的品牌推广历史字段,最多两项;本次请求包含此字段,但成功响应未回显,是否实际应用需另行核验。
隐藏子属性
percentageinteger
针对指定购物者人群的竞价调整比例;10 表示提高 10%。此子字段依据用户请求样本补充。
audienceSegmentsarray<object>
应用调价的受众细分配置;结构依据用户请求样本补充。
隐藏子属性
audienceIdstring
应用该调整的受众唯一标识,必须对当前广告店铺可用。
audienceSegmentTypestring
样本值 SPONSORED_ADS_AMC 表示亚马逊营销云的广告受众;官方创建规范未给出该旧字段的完整枚举,故不限制为此单一值。
shopperCohortTypestring
样本值 AUDIENCE_SEGMENT 表示按受众细分设置;官方创建规范未给出该旧字段的完整枚举。
bidStrategystring
MANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价
SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。
goalSettingsobject
活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。
隐藏子属性
kpistring必填
CLICKS=增加点击
TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。
portfolioIdstring
活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
salesChannelstring
AMAZON=在亚马逊自有站点销售
OFF_AMAZON=在亚马逊以外的站点销售。
siteRestrictionsarray<any>
限定广告展示站点;最多一项。
startDateTimestring必填
活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。
statestring必填
ENABLED=已启用
PAUSED=已暂停。已启用仍需满足开始时间及其他投放条件。
targetedPGDealIdstring
与广告活动关联的交易唯一标识。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "campaigns": [
        {
            "adProduct": "SPONSORED_BRANDS",
            "budgets": [
                {
                    "budgetType": "MONETARY",
                    "budgetValue": {
                        "monetaryBudgetValue": {
                            "monetaryBudget": {
                                "value": 1
                            }
                        }
                    },
                    "recurrenceTimePeriod": "DAILY"
                }
            ],
            "costType": "CPC",
            "marketplaceScope": "SINGLE_MARKETPLACE",
            "name": "示例广告",
            "startDateTime": "2026-10-10",
            "state": "PAUSED",
            "marketplaces": [
                "US"
            ]
        }
    ]
}'

返回结果

Json Object

codeinteger必填
平台业务状态码,0 表示成功
示例 0
messagestring必填
响应消息
示例 success
error_detailsarray<any>必填
参数校验等错误详情
示例 []
request_idstring必填
请求链路标识
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-19 12:00:00
dataobject必填
响应数据。
隐藏子属性
apiResultarray<object>必填
每项结果通过原始下标对应请求中的活动;应检查每项结果码,批量或工具调用可能包含失败项。
隐藏子属性
adProductstring必填
SPONSORED_BRANDS 表示品牌推广广告。
autoCreationSettingsobject必填
是否允许亚马逊根据推广商品自动创建投放目标。
隐藏子属性
autoCreateTargetsboolean必填
true=允许亚马逊根据推广商品自动创建投放目标
false=不允许。
budgetsarray<object>必填
品牌推广活动的预算列表,须且仅包含一项预算。
隐藏子属性
budgetTypestring必填
MONETARY 表示货币金额预算。
budgetValueobject必填
预算值类型包装;品牌推广使用货币预算。
隐藏子属性
monetaryBudgetValueobject必填
货币预算的包装对象。
隐藏子属性
monetaryBudgetobject必填
以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。
隐藏子属性
currencyCodestring必填
AED=阿联酋迪拉姆
AUD=澳大利亚元
BRL=巴西雷亚尔
CAD=加拿大元
CHF=瑞士法郎
CNY=人民币
DKK=丹麦克朗
EGP=埃及镑
EUR=欧元
GBP=英镑
INR=印度卢比
JPY=日元
MXN、MXP=墨西哥比索
NGN=尼日利亚奈拉
NOK=挪威克朗
NZD=新西兰元
PLN=波兰兹罗提
SAR=沙特里亚尔
SEK=瑞典克朗
SGD=新加坡元
TRY=土耳其里拉
USD=美元
ZAR=南非兰特。
valuenumber必填
以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。
recurrenceTimePeriodstring必填
DAILY=每日预算
LIFETIME=广告活动全生命周期预算。
campaignIdstring必填
亚马逊创建成功后生成的活动唯一标识,使用字符串保存,避免长整数精度丢失。
costTypestring必填
CPC=按点击计费
CPM=按千次展示计费
FIXED_PRICE=特定广告位固定价格
VCPM=按千次可见展示计费。
countriesarray<any>必填
影响广告投放范围的国家代码列表;品牌推广最多一个国家。
creationDateTimestring必填
亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。
isMultiAdGroupsEnabledboolean必填
只读返回字段
true 表示活动支持多个广告组,false 表示不支持。
lastUpdatedDateTimestring必填
亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告活动。
marketplacesarray<any>必填
广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配
US 表示美国站。
namestring必填
用于识别和管理广告活动的名称。
optimizationsobject必填
活动竞价配置与营销目标优化设置。
隐藏子属性
bidSettingsobject必填
活动竞价策略和竞价调整配置。
隐藏子属性
bidAdjustmentsobject必填
按广告位或受众配置的竞价调整。
隐藏子属性
placementBidAdjustmentsarray<object>必填
按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。
隐藏子属性
percentageinteger必填
以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
placementstring必填
HOME_PAGE=首页
PRODUCT_PAGE=商品详情页及相关非搜索广告位
REST_OF_SEARCH=搜索结果其余位置
TOP_OF_SEARCH=搜索结果顶部。
bidStrategystring必填
MANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价
SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。
goalSettingsobject必填
活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。
隐藏子属性
goalstring必填
AWARENESS=提升品牌认知
CONSIDERATION=提升购买考虑度
CONVERSIONS=促进转化。
kpistring必填
CLICKS=增加点击
TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。
startDateTimestring必填
活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。
示例 2026-10-10
statestring必填
ENABLED=已启用
PAUSED=已暂停
ARCHIVED=已永久归档且不可重新启用。
codestring必填
SUCCESS 表示当前广告活动创建成功。
示例 SUCCESS
indexinteger必填
对应请求活动数组中的原始下标,从 0 开始。
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "example-request-id",
    "response_time": "2026-10-19 12:00:00",
    "data": {
        "apiResult": [
            {
                "adProduct": "SPONSORED_BRANDS",
                "autoCreationSettings": {
                    "autoCreateTargets": false
                },
                "budgets": [
                    {
                        "budgetType": "MONETARY",
                        "budgetValue": {
                            "monetaryBudgetValue": {
                                "monetaryBudget": {
                                    "currencyCode": "USD",
                                    "value": 1
                                }
                            }
                        },
                        "recurrenceTimePeriod": "DAILY"
                    }
                ],
                "campaignId": "1234567890123456",
                "costType": "CPC",
                "countries": [
                    "US"
                ],
                "creationDateTime": "2026-10-20T00:00:00Z",
                "isMultiAdGroupsEnabled": false,
                "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
                "marketplaceScope": "SINGLE_MARKETPLACE",
                "marketplaces": [
                    "US"
                ],
                "name": "示例广告",
                "optimizations": {
                    "bidSettings": {
                        "bidAdjustments": {
                            "placementBidAdjustments": [
                                {
                                    "percentage": 1,
                                    "placement": "example"
                                }
                            ]
                        },
                        "bidStrategy": "MANUAL"
                    },
                    "goalSettings": {
                        "goal": "CONSIDERATION",
                        "kpi": "CLICKS"
                    }
                },
                "startDateTime": "2026-10-10",
                "state": "PAUSED",
                "code": "SUCCESS",
                "index": 0
            }
        ]
    },
    "total": 0
}

附加说明

  • profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
  • 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
  • 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
  • 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
  • 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
  • 预算及竞价调整比例须非负,结束时间不得早于开始时间;开始日期和站点须满足亚马逊要求。
  • shopperSegmentBidAdjustments 为待废弃的历史字段,创建成功不代表该调整已经生效。