轻易云
注册体验

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

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

创建 SD 广告活动

POST/basicOpen/adReport/manage/postSdCampaign
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSdCampaign"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdCampaign?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_DISPLAY\",\n            \"budgets\": [\n                {\n                    \"budgetType\": \"MONETARY\",\n                    \"budgetValue\": {\n                        \"monetaryBudgetValue\": {\n                            \"monetaryBudget\": {\n                                \"value\": 1\n                            }\n                        }\n                    }\n                }\n            ],\n            \"costType\": \"CPC\",\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": [
        {
          "adProduct": "SPONSORED_DISPLAY",
          "budgets": [
            {
              "budgetType": "MONETARY",
              "budgetValue": {
                "monetaryBudgetValue": {
                  "monetaryBudget": {
                    "currencyCode": "USD",
                    "value": 1
                  }
                }
              },
              "recurrenceTimePeriod": "DAILY"
            }
          ],
          "campaignId": "1234567890123456",
          "costType": "CPC",
          "countries": [
            "US"
          ],
          "creationDateTime": "2026-10-20T00:00:00Z",
          "endDateTime": "2026-10-20T00:00:00Z",
          "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
          "marketplaceScope": "SINGLE_MARKETPLACE",
          "marketplaces": [
            "US"
          ],
          "name": "示例广告",
          "startDateTime": "2026-10-20T00:00:00Z",
          "state": "PAUSED",
          "code": "SUCCESS",
          "index": 0
        }
      ]
    },
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1profileId必须属于当前授权企业的广告店铺唯一标识string—必填必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
2campaigns待创建的展示型推广活动列表array<object>—必填待创建的展示型推广活动列表;每次提交 1~100 个活动。 最少1项 最多100项
2.1adProductadProductstring—必填SPONSORED_DISPLAY 表示展示型推广广告。
2.2budgets活动的货币预算列表array<object>—必填活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。 最少1项
2.2.1budgetTypeMONETARY 表示货币金额预算string—必填MONETARY 表示货币金额预算。
2.2.2budgetValue货币预算值的类型包装对象object—必填货币预算值的类型包装对象。
2.2.2.1monetaryBudgetValue货币预算金额的包装对象object—必填货币预算金额的包装对象。
2.2.2.1.1monetaryBudget以广告店铺对应币种计价的预算金额object—必填以广告店铺对应币种计价的预算金额;创建时不传币种字段。
2.2.2.1.1.1value以广告店铺对应币种计价的预算金额number—必填以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
2.3costTypeCPC=按点击计费string—必填CPC=按点击计费 VCPM=按千次可见展示计费。
2.4countries活动投放范围的国家代码列表array<any>—可选活动投放范围的国家代码列表,最多一个国家 US 表示美国。
2.5endDateTime广告活动结束时间string—可选广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
2.6marketplaceScopemarketplaceScopestring—必填SINGLE_MARKETPLACE 表示单站点广告活动。
2.7marketplaces活动投放的亚马逊零售站点代码列表array<any>—必填活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。 最少1项
2.8name用于识别和管理广告活动的名称string—必填用于识别和管理广告活动的名称。
2.9portfolioId活动所属广告组合的唯一标识string—可选活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
2.10startDateTime活动计划开始投放的时间string—必填活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
2.11stateENABLED=已启用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.1adProductadProductstring—必填SPONSORED_DISPLAY 表示展示型推广广告。
6.1.2budgets活动的货币预算列表array<object>—必填活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。
6.1.2.1budgetTypeMONETARY 表示货币金额预算string—必填MONETARY 表示货币金额预算。
6.1.2.2budgetValue货币预算值的类型包装对象object—必填货币预算值的类型包装对象。
6.1.2.2.1monetaryBudgetValue货币预算金额的包装对象object—必填货币预算金额的包装对象。
6.1.2.2.1.1monetaryBudget响应中的预算金额及其币种object—必填响应中的预算金额及其币种。
6.1.2.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.2.2.1.1.2value以广告店铺对应币种计价的预算金额number—必填以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
6.1.2.3recurrenceTimePeriodDAILY 表示每日预算string—必填DAILY 表示每日预算;该字段出现在展示型推广活动的预算响应中,官方创建预算对象未定义此字段。
6.1.3campaignId亚马逊创建成功后生成的活动唯一标识string—必填亚马逊创建成功后生成的活动唯一标识;以字符串保存,避免长整数精度丢失。
6.1.4costTypeCPC=按点击计费string—必填CPC=按点击计费 VCPM=按千次可见展示计费。
6.1.5countries活动投放范围的国家代码列表array<any>—必填活动投放范围的国家代码列表,最多一个国家 US 表示美国。
6.1.6creationDateTime亚马逊记录的活动创建时间string—必填亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。
6.1.7endDateTime广告活动结束时间string—必填广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
6.1.8lastUpdatedDateTime亚马逊记录的活动最后更新时间string—必填亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。
6.1.9marketplaceScopemarketplaceScopestring—必填SINGLE_MARKETPLACE 表示单站点广告活动。
6.1.10marketplaces活动投放的亚马逊零售站点代码列表array<any>—必填活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。
6.1.11name用于识别和管理广告活动的名称string—必填用于识别和管理广告活动的名称。
6.1.12startDateTime活动计划开始投放的时间string—必填活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
6.1.13stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.14codeSUCCESS 表示当前广告活动创建成功stringSUCCESS必填SUCCESS 表示当前广告活动创建成功。
6.1.15index对应请求活动数组中的原始下标integer—必填对应请求活动数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0必填统一响应中的总数,本创建接口未设置分页总数,默认为0

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

需要对接这个接口?

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