/basicOpen/adReport/manage/postSpCampaign{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/postSpCampaign"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpCampaign?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"profileId\": \"1234567890123456\",\n \"campaigns\": [\n {\n \"adProduct\": \"SPONSORED_PRODUCTS\",\n \"autoCreationSettings\": {\n \"autoCreateTargets\": false\n },\n \"budgets\": [\n {\n \"budgetType\": \"MONETARY\",\n \"budgetValue\": {\n \"monetaryBudgetValue\": {\n \"monetaryBudget\": {\n \"value\": 1\n }\n }\n },\n \"recurrenceTimePeriod\": \"DAILY\"\n }\n ],\n \"marketplaceScope\": \"SINGLE_MARKETPLACE\",\n \"name\": \"示例广告\",\n \"startDateTime\": \"2026-10-20T00:00:00Z\",\n \"state\": \"PAUSED\",\n \"marketplaces\": [\n \"US\"\n ]\n }\n ]\n}'",
"responseExample": {
"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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | profileId | 广告店铺 Profile ID | string | — | Required | 广告店铺 Profile ID;使用数字字符串传递,避免长 ID 精度丢失,必须属于当前授权租户。 |
| 2 | campaigns | 广告活动列表 | array<object> | — | Required | 广告活动列表 最少1项 最多1000项 |
| 2.1 | adProduct | 广告产品类型 | string | — | Required | 广告产品类型 可选值: SPONSORED_PRODUCTS |
| 2.2 | autoCreationSettings | 自动创建设置 | object | — | Required | 自动创建设置 |
| 2.2.1 | autoCreateTargets | autoCreateTargets | boolean | — | Required | 是否允许亚马逊根据推广商品自动创建广告活动的投放目标 |
| 2.2.2 | autoManageCampaign | 是否允许亚马逊管理广告活动的生命周期 | boolean | — | Optional | 是否允许亚马逊管理广告活动的生命周期 |
| 2.3 | budgets | 广告活动预算配置列表 | array<object> | — | Required | 广告活动预算配置列表 最少1项 |
| 2.3.1 | budgetType | 预算类型 | string | — | Required | 预算类型 可选值: MONETARY |
| 2.3.2 | budgetValue | 预算值配置 | object | — | Required | 预算值配置 |
| 2.3.2.1 | monetaryBudgetValue | 货币预算配置 | object | — | Required | 货币预算配置 |
| 2.3.2.1.1 | monetaryBudget | 货币预算金额 | object | — | Required | 货币预算金额 |
| 2.3.2.1.1.1 | value | 指定币种的预算金额 | number | — | Optional | 指定币种的预算金额 |
| 2.3.3 | recurrenceTimePeriod | 预算周期 | string | — | Required | 预算周期 可选值: DAILY |
| 2.4 | countries | 投放国家代码列表 | array<any> | — | Optional | 投放国家代码列表,决定广告活动可投放的亚马逊零售站点及库存范围 |
| 2.5 | endDateTime | 广告活动结束时间 | string | — | Optional | 广告活动结束时间,包含时区 |
| 2.6 | marketplaceScope | 站点范围 | string | — | Required | 站点范围 可选值: SINGLE_MARKETPLACE |
| 2.7 | marketplaces | 亚马逊零售站点代码列表 | array<any> | — | Required | 亚马逊零售站点代码列表,须与广告店铺匹配 最少1项 |
| 2.8 | name | 广告活动名称 | string | — | Required | 广告活动名称 |
| 2.9 | optimizations | 优化配置 | object | — | Optional | 优化配置 |
| 2.9.1 | bidSettings | 竞价设置 | object | — | Optional | 竞价设置 |
| 2.9.1.1 | bidAdjustments | 竞价调整设置 | object | — | Optional | 竞价调整设置 |
| 2.9.1.1.1 | audienceBidAdjustments | 按受众调整竞价 | array<object> | — | Optional | 按受众调整竞价 |
| 2.9.1.1.1.1 | audienceId | 用于调整竞价的受众唯一标识 | string | — | Required | 用于调整竞价的受众唯一标识 |
| 2.9.1.1.1.2 | percentage | 竞价调整百分比 | integer | — | Required | 竞价调整百分比 |
| 2.9.1.1.2 | creativeBidAdjustments | 按创意类型调整竞价 | array<object> | — | Optional | 按创意类型调整竞价,调整比例范围为0~900 |
| 2.9.1.1.2.1 | creativeType | 创意类型 | string | — | Optional | 创意类型。可不传或传空字符串,非空值须为列出的可选值 可选值: SPOTLIGHT |
| 2.9.1.1.2.2 | percentage | 竞价调整百分比 | integer | — | Required | 竞价调整百分比 |
| 2.9.1.1.3 | placementBidAdjustments | 按广告位调整竞价 | array<object> | — | Optional | 按广告位调整竞价;使用 SALES_UP_AND_DOWN 策略的品牌推广活动不支持 |
| 2.9.1.1.3.1 | percentage | 竞价调整百分比 | integer | — | Required | 竞价调整百分比 |
| 2.9.1.1.3.2 | placement | 广告位 | string | — | Required | 广告位 可选值: PRODUCT_PAGE REST_OF_SEARCH SITE_AMAZON_BUSINESS TOP_OF_SEARCH |
| 2.9.1.2 | bidStrategy | 竞价策略 | string | — | Optional | 竞价策略。可不传或传空字符串,非空值须为列出的可选值 可选值: MANUAL RULE_BASED SALES_DOWN_ONLY SALES_UP_AND_DOWN |
| 2.9.2 | budgetSettings | 预算设置 | object | — | Optional | 预算设置 |
| 2.9.2.1 | offAmazonBudgetControlStrategy | 站外预算控制策略 | string | — | Optional | 站外预算控制策略。可不传或传空字符串,非空值须为列出的可选值 可选值: MAXIMIZE_REACH MINIMIZE_SPEND |
| 2.10 | portfolioId | 活动所属广告组合的唯一标识 | string | — | Optional | 活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。 |
| 2.11 | siteRestrictions | 限制广告投放的网站 | array<any> | — | Optional | 限制广告投放的网站 |
| 2.12 | startDateTime | 广告活动开始时间 | string | — | Required | 广告活动开始时间,包含时区 |
| 2.13 | state | 状态 | string | — | Required | 状态 可选值: ENABLED PAUSED |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 平台业务状态码 | integer | 0 | Required | 平台业务状态码,0 表示成功 |
| 2 | message | 响应消息 | string | success | Required | 响应消息 |
| 3 | error_details | 参数校验等错误详情 | array<any> | [] | Required | 参数校验等错误详情 |
| 4 | request_id | 请求链路标识 | string | example-request-id | Required | 请求链路标识 |
| 5 | response_time | 响应时间 | string | 2026-10-19 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据。 |
| 6.1 | apiResult | 每个元素对应请求中一个广告活动的创建结果 | array<object> | — | Required | 每个元素对应请求中一个广告活动的创建结果,通过原始下标与请求中的活动对应。 |
| 6.1.1 | code | 当前活动的创建结果 | string | SUCCESS | Required | 当前活动的创建结果 SUCCESS 表示创建成功。 |
| 6.1.2 | index | 对应请求 campaigns 数组中的原始下标 | integer | — | Required | 对应请求 campaigns 数组中的原始下标,从 0 开始;0 表示第一个活动。 |
| 6.1.3 | adProduct | adProduct | string | SPONSORED_PRODUCTS | Required | SPONSORED_PRODUCTS 表示商品推广广告。 |
| 6.1.4 | autoCreationSettings | 广告活动的自动创建配置 | object | — | Required | 广告活动的自动创建配置。 |
| 6.1.4.1 | autoCreateTargets | 是否允许亚马逊根据推广商品自动创建投放目标 | boolean | — | Required | 是否允许亚马逊根据推广商品自动创建投放目标 true 表示允许,false 表示不允许。 |
| 6.1.5 | autoScaleGlobalCampaign | AUTO 表示自动将全球广告活动扩展到新的站点 | string | AUTO | Required | AUTO 表示自动将全球广告活动扩展到新的站点 MANUAL 表示手动扩展。该字段本身不表示当前活动已经在多个站点投放。 |
| 6.1.6 | budgets | 广告活动的预算配置列表 | array<object> | — | Required | 广告活动的预算配置列表;商品推广活动包含一项预算。 |
| 6.1.6.1 | budgetType | MONETARY 表示以货币金额设置预算 | string | MONETARY | Required | MONETARY 表示以货币金额设置预算。 |
| 6.1.6.2 | budgetValue | 预算具体取值的包装对象 | object | — | Required | 预算具体取值的包装对象。 |
| 6.1.6.2.1 | monetaryBudgetValue | 货币金额类型的预算值 | object | — | Required | 货币金额类型的预算值。 |
| 6.1.6.2.1.1 | monetaryBudget | 预算金额及其对应的币种 | object | — | Required | 预算金额及其对应的币种。 |
| 6.1.6.2.1.1.1 | currencyCode | 预算金额使用的货币代码 | string | — | Required | 预算金额使用的货币代码 USD 表示美元。 |
| 6.1.6.2.1.1.2 | value | 以对应币种计价的预算金额 | number | — | Required | 以对应币种计价的预算金额;结合 DAILY 周期,本例表示每日预算为 376 美元。 |
| 6.1.6.3 | recurrenceTimePeriod | DAILY 表示每日预算 | string | DAILY | Required | DAILY 表示每日预算。 |
| 6.1.7 | campaignId | 亚马逊生成的广告活动唯一标识 | string | — | Required | 亚马逊生成的广告活动唯一标识;使用字符串保存,避免长整数精度丢失。 |
| 6.1.8 | countries | string 数组 | array<any> | — | Required | string 数组,活动投放的国家代码列表 US 表示美国。 |
| 6.1.9 | creationDateTime | 亚马逊记录的活动创建时间 | string | — | Required | 亚马逊记录的活动创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.10 | lastUpdatedDateTime | 亚马逊记录的活动最后更新时间 | string | — | Required | 亚马逊记录的活动最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.11 | marketplaceScope | marketplaceScope | string | SINGLE_MARKETPLACE | Required | SINGLE_MARKETPLACE 表示单站点广告活动。 |
| 6.1.12 | marketplaces | string 数组 | array<any> | — | Required | string 数组,活动所属亚马逊零售站点的国家代码列表 US 表示美国站。 |
| 6.1.13 | name | 创建成功的广告活动名称 | string | — | Required | 创建成功的广告活动名称。 |
| 6.1.14 | optimizations | 活动的竞价和预算优化配置 | object | — | Required | 活动的竞价和预算优化配置。 |
| 6.1.14.1 | bidSettings | 竞价策略及各维度竞价调整配置 | object | — | Required | 竞价策略及各维度竞价调整配置。 |
| 6.1.14.1.1 | bidAdjustments | 按受众或广告位设置的竞价调整配置 | object | — | Required | 按受众或广告位设置的竞价调整配置。 |
| 6.1.14.1.1.1 | audienceBidAdjustments | 针对指定受众的竞价调整配置 | array<object> | — | Required | 针对指定受众的竞价调整配置。 |
| 6.1.14.1.1.1.1 | audienceId | 应用该竞价调整的受众唯一标识 | string | — | Required | 应用该竞价调整的受众唯一标识;本例为本次创建成功响应返回的受众。 |
| 6.1.14.1.1.1.2 | percentage | 以整数百分数表示针对该受众的竞价调整 | integer | — | Required | 以整数百分数表示针对该受众的竞价调整;9 表示增加 9%,不是小数 0.09。 |
| 6.1.14.1.1.2 | placementBidAdjustments | 不同广告位对应的竞价调整配置 | array<object> | — | Required | 不同广告位对应的竞价调整配置。 |
| 6.1.14.1.1.2.1 | percentage | 以整数百分数表示该广告位的竞价调整 | integer | — | Required | 以整数百分数表示该广告位的竞价调整;24 表示增加 24%。 |
| 6.1.14.1.1.2.2 | placement | TOP_OF_SEARCH 表示搜索结果顶部 | string | TOP_OF_SEARCH | Required | TOP_OF_SEARCH 表示搜索结果顶部 REST_OF_SEARCH 表示搜索结果其余位置 PRODUCT_PAGE 表示商品详情页及相关非搜索广告位 SITE_AMAZON_BUSINESS 表示亚马逊企业购站点广告位。 |
| 6.1.14.1.2 | bidStrategy | MANUAL 表示固定竞价 | string | MANUAL | Required | MANUAL 表示固定竞价 RULE_BASED 表示基于规则的竞价 SALES_DOWN_ONLY 表示动态竞价只降低 SALES_UP_AND_DOWN 表示动态竞价提高和降低。 |
| 6.1.14.2 | budgetSettings | 预算分配方式及亚马逊站外预算控制策略 | object | — | Required | 预算分配方式及亚马逊站外预算控制策略。 |
| 6.1.14.2.1 | marketplaceBudgetAllocation | AUTO 表示自动将全球广告活动预算分配到各站点 | string | AUTO | Required | AUTO 表示自动将全球广告活动预算分配到各站点 MANUAL 表示手动分配。 |
| 6.1.14.2.2 | offAmazonBudgetControlStrategy | offAmazonBudgetControlStrategy | string | MAXIMIZE_REACH | Required | MAXIMIZE_REACH 表示在预算范围内扩大亚马逊站外触达 MINIMIZE_SPEND 表示在维持投放的同时尽量减少亚马逊站外花费。 |
| 6.1.15 | startDateTime | 活动计划开始投放的时间 | string | — | Required | 活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.16 | state | ENABLED 表示已启用 | string | ENABLED | Required | ENABLED 表示已启用 PAUSED 表示已暂停 ARCHIVED 表示已归档且不可重新启用。已启用不等于当前正在投放,还取决于开始时间和其他投放条件。 |
| 7 | total | 统一响应中的总数 | integer | 0 | Required | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
The 创建 SP 广告活动 API (/basicOpen/adReport/manage/postSpCampaign) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.