/basicOpen/adReport/manage/postSbCampaign{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/postSbCampaign"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbCampaign?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_BRANDS\",\n \"budgets\": [\n {\n \"budgetType\": \"MONETARY\",\n \"budgetValue\": {\n \"monetaryBudgetValue\": {\n \"monetaryBudget\": {\n \"value\": 1\n }\n }\n },\n \"recurrenceTimePeriod\": \"DAILY\"\n }\n ],\n \"costType\": \"CPC\",\n \"marketplaceScope\": \"SINGLE_MARKETPLACE\",\n \"name\": \"示例广告\",\n \"startDateTime\": \"2026-10-10\",\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": [
{
"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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | profileId | 广告店铺唯一标识 | string | — | 必填 | 广告店铺唯一标识,必须属于当前授权企业;使用数字字符串避免长整数精度丢失。本文件记录用户提供的广告店铺标识调用方式。 |
| 2 | campaigns | 待创建的品牌推广广告活动 | array<object> | — | 必填 | 待创建的品牌推广广告活动;每次提交 1~10 个。 最少1项 最多10项 |
| 2.1 | adProduct | adProduct | string | — | 必填 | SPONSORED_BRANDS 表示品牌推广广告。 |
| 2.2 | autoCreationSettings | 是否允许亚马逊根据推广商品自动创建投放目标 | object | — | 可选 | 是否允许亚马逊根据推广商品自动创建投放目标。 |
| 2.2.1 | autoCreateTargets | true=允许亚马逊根据推广商品自动创建投放目标 | boolean | — | 可选 | true=允许亚马逊根据推广商品自动创建投放目标 false=不允许。 |
| 2.3 | brandId | 广告活动关联的品牌唯一标识 | string | — | 可选 | 广告活动关联的品牌唯一标识。 |
| 2.4 | budgets | 品牌推广活动的预算列表 | array<object> | — | 必填 | 品牌推广活动的预算列表,须且仅包含一项预算。 最少1项 |
| 2.4.1 | budgetType | MONETARY 表示货币金额预算 | string | — | 必填 | MONETARY 表示货币金额预算。 |
| 2.4.2 | budgetValue | 预算值类型包装 | object | — | 必填 | 预算值类型包装;品牌推广使用货币预算。 |
| 2.4.2.1 | monetaryBudgetValue | 货币预算的包装对象 | object | — | 必填 | 货币预算的包装对象。 |
| 2.4.2.1.1 | monetaryBudget | 以指定币种计价的预算金额 | object | — | 必填 | 以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。 |
| 2.4.2.1.1.1 | value | 以广告店铺对应币种计价的预算金额 | number | — | 必填 | 以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。 |
| 2.4.3 | recurrenceTimePeriod | DAILY=每日预算 | string | — | 必填 | DAILY=每日预算 LIFETIME=广告活动全生命周期预算。 |
| 2.5 | costType | CPC=按点击计费 | string | — | 必填 | CPC=按点击计费 CPM=按千次展示计费 FIXED_PRICE=特定广告位固定价格 VCPM=按千次可见展示计费。 |
| 2.6 | countries | 影响广告投放范围的国家代码列表 | array<any> | — | 可选 | 影响广告投放范围的国家代码列表;品牌推广最多一个国家。 |
| 2.7 | endDateTime | 广告活动结束日期 | string | — | 可选 | 广告活动结束日期,格式为 yyyy-MM-dd,例如 2026-10-10;不得早于开始日期。 |
| 2.8 | marketplaceScope | marketplaceScope | string | — | 必填 | SINGLE_MARKETPLACE 表示单站点广告活动。 |
| 2.9 | marketplaces | 广告活动投放的亚马逊零售站点列表 | array<any> | — | 必填 | 广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配 US 表示美国站。 最少1项 |
| 2.10 | name | 用于识别和管理广告活动的名称 | string | — | 必填 | 用于识别和管理广告活动的名称。 |
| 2.11 | optimizations | 活动竞价配置与营销目标优化设置 | object | — | 可选 | 活动竞价配置与营销目标优化设置。 |
| 2.11.1 | bidSettings | 活动竞价策略和竞价调整配置 | object | — | 可选 | 活动竞价策略和竞价调整配置。 |
| 2.11.1.1 | bidAdjustments | 按广告位或受众配置的竞价调整 | object | — | 可选 | 按广告位或受众配置的竞价调整。 |
| 2.11.1.1.1 | audienceBidAdjustments | 官方定义的受众竞价调整列表 | array<object> | — | 可选 | 官方定义的受众竞价调整列表,最多一项。 |
| 2.11.1.1.1.1 | audienceId | 应用竞价调整的受众唯一标识 | string | — | 可选 | 应用竞价调整的受众唯一标识,可不传或传空字符串;有值时应为当前广告店铺可用的受众。 |
| 2.11.1.1.1.2 | percentage | 以整数百分数表示竞价调整比例 | integer | — | 必填 | 以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。 |
| 2.11.1.1.2 | placementBidAdjustments | 按广告位配置的竞价调整 | array<object> | — | 可选 | 按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。 |
| 2.11.1.1.2.1 | percentage | 以整数百分数表示竞价调整比例 | integer | — | 必填 | 以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。 |
| 2.11.1.1.2.2 | placement | HOME_PAGE=首页 | string | — | 必填 | HOME_PAGE=首页 PRODUCT_PAGE=商品详情页及相关非搜索广告位 REST_OF_SEARCH=搜索结果其余位置 TOP_OF_SEARCH=搜索结果顶部。 |
| 2.11.1.1.3 | shopperSegmentBidAdjustments | 官方标记为待废弃的品牌推广历史字段 | array<object> | — | 可选 | 官方标记为待废弃的品牌推广历史字段,最多两项;本次请求包含此字段,但成功响应未回显,是否实际应用需另行核验。 |
| 2.11.1.1.3.1 | percentage | 针对指定购物者人群的竞价调整比例 | integer | — | 可选 | 针对指定购物者人群的竞价调整比例;10 表示提高 10%。此子字段依据用户请求样本补充。 |
| 2.11.1.1.3.2 | audienceSegments | 应用调价的受众细分配置 | array<object> | — | 可选 | 应用调价的受众细分配置;结构依据用户请求样本补充。 |
| 2.11.1.1.3.2.1 | audienceId | 应用该调整的受众唯一标识 | string | — | 可选 | 应用该调整的受众唯一标识,必须对当前广告店铺可用。 |
| 2.11.1.1.3.2.2 | audienceSegmentType | audienceSegmentType | string | — | 可选 | 样本值 SPONSORED_ADS_AMC 表示亚马逊营销云的广告受众;官方创建规范未给出该旧字段的完整枚举,故不限制为此单一值。 |
| 2.11.1.1.3.3 | shopperCohortType | shopperCohortType | string | — | 可选 | 样本值 AUDIENCE_SEGMENT 表示按受众细分设置;官方创建规范未给出该旧字段的完整枚举。 |
| 2.11.1.2 | bidStrategy | MANUAL 表示使用设置的竞价及广告位调整 | string | — | 可选 | MANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价 SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。 |
| 2.11.2 | goalSettings | 活动的营销目标和优化指标 | object | — | 可选 | 活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。 |
| 2.11.2.1 | kpi | CLICKS=增加点击 | string | — | 必填 | CLICKS=增加点击 TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。 |
| 2.12 | portfolioId | 活动所属广告组合的唯一标识 | string | — | 可选 | 活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。 |
| 2.13 | salesChannel | AMAZON=在亚马逊自有站点销售 | string | — | 可选 | AMAZON=在亚马逊自有站点销售 OFF_AMAZON=在亚马逊以外的站点销售。 |
| 2.14 | siteRestrictions | 限定广告展示站点 | array<any> | — | 可选 | 限定广告展示站点;最多一项。 |
| 2.15 | startDateTime | 活动计划开始投放的日期 | string | — | 必填 | 活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。 |
| 2.16 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停。已启用仍需满足开始时间及其他投放条件。 |
| 2.17 | targetedPGDealId | 与广告活动关联的交易唯一标识 | string | — | 可选 | 与广告活动关联的交易唯一标识。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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 | adProduct | adProduct | string | — | 必填 | SPONSORED_BRANDS 表示品牌推广广告。 |
| 6.1.2 | autoCreationSettings | 是否允许亚马逊根据推广商品自动创建投放目标 | object | — | 必填 | 是否允许亚马逊根据推广商品自动创建投放目标。 |
| 6.1.2.1 | autoCreateTargets | true=允许亚马逊根据推广商品自动创建投放目标 | boolean | — | 必填 | true=允许亚马逊根据推广商品自动创建投放目标 false=不允许。 |
| 6.1.3 | budgets | 品牌推广活动的预算列表 | array<object> | — | 必填 | 品牌推广活动的预算列表,须且仅包含一项预算。 |
| 6.1.3.1 | budgetType | MONETARY 表示货币金额预算 | string | — | 必填 | MONETARY 表示货币金额预算。 |
| 6.1.3.2 | budgetValue | 预算值类型包装 | object | — | 必填 | 预算值类型包装;品牌推广使用货币预算。 |
| 6.1.3.2.1 | monetaryBudgetValue | 货币预算的包装对象 | object | — | 必填 | 货币预算的包装对象。 |
| 6.1.3.2.1.1 | monetaryBudget | 以指定币种计价的预算金额 | object | — | 必填 | 以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。 |
| 6.1.3.2.1.1.1 | currencyCode | AED=阿联酋迪拉姆 | string | — | 必填 | AED=阿联酋迪拉姆 AUD=澳大利亚元 BRL=巴西雷亚尔 CAD=加拿大元 CHF=瑞士法郎 CNY=人民币 DKK=丹麦克朗 EGP=埃及镑 EUR=欧元 GBP=英镑 INR=印度卢比 JPY=日元 MXN、MXP=墨西哥比索 NGN=尼日利亚奈拉 NOK=挪威克朗 NZD=新西兰元 PLN=波兰兹罗提 SAR=沙特里亚尔 SEK=瑞典克朗 SGD=新加坡元 TRY=土耳其里拉 USD=美元 ZAR=南非兰特。 |
| 6.1.3.2.1.1.2 | value | 以广告店铺对应币种计价的预算金额 | number | — | 必填 | 以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。 |
| 6.1.3.3 | recurrenceTimePeriod | DAILY=每日预算 | string | — | 必填 | DAILY=每日预算 LIFETIME=广告活动全生命周期预算。 |
| 6.1.4 | campaignId | 亚马逊创建成功后生成的活动唯一标识 | string | — | 必填 | 亚马逊创建成功后生成的活动唯一标识,使用字符串保存,避免长整数精度丢失。 |
| 6.1.5 | costType | CPC=按点击计费 | string | — | 必填 | CPC=按点击计费 CPM=按千次展示计费 FIXED_PRICE=特定广告位固定价格 VCPM=按千次可见展示计费。 |
| 6.1.6 | countries | 影响广告投放范围的国家代码列表 | array<any> | — | 必填 | 影响广告投放范围的国家代码列表;品牌推广最多一个国家。 |
| 6.1.7 | creationDateTime | 亚马逊记录的活动创建时间 | string | — | 必填 | 亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。 |
| 6.1.8 | isMultiAdGroupsEnabled | 只读返回字段 | boolean | — | 必填 | 只读返回字段 true 表示活动支持多个广告组,false 表示不支持。 |
| 6.1.9 | lastUpdatedDateTime | 亚马逊记录的活动最后更新时间 | string | — | 必填 | 亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。 |
| 6.1.10 | marketplaceScope | marketplaceScope | string | — | 必填 | SINGLE_MARKETPLACE 表示单站点广告活动。 |
| 6.1.11 | marketplaces | 广告活动投放的亚马逊零售站点列表 | array<any> | — | 必填 | 广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配 US 表示美国站。 |
| 6.1.12 | name | 用于识别和管理广告活动的名称 | string | — | 必填 | 用于识别和管理广告活动的名称。 |
| 6.1.13 | optimizations | 活动竞价配置与营销目标优化设置 | object | — | 必填 | 活动竞价配置与营销目标优化设置。 |
| 6.1.13.1 | bidSettings | 活动竞价策略和竞价调整配置 | object | — | 必填 | 活动竞价策略和竞价调整配置。 |
| 6.1.13.1.1 | bidAdjustments | 按广告位或受众配置的竞价调整 | object | — | 必填 | 按广告位或受众配置的竞价调整。 |
| 6.1.13.1.1.1 | placementBidAdjustments | 按广告位配置的竞价调整 | array<object> | — | 必填 | 按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。 |
| 6.1.13.1.1.1.1 | percentage | 以整数百分数表示竞价调整比例 | integer | — | 必填 | 以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。 |
| 6.1.13.1.1.1.2 | placement | HOME_PAGE=首页 | string | — | 必填 | HOME_PAGE=首页 PRODUCT_PAGE=商品详情页及相关非搜索广告位 REST_OF_SEARCH=搜索结果其余位置 TOP_OF_SEARCH=搜索结果顶部。 |
| 6.1.13.1.2 | bidStrategy | MANUAL 表示使用设置的竞价及广告位调整 | string | — | 必填 | MANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价 SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。 |
| 6.1.13.2 | goalSettings | 活动的营销目标和优化指标 | object | — | 必填 | 活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。 |
| 6.1.13.2.1 | goal | AWARENESS=提升品牌认知 | string | — | 必填 | AWARENESS=提升品牌认知 CONSIDERATION=提升购买考虑度 CONVERSIONS=促进转化。 |
| 6.1.13.2.2 | kpi | CLICKS=增加点击 | string | — | 必填 | CLICKS=增加点击 TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。 |
| 6.1.14 | startDateTime | 活动计划开始投放的日期 | string | 2026-10-10 | 必填 | 活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。 |
| 6.1.15 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。 |
| 6.1.16 | code | SUCCESS 表示当前广告活动创建成功 | string | SUCCESS | 必填 | SUCCESS 表示当前广告活动创建成功。 |
| 6.1.17 | index | 对应请求活动数组中的原始下标 | integer | — | 必填 | 对应请求活动数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | 必填 | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
领星ERP的接口:创建 SB 广告活动(/basicOpen/adReport/manage/postSbCampaign),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。