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