Qeasy Cloud
Get Started

领星ERP 创建 SP 广告活动 API

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

创建 SP 广告活动

POST/basicOpen/adReport/manage/postSpCampaign
Factory
{
  "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
  }
}

Request Parameters

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

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

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