轻易云
注册体验

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

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

创建 SP 广告活动

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

接口请求参数

序号字段名称类型默认值必填描述
1profileId广告店铺 Profile IDstring—必填广告店铺 Profile ID;使用数字字符串传递,避免长 ID 精度丢失,必须属于当前授权租户。
2campaigns广告活动列表array<object>—必填广告活动列表 最少1项 最多1000项
2.1adProduct广告产品类型string—必填广告产品类型 可选值: SPONSORED_PRODUCTS
2.2autoCreationSettings自动创建设置object—必填自动创建设置
2.2.1autoCreateTargetsautoCreateTargetsboolean—必填是否允许亚马逊根据推广商品自动创建广告活动的投放目标
2.2.2autoManageCampaign是否允许亚马逊管理广告活动的生命周期boolean—可选是否允许亚马逊管理广告活动的生命周期
2.3budgets广告活动预算配置列表array<object>—必填广告活动预算配置列表 最少1项
2.3.1budgetType预算类型string—必填预算类型 可选值: MONETARY
2.3.2budgetValue预算值配置object—必填预算值配置
2.3.2.1monetaryBudgetValue货币预算配置object—必填货币预算配置
2.3.2.1.1monetaryBudget货币预算金额object—必填货币预算金额
2.3.2.1.1.1value指定币种的预算金额number—可选指定币种的预算金额
2.3.3recurrenceTimePeriod预算周期string—必填预算周期 可选值: DAILY
2.4countries投放国家代码列表array<any>—可选投放国家代码列表,决定广告活动可投放的亚马逊零售站点及库存范围
2.5endDateTime广告活动结束时间string—可选广告活动结束时间,包含时区
2.6marketplaceScope站点范围string—必填站点范围 可选值: SINGLE_MARKETPLACE
2.7marketplaces亚马逊零售站点代码列表array<any>—必填亚马逊零售站点代码列表,须与广告店铺匹配 最少1项
2.8name广告活动名称string—必填广告活动名称
2.9optimizations优化配置object—可选优化配置
2.9.1bidSettings竞价设置object—可选竞价设置
2.9.1.1bidAdjustments竞价调整设置object—可选竞价调整设置
2.9.1.1.1audienceBidAdjustments按受众调整竞价array<object>—可选按受众调整竞价
2.9.1.1.1.1audienceId用于调整竞价的受众唯一标识string—必填用于调整竞价的受众唯一标识
2.9.1.1.1.2percentage竞价调整百分比integer—必填竞价调整百分比
2.9.1.1.2creativeBidAdjustments按创意类型调整竞价array<object>—可选按创意类型调整竞价,调整比例范围为0~900
2.9.1.1.2.1creativeType创意类型string—可选创意类型。可不传或传空字符串,非空值须为列出的可选值 可选值: SPOTLIGHT
2.9.1.1.2.2percentage竞价调整百分比integer—必填竞价调整百分比
2.9.1.1.3placementBidAdjustments按广告位调整竞价array<object>—可选按广告位调整竞价;使用 SALES_UP_AND_DOWN 策略的品牌推广活动不支持
2.9.1.1.3.1percentage竞价调整百分比integer—必填竞价调整百分比
2.9.1.1.3.2placement广告位string—必填广告位 可选值: PRODUCT_PAGE REST_OF_SEARCH SITE_AMAZON_BUSINESS TOP_OF_SEARCH
2.9.1.2bidStrategy竞价策略string—可选竞价策略。可不传或传空字符串,非空值须为列出的可选值 可选值: MANUAL RULE_BASED SALES_DOWN_ONLY SALES_UP_AND_DOWN
2.9.2budgetSettings预算设置object—可选预算设置
2.9.2.1offAmazonBudgetControlStrategy站外预算控制策略string—可选站外预算控制策略。可不传或传空字符串,非空值须为列出的可选值 可选值: MAXIMIZE_REACH MINIMIZE_SPEND
2.10portfolioId活动所属广告组合的唯一标识string—可选活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
2.11siteRestrictions限制广告投放的网站array<any>—可选限制广告投放的网站
2.12startDateTime广告活动开始时间string—必填广告活动开始时间,包含时区
2.13state状态string—必填状态 可选值: ENABLED PAUSED

接口响应参数

