Qeasy Cloud
Get Started

领星ERP 创建 SB 广告活动 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
广告 / 广告管理 · POST · 请求参数 43 个(必填 20) · 响应参数 42 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建 SB 广告活动

POST/basicOpen/adReport/manage/postSbCampaign
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId广告店铺唯一标识string—Required广告店铺唯一标识,必须属于当前授权企业;使用数字字符串避免长整数精度丢失。本文件记录用户提供的广告店铺标识调用方式。
2campaigns待创建的品牌推广广告活动array<object>—Required待创建的品牌推广广告活动;每次提交 1~10 个。 最少1项 最多10项
2.1adProductadProductstring—RequiredSPONSORED_BRANDS 表示品牌推广广告。
2.2autoCreationSettings是否允许亚马逊根据推广商品自动创建投放目标object—Optional是否允许亚马逊根据推广商品自动创建投放目标。
2.2.1autoCreateTargetstrue=允许亚马逊根据推广商品自动创建投放目标boolean—Optionaltrue=允许亚马逊根据推广商品自动创建投放目标 false=不允许。
2.3brandId广告活动关联的品牌唯一标识string—Optional广告活动关联的品牌唯一标识。
2.4budgets品牌推广活动的预算列表array<object>—Required品牌推广活动的预算列表,须且仅包含一项预算。 最少1项
2.4.1budgetTypeMONETARY 表示货币金额预算string—RequiredMONETARY 表示货币金额预算。
2.4.2budgetValue预算值类型包装object—Required预算值类型包装;品牌推广使用货币预算。
2.4.2.1monetaryBudgetValue货币预算的包装对象object—Required货币预算的包装对象。
2.4.2.1.1monetaryBudget以指定币种计价的预算金额object—Required以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。
2.4.2.1.1.1value以广告店铺对应币种计价的预算金额number—Required以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。
2.4.3recurrenceTimePeriodDAILY=每日预算string—RequiredDAILY=每日预算 LIFETIME=广告活动全生命周期预算。
2.5costTypeCPC=按点击计费string—RequiredCPC=按点击计费 CPM=按千次展示计费 FIXED_PRICE=特定广告位固定价格 VCPM=按千次可见展示计费。
2.6countries影响广告投放范围的国家代码列表array<any>—Optional影响广告投放范围的国家代码列表;品牌推广最多一个国家。
2.7endDateTime广告活动结束日期string—Optional广告活动结束日期,格式为 yyyy-MM-dd,例如 2026-10-10;不得早于开始日期。
2.8marketplaceScopemarketplaceScopestring—RequiredSINGLE_MARKETPLACE 表示单站点广告活动。
2.9marketplaces广告活动投放的亚马逊零售站点列表array<any>—Required广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配 US 表示美国站。 最少1项
2.10name用于识别和管理广告活动的名称string—Required用于识别和管理广告活动的名称。
2.11optimizations活动竞价配置与营销目标优化设置object—Optional活动竞价配置与营销目标优化设置。
2.11.1bidSettings活动竞价策略和竞价调整配置object—Optional活动竞价策略和竞价调整配置。
2.11.1.1bidAdjustments按广告位或受众配置的竞价调整object—Optional按广告位或受众配置的竞价调整。
2.11.1.1.1audienceBidAdjustments官方定义的受众竞价调整列表array<object>—Optional官方定义的受众竞价调整列表,最多一项。
2.11.1.1.1.1audienceId应用竞价调整的受众唯一标识string—Optional应用竞价调整的受众唯一标识,可不传或传空字符串;有值时应为当前广告店铺可用的受众。
2.11.1.1.1.2percentage以整数百分数表示竞价调整比例integer—Required以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
2.11.1.1.2placementBidAdjustments按广告位配置的竞价调整array<object>—Optional按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。
2.11.1.1.2.1percentage以整数百分数表示竞价调整比例integer—Required以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
2.11.1.1.2.2placementHOME_PAGE=首页string—RequiredHOME_PAGE=首页 PRODUCT_PAGE=商品详情页及相关非搜索广告位 REST_OF_SEARCH=搜索结果其余位置 TOP_OF_SEARCH=搜索结果顶部。
2.11.1.1.3shopperSegmentBidAdjustments官方标记为待废弃的品牌推广历史字段array<object>—Optional官方标记为待废弃的品牌推广历史字段,最多两项;本次请求包含此字段,但成功响应未回显,是否实际应用需另行核验。
2.11.1.1.3.1percentage针对指定购物者人群的竞价调整比例integer—Optional针对指定购物者人群的竞价调整比例;10 表示提高 10%。此子字段依据用户请求样本补充。
2.11.1.1.3.2audienceSegments应用调价的受众细分配置array<object>—Optional应用调价的受众细分配置;结构依据用户请求样本补充。
2.11.1.1.3.2.1audienceId应用该调整的受众唯一标识string—Optional应用该调整的受众唯一标识,必须对当前广告店铺可用。
2.11.1.1.3.2.2audienceSegmentTypeaudienceSegmentTypestring—Optional样本值 SPONSORED_ADS_AMC 表示亚马逊营销云的广告受众;官方创建规范未给出该旧字段的完整枚举,故不限制为此单一值。
2.11.1.1.3.3shopperCohortTypeshopperCohortTypestring—Optional样本值 AUDIENCE_SEGMENT 表示按受众细分设置;官方创建规范未给出该旧字段的完整枚举。
2.11.1.2bidStrategyMANUAL 表示使用设置的竞价及广告位调整string—OptionalMANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价 SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。
2.11.2goalSettings活动的营销目标和优化指标object—Optional活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。
2.11.2.1kpiCLICKS=增加点击string—RequiredCLICKS=增加点击 TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。
2.12portfolioId活动所属广告组合的唯一标识string—Optional活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
2.13salesChannelAMAZON=在亚马逊自有站点销售string—OptionalAMAZON=在亚马逊自有站点销售 OFF_AMAZON=在亚马逊以外的站点销售。
2.14siteRestrictions限定广告展示站点array<any>—Optional限定广告展示站点;最多一项。
2.15startDateTime活动计划开始投放的日期string—Required活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。
2.16stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停。已启用仍需满足开始时间及其他投放条件。
2.17targetedPGDealId与广告活动关联的交易唯一标识string—Optional与广告活动关联的交易唯一标识。

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code平台业务状态码integer0Required平台业务状态码,0 表示成功
2message响应消息stringsuccessRequired响应消息
3error_details参数校验等错误详情array<any>[]Required参数校验等错误详情
4request_id请求链路标识stringexample-request-idRequired请求链路标识
5response_time响应时间string2026-10-19 12:00:00Required响应时间
6data响应数据object—Required响应数据。
6.1apiResult每项结果通过原始下标对应请求中的活动array<object>—Required每项结果通过原始下标对应请求中的活动;应检查每项结果码,批量或工具调用可能包含失败项。
6.1.1adProductadProductstring—RequiredSPONSORED_BRANDS 表示品牌推广广告。
6.1.2autoCreationSettings是否允许亚马逊根据推广商品自动创建投放目标object—Required是否允许亚马逊根据推广商品自动创建投放目标。
6.1.2.1autoCreateTargetstrue=允许亚马逊根据推广商品自动创建投放目标boolean—Requiredtrue=允许亚马逊根据推广商品自动创建投放目标 false=不允许。
6.1.3budgets品牌推广活动的预算列表array<object>—Required品牌推广活动的预算列表,须且仅包含一项预算。
6.1.3.1budgetTypeMONETARY 表示货币金额预算string—RequiredMONETARY 表示货币金额预算。
6.1.3.2budgetValue预算值类型包装object—Required预算值类型包装;品牌推广使用货币预算。
6.1.3.2.1monetaryBudgetValue货币预算的包装对象object—Required货币预算的包装对象。
6.1.3.2.1.1monetaryBudget以指定币种计价的预算金额object—Required以指定币种计价的预算金额;创建时币种依据广告店铺确定,响应中返回币种代码。
6.1.3.2.1.1.1currencyCodeAED=阿联酋迪拉姆string—RequiredAED=阿联酋迪拉姆 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.2value以广告店铺对应币种计价的预算金额number—Required以广告店铺对应币种计价的预算金额;每日或生命周期由预算周期决定。本例为每日 10 美元。
6.1.3.3recurrenceTimePeriodDAILY=每日预算string—RequiredDAILY=每日预算 LIFETIME=广告活动全生命周期预算。
6.1.4campaignId亚马逊创建成功后生成的活动唯一标识string—Required亚马逊创建成功后生成的活动唯一标识,使用字符串保存,避免长整数精度丢失。
6.1.5costTypeCPC=按点击计费string—RequiredCPC=按点击计费 CPM=按千次展示计费 FIXED_PRICE=特定广告位固定价格 VCPM=按千次可见展示计费。
6.1.6countries影响广告投放范围的国家代码列表array<any>—Required影响广告投放范围的国家代码列表;品牌推广最多一个国家。
6.1.7creationDateTime亚马逊记录的活动创建时间string—Required亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。
6.1.8isMultiAdGroupsEnabled只读返回字段boolean—Required只读返回字段 true 表示活动支持多个广告组,false 表示不支持。
6.1.9lastUpdatedDateTime亚马逊记录的活动最后更新时间string—Required亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。
6.1.10marketplaceScopemarketplaceScopestring—RequiredSINGLE_MARKETPLACE 表示单站点广告活动。
6.1.11marketplaces广告活动投放的亚马逊零售站点列表array<any>—Required广告活动投放的亚马逊零售站点列表,须与广告店铺授权站点匹配 US 表示美国站。
6.1.12name用于识别和管理广告活动的名称string—Required用于识别和管理广告活动的名称。
6.1.13optimizations活动竞价配置与营销目标优化设置object—Required活动竞价配置与营销目标优化设置。
6.1.13.1bidSettings活动竞价策略和竞价调整配置object—Required活动竞价策略和竞价调整配置。
6.1.13.1.1bidAdjustments按广告位或受众配置的竞价调整object—Required按广告位或受众配置的竞价调整。
6.1.13.1.1.1placementBidAdjustments按广告位配置的竞价调整array<object>—Required按广告位配置的竞价调整,最多四项;品牌推广使用 SALES_UP_AND_DOWN 动态竞价策略时不支持该配置。
6.1.13.1.1.1.1percentage以整数百分数表示竞价调整比例integer—Required以整数百分数表示竞价调整比例;例如 10 表示提高 10%,0 表示不调整。
6.1.13.1.1.1.2placementHOME_PAGE=首页string—RequiredHOME_PAGE=首页 PRODUCT_PAGE=商品详情页及相关非搜索广告位 REST_OF_SEARCH=搜索结果其余位置 TOP_OF_SEARCH=搜索结果顶部。
6.1.13.1.2bidStrategyMANUAL 表示使用设置的竞价及广告位调整string—RequiredMANUAL 表示使用设置的竞价及广告位调整,不使用动态竞价 SALES_UP_AND_DOWN 表示根据销售转化机会动态提高或降低竞价,官方说明最大调整幅度为 100%。
6.1.13.2goalSettings活动的营销目标和优化指标object—Required活动的营销目标和优化指标;创建时传入优化指标,返回值可包含亚马逊确定的营销目标。
6.1.13.2.1goalAWARENESS=提升品牌认知string—RequiredAWARENESS=提升品牌认知 CONSIDERATION=提升购买考虑度 CONVERSIONS=促进转化。
6.1.13.2.2kpiCLICKS=增加点击string—RequiredCLICKS=增加点击 TOP_OF_SEARCH_IMPRESSION_SHARE=提高搜索结果顶部展示份额。
6.1.14startDateTime活动计划开始投放的日期string2026-10-10Required活动计划开始投放的日期,格式为 yyyy-MM-dd,例如 2026-10-10。实际创建时不得使用过去的开始日期。
6.1.15stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.16codeSUCCESS 表示当前广告活动创建成功stringSUCCESSRequiredSUCCESS 表示当前广告活动创建成功。
6.1.17index对应请求活动数组中的原始下标integer—Required对应请求活动数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0Required统一响应中的总数,本创建接口未设置分页总数,默认为0

The 创建 SB 广告活动 API (/basicOpen/adReport/manage/postSbCampaign) 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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.