轻易云
注册体验

领星ERP创建 SB 广告活动接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
广告 / 广告管理 · POST · 请求参数 43 个(必填 20) · 响应参数 42 个 · 限流令牌桶容量 1
更新日期
2026-11-21

创建 SB 广告活动

POST/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&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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:创建 SB 广告活动(/basicOpen/adReport/manage/postSbCampaign),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。