序号字段名称类型默认值必填描述
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.1code当前活动的创建结果stringSUCCESS必填当前活动的创建结果 SUCCESS 表示创建成功。
6.1.2index对应请求 campaigns 数组中的原始下标integer—必填对应请求 campaigns 数组中的原始下标,从 0 开始;0 表示第一个活动。
6.1.3adProductadProductstringSPONSORED_PRODUCTS必填SPONSORED_PRODUCTS 表示商品推广广告。
6.1.4autoCreationSettings广告活动的自动创建配置object—必填广告活动的自动创建配置。
6.1.4.1autoCreateTargets是否允许亚马逊根据推广商品自动创建投放目标boolean—必填是否允许亚马逊根据推广商品自动创建投放目标 true 表示允许,false 表示不允许。
6.1.5autoScaleGlobalCampaignAUTO 表示自动将全球广告活动扩展到新的站点stringAUTO必填AUTO 表示自动将全球广告活动扩展到新的站点 MANUAL 表示手动扩展。该字段本身不表示当前活动已经在多个站点投放。
6.1.6budgets广告活动的预算配置列表array<object>—必填广告活动的预算配置列表;商品推广活动包含一项预算。
6.1.6.1budgetTypeMONETARY 表示以货币金额设置预算stringMONETARY必填MONETARY 表示以货币金额设置预算。
6.1.6.2budgetValue预算具体取值的包装对象object—必填预算具体取值的包装对象。
6.1.6.2.1monetaryBudgetValue货币金额类型的预算值object—必填货币金额类型的预算值。
6.1.6.2.1.1monetaryBudget预算金额及其对应的币种object—必填预算金额及其对应的币种。
6.1.6.2.1.1.1currencyCode预算金额使用的货币代码string—必填预算金额使用的货币代码 USD 表示美元。
6.1.6.2.1.1.2value以对应币种计价的预算金额number—必填以对应币种计价的预算金额;结合 DAILY 周期,本例表示每日预算为 376 美元。
6.1.6.3recurrenceTimePeriodDAILY 表示每日预算stringDAILY必填DAILY 表示每日预算。
6.1.7campaignId亚马逊生成的广告活动唯一标识string—必填亚马逊生成的广告活动唯一标识;使用字符串保存,避免长整数精度丢失。
6.1.8countriesstring 数组array<any>—必填string 数组,活动投放的国家代码列表 US 表示美国。
6.1.9creationDateTime亚马逊记录的活动创建时间string—必填亚马逊记录的活动创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
6.1.10lastUpdatedDateTime亚马逊记录的活动最后更新时间string—必填亚马逊记录的活动最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
6.1.11marketplaceScopemarketplaceScopestringSINGLE_MARKETPLACE必填SINGLE_MARKETPLACE 表示单站点广告活动。
6.1.12marketplacesstring 数组array<any>—必填string 数组,活动所属亚马逊零售站点的国家代码列表 US 表示美国站。
6.1.13name创建成功的广告活动名称string—必填创建成功的广告活动名称。
6.1.14optimizations活动的竞价和预算优化配置object—必填活动的竞价和预算优化配置。
6.1.14.1bidSettings竞价策略及各维度竞价调整配置object—必填竞价策略及各维度竞价调整配置。
6.1.14.1.1bidAdjustments按受众或广告位设置的竞价调整配置object—必填按受众或广告位设置的竞价调整配置。
6.1.14.1.1.1audienceBidAdjustments针对指定受众的竞价调整配置array<object>—必填针对指定受众的竞价调整配置。
6.1.14.1.1.1.1audienceId应用该竞价调整的受众唯一标识string—必填应用该竞价调整的受众唯一标识;本例为本次创建成功响应返回的受众。
6.1.14.1.1.1.2percentage以整数百分数表示针对该受众的竞价调整integer—必填以整数百分数表示针对该受众的竞价调整;9 表示增加 9%,不是小数 0.09。
6.1.14.1.1.2placementBidAdjustments不同广告位对应的竞价调整配置array<object>—必填不同广告位对应的竞价调整配置。
6.1.14.1.1.2.1percentage以整数百分数表示该广告位的竞价调整integer—必填以整数百分数表示该广告位的竞价调整;24 表示增加 24%。
6.1.14.1.1.2.2placementTOP_OF_SEARCH 表示搜索结果顶部stringTOP_OF_SEARCH必填TOP_OF_SEARCH 表示搜索结果顶部 REST_OF_SEARCH 表示搜索结果其余位置 PRODUCT_PAGE 表示商品详情页及相关非搜索广告位 SITE_AMAZON_BUSINESS 表示亚马逊企业购站点广告位。
6.1.14.1.2bidStrategyMANUAL 表示固定竞价stringMANUAL必填MANUAL 表示固定竞价 RULE_BASED 表示基于规则的竞价 SALES_DOWN_ONLY 表示动态竞价只降低 SALES_UP_AND_DOWN 表示动态竞价提高和降低。
6.1.14.2budgetSettings预算分配方式及亚马逊站外预算控制策略object—必填预算分配方式及亚马逊站外预算控制策略。
6.1.14.2.1marketplaceBudgetAllocationAUTO 表示自动将全球广告活动预算分配到各站点stringAUTO必填AUTO 表示自动将全球广告活动预算分配到各站点 MANUAL 表示手动分配。
6.1.14.2.2offAmazonBudgetControlStrategyoffAmazonBudgetControlStrategystringMAXIMIZE_REACH必填MAXIMIZE_REACH 表示在预算范围内扩大亚马逊站外触达 MINIMIZE_SPEND 表示在维持投放的同时尽量减少亚马逊站外花费。
6.1.15startDateTime活动计划开始投放的时间string—必填活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
6.1.16stateENABLED 表示已启用stringENABLED必填ENABLED 表示已启用 PAUSED 表示已暂停 ARCHIVED 表示已归档且不可重新启用。已启用不等于当前正在投放,还取决于开始时间和其他投放条件。
7total统一响应中的总数integer0必填统一响应中的总数,本创建接口未设置分页总数,默认为0

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

需要对接这个接口?

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