Lingxing
切换旧版

创建 SP 广告活动

POST/basicOpen/adReport/manage/postSpCampaign

接口信息

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

请求参数

profileIdstring必填
广告店铺 Profile ID;使用数字字符串传递,避免长 ID 精度丢失,必须属于当前授权租户。
campaignsarray<object>必填
广告活动列表
最少1项
最多1000项
隐藏子属性
adProductstring必填
广告产品类型
可选值:
SPONSORED_PRODUCTS
autoCreationSettingsobject必填
自动创建设置
隐藏子属性
autoCreateTargetsboolean必填
是否允许亚马逊根据推广商品自动创建广告活动的投放目标
autoManageCampaignboolean
是否允许亚马逊管理广告活动的生命周期
budgetsarray<object>必填
广告活动预算配置列表
最少1项
隐藏子属性
budgetTypestring必填
预算类型
可选值:
MONETARY
budgetValueobject必填
预算值配置
隐藏子属性
monetaryBudgetValueobject必填
货币预算配置
隐藏子属性
monetaryBudgetobject必填
货币预算金额
隐藏子属性
valuenumber
指定币种的预算金额
recurrenceTimePeriodstring必填
预算周期
可选值:
DAILY
countriesarray<any>
投放国家代码列表,决定广告活动可投放的亚马逊零售站点及库存范围
endDateTimestring
广告活动结束时间,包含时区
marketplaceScopestring必填
站点范围
可选值:
SINGLE_MARKETPLACE
marketplacesarray<any>必填
亚马逊零售站点代码列表,须与广告店铺匹配
最少1项
namestring必填
广告活动名称
optimizationsobject
优化配置
隐藏子属性
bidSettingsobject
竞价设置
隐藏子属性
bidAdjustmentsobject
竞价调整设置
隐藏子属性
audienceBidAdjustmentsarray<object>
按受众调整竞价
隐藏子属性
audienceIdstring必填
用于调整竞价的受众唯一标识
percentageinteger必填
竞价调整百分比
creativeBidAdjustmentsarray<object>
按创意类型调整竞价,调整比例范围为0~900
隐藏子属性
creativeTypestring
创意类型。可不传或传空字符串,非空值须为列出的可选值
可选值:
SPOTLIGHT
percentageinteger必填
竞价调整百分比
placementBidAdjustmentsarray<object>
按广告位调整竞价;使用 SALES_UP_AND_DOWN 策略的品牌推广活动不支持
隐藏子属性
percentageinteger必填
竞价调整百分比
placementstring必填
广告位
可选值:
PRODUCT_PAGE
REST_OF_SEARCH
SITE_AMAZON_BUSINESS
TOP_OF_SEARCH
bidStrategystring
竞价策略。可不传或传空字符串,非空值须为列出的可选值
可选值:
MANUAL
RULE_BASED
SALES_DOWN_ONLY
SALES_UP_AND_DOWN
budgetSettingsobject
预算设置
隐藏子属性
offAmazonBudgetControlStrategystring
站外预算控制策略。可不传或传空字符串,非空值须为列出的可选值
可选值:
MAXIMIZE_REACH
MINIMIZE_SPEND
portfolioIdstring
活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
siteRestrictionsarray<any>
限制广告投放的网站
startDateTimestring必填
广告活动开始时间,包含时区
statestring必填
状态
可选值:
ENABLED
PAUSED

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "campaigns": [
        {
            "adProduct": "SPONSORED_PRODUCTS",
            "autoCreationSettings": {
                "autoCreateTargets": false
            },
            "budgets": [
                {
                    "budgetType": "MONETARY",
                    "budgetValue": {
                        "monetaryBudgetValue": {
                            "monetaryBudget": {
                                "value": 1
                            }
                        }
                    },
                    "recurrenceTimePeriod": "DAILY"
                }
            ],
            "marketplaceScope": "SINGLE_MARKETPLACE",
            "name": "示例广告",
            "startDateTime": "2026-10-20T00:00:00Z",
            "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>必填
每个元素对应请求中一个广告活动的创建结果,通过原始下标与请求中的活动对应。
隐藏子属性
codestring必填
当前活动的创建结果
SUCCESS 表示创建成功。
示例 SUCCESS
indexinteger必填
对应请求 campaigns 数组中的原始下标,从 0 开始;0 表示第一个活动。
adProductstring必填
SPONSORED_PRODUCTS 表示商品推广广告。
示例 SPONSORED_PRODUCTS
autoCreationSettingsobject必填
广告活动的自动创建配置。
隐藏子属性
autoCreateTargetsboolean必填
是否允许亚马逊根据推广商品自动创建投放目标
true 表示允许,false 表示不允许。
autoScaleGlobalCampaignstring必填
AUTO 表示自动将全球广告活动扩展到新的站点
MANUAL 表示手动扩展。该字段本身不表示当前活动已经在多个站点投放。
示例 AUTO
budgetsarray<object>必填
广告活动的预算配置列表;商品推广活动包含一项预算。
隐藏子属性
budgetTypestring必填
MONETARY 表示以货币金额设置预算。
示例 MONETARY
budgetValueobject必填
预算具体取值的包装对象。
隐藏子属性
monetaryBudgetValueobject必填
货币金额类型的预算值。
隐藏子属性
monetaryBudgetobject必填
预算金额及其对应的币种。
隐藏子属性
currencyCodestring必填
预算金额使用的货币代码
USD 表示美元。
valuenumber必填
以对应币种计价的预算金额;结合 DAILY 周期,本例表示每日预算为 376 美元。
recurrenceTimePeriodstring必填
DAILY 表示每日预算。
示例 DAILY
campaignIdstring必填
亚马逊生成的广告活动唯一标识;使用字符串保存,避免长整数精度丢失。
countriesarray<any>必填
string 数组,活动投放的国家代码列表
US 表示美国。
creationDateTimestring必填
亚马逊记录的活动创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
lastUpdatedDateTimestring必填
亚马逊记录的活动最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告活动。
示例 SINGLE_MARKETPLACE
marketplacesarray<any>必填
string 数组,活动所属亚马逊零售站点的国家代码列表
US 表示美国站。
namestring必填
创建成功的广告活动名称。
optimizationsobject必填
活动的竞价和预算优化配置。
隐藏子属性
bidSettingsobject必填
竞价策略及各维度竞价调整配置。
隐藏子属性
bidAdjustmentsobject必填
按受众或广告位设置的竞价调整配置。
隐藏子属性
audienceBidAdjustmentsarray<object>必填
针对指定受众的竞价调整配置。
隐藏子属性
audienceIdstring必填
应用该竞价调整的受众唯一标识;本例为本次创建成功响应返回的受众。
percentageinteger必填
以整数百分数表示针对该受众的竞价调整;9 表示增加 9%,不是小数 0.09。
placementBidAdjustmentsarray<object>必填
不同广告位对应的竞价调整配置。
隐藏子属性
percentageinteger必填
以整数百分数表示该广告位的竞价调整;24 表示增加 24%。
placementstring必填
TOP_OF_SEARCH 表示搜索结果顶部
REST_OF_SEARCH 表示搜索结果其余位置
PRODUCT_PAGE 表示商品详情页及相关非搜索广告位
SITE_AMAZON_BUSINESS 表示亚马逊企业购站点广告位。
示例 TOP_OF_SEARCH
bidStrategystring必填
MANUAL 表示固定竞价
RULE_BASED 表示基于规则的竞价
SALES_DOWN_ONLY 表示动态竞价只降低
SALES_UP_AND_DOWN 表示动态竞价提高和降低。
示例 MANUAL
budgetSettingsobject必填
预算分配方式及亚马逊站外预算控制策略。
隐藏子属性
marketplaceBudgetAllocationstring必填
AUTO 表示自动将全球广告活动预算分配到各站点
MANUAL 表示手动分配。
示例 AUTO
offAmazonBudgetControlStrategystring必填
MAXIMIZE_REACH 表示在预算范围内扩大亚马逊站外触达
MINIMIZE_SPEND 表示在维持投放的同时尽量减少亚马逊站外花费。
示例 MAXIMIZE_REACH
startDateTimestring必填
活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
statestring必填
ENABLED 表示已启用
PAUSED 表示已暂停
ARCHIVED 表示已归档且不可重新启用。已启用不等于当前正在投放,还取决于开始时间和其他投放条件。
示例 ENABLED
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "example-request-id",
    "response_time": "2026-10-19 12:00:00",
    "data": {
        "apiResult": [
            {
                "code": "SUCCESS",
                "index": 0,
                "adProduct": "SPONSORED_PRODUCTS",
                "autoCreationSettings": {
                    "autoCreateTargets": false
                },
                "autoScaleGlobalCampaign": "AUTO",
                "budgets": [
                    {
                        "budgetType": "MONETARY",
                        "budgetValue": {
                            "monetaryBudgetValue": {
                                "monetaryBudget": {
                                    "currencyCode": "USD",
                                    "value": 1
                                }
                            }
                        },
                        "recurrenceTimePeriod": "DAILY"
                    }
                ],
                "campaignId": "1234567890123456",
                "countries": [
                    "US"
                ],
                "creationDateTime": "2026-10-20T00:00:00Z",
                "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
                "marketplaceScope": "SINGLE_MARKETPLACE",
                "marketplaces": [
                    "US"
                ],
                "name": "示例广告",
                "optimizations": {
                    "bidSettings": {
                        "bidAdjustments": {
                            "audienceBidAdjustments": [
                                {
                                    "audienceId": "example",
                                    "percentage": 1
                                }
                            ],
                            "placementBidAdjustments": [
                                {
                                    "percentage": 1,
                                    "placement": "TOP_OF_SEARCH"
                                }
                            ]
                        },
                        "bidStrategy": "MANUAL"
                    },
                    "budgetSettings": {
                        "marketplaceBudgetAllocation": "AUTO",
                        "offAmazonBudgetControlStrategy": "MAXIMIZE_REACH"
                    }
                },
                "startDateTime": "2026-10-20T00:00:00Z",
                "state": "PAUSED"
            }
        ]
    },
    "total": 0
}

附加说明

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