/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×tamp=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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | profileId | 必须属于当前授权企业的广告店铺唯一标识 | string | — | 必填 | 必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。 |
| 2 | campaigns | 待创建的展示型推广活动列表 | array<object> | — | 必填 | 待创建的展示型推广活动列表;每次提交 1~100 个活动。 最少1项 最多100项 |
| 2.1 | adProduct | adProduct | string | — | 必填 | SPONSORED_DISPLAY 表示展示型推广广告。 |
| 2.2 | budgets | 活动的货币预算列表 | array<object> | — | 必填 | 活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。 最少1项 |
| 2.2.1 | budgetType | MONETARY 表示货币金额预算 | string | — | 必填 | MONETARY 表示货币金额预算。 |
| 2.2.2 | budgetValue | 货币预算值的类型包装对象 | object | — | 必填 | 货币预算值的类型包装对象。 |
| 2.2.2.1 | monetaryBudgetValue | 货币预算金额的包装对象 | object | — | 必填 | 货币预算金额的包装对象。 |
| 2.2.2.1.1 | monetaryBudget | 以广告店铺对应币种计价的预算金额 | object | — | 必填 | 以广告店铺对应币种计价的预算金额;创建时不传币种字段。 |
| 2.2.2.1.1.1 | value | 以广告店铺对应币种计价的预算金额 | number | — | 必填 | 以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。 |
| 2.3 | costType | CPC=按点击计费 | string | — | 必填 | CPC=按点击计费 VCPM=按千次可见展示计费。 |
| 2.4 | countries | 活动投放范围的国家代码列表 | array<any> | — | 可选 | 活动投放范围的国家代码列表,最多一个国家 US 表示美国。 |
| 2.5 | endDateTime | 广告活动结束时间 | string | — | 可选 | 广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。 |
| 2.6 | marketplaceScope | marketplaceScope | string | — | 必填 | SINGLE_MARKETPLACE 表示单站点广告活动。 |
| 2.7 | marketplaces | 活动投放的亚马逊零售站点代码列表 | array<any> | — | 必填 | 活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。 最少1项 |
| 2.8 | name | 用于识别和管理广告活动的名称 | string | — | 必填 | 用于识别和管理广告活动的名称。 |
| 2.9 | portfolioId | 活动所属广告组合的唯一标识 | string | — | 可选 | 活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。 |
| 2.10 | startDateTime | 活动计划开始投放的时间 | string | — | 必填 | 活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。 |
| 2.11 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停。已启用仍需满足开始时间及其他投放条件。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 平台业务状态码 | integer | 0 | 必填 | 平台业务状态码,0 表示成功 |
| 2 | message | 响应消息 | string | success | 必填 | 响应消息 |
| 3 | error_details | 参数校验等错误详情 | array<any> | [] | 必填 | 参数校验等错误详情 |
| 4 | request_id | 请求链路标识 | string | example-request-id | 必填 | 请求链路标识 |
| 5 | response_time | 响应时间 | string | 2026-10-19 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据。 |
| 6.1 | apiResult | 每项结果通过原始下标对应请求中的活动 | array<object> | — | 必填 | 每项结果通过原始下标对应请求中的活动;应检查每项结果码,批量或工具调用可能包含失败项。 |
| 6.1.1 | adProduct | adProduct | string | — | 必填 | SPONSORED_DISPLAY 表示展示型推广广告。 |
| 6.1.2 | budgets | 活动的货币预算列表 | array<object> | — | 必填 | 活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。 |
| 6.1.2.1 | budgetType | MONETARY 表示货币金额预算 | string | — | 必填 | MONETARY 表示货币金额预算。 |
| 6.1.2.2 | budgetValue | 货币预算值的类型包装对象 | object | — | 必填 | 货币预算值的类型包装对象。 |
| 6.1.2.2.1 | monetaryBudgetValue | 货币预算金额的包装对象 | object | — | 必填 | 货币预算金额的包装对象。 |
| 6.1.2.2.1.1 | monetaryBudget | 响应中的预算金额及其币种 | object | — | 必填 | 响应中的预算金额及其币种。 |
| 6.1.2.2.1.1.1 | currencyCode | AED=阿联酋迪拉姆 | 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.2 | value | 以广告店铺对应币种计价的预算金额 | number | — | 必填 | 以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。 |
| 6.1.2.3 | recurrenceTimePeriod | DAILY 表示每日预算 | string | — | 必填 | DAILY 表示每日预算;该字段出现在展示型推广活动的预算响应中,官方创建预算对象未定义此字段。 |
| 6.1.3 | campaignId | 亚马逊创建成功后生成的活动唯一标识 | string | — | 必填 | 亚马逊创建成功后生成的活动唯一标识;以字符串保存,避免长整数精度丢失。 |
| 6.1.4 | costType | CPC=按点击计费 | string | — | 必填 | CPC=按点击计费 VCPM=按千次可见展示计费。 |
| 6.1.5 | countries | 活动投放范围的国家代码列表 | array<any> | — | 必填 | 活动投放范围的国家代码列表,最多一个国家 US 表示美国。 |
| 6.1.6 | creationDateTime | 亚马逊记录的活动创建时间 | string | — | 必填 | 亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。 |
| 6.1.7 | endDateTime | 广告活动结束时间 | string | — | 必填 | 广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。 |
| 6.1.8 | lastUpdatedDateTime | 亚马逊记录的活动最后更新时间 | string | — | 必填 | 亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。 |
| 6.1.9 | marketplaceScope | marketplaceScope | string | — | 必填 | SINGLE_MARKETPLACE 表示单站点广告活动。 |
| 6.1.10 | marketplaces | 活动投放的亚马逊零售站点代码列表 | array<any> | — | 必填 | 活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。 |
| 6.1.11 | name | 用于识别和管理广告活动的名称 | string | — | 必填 | 用于识别和管理广告活动的名称。 |
| 6.1.12 | startDateTime | 活动计划开始投放的时间 | string | — | 必填 | 活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。 |
| 6.1.13 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。 |
| 6.1.14 | code | SUCCESS 表示当前广告活动创建成功 | string | SUCCESS | 必填 | SUCCESS 表示当前广告活动创建成功。 |
| 6.1.15 | index | 对应请求活动数组中的原始下标 | integer | — | 必填 | 对应请求活动数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | 必填 | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
领星ERP的接口:创建 SD 广告活动(/basicOpen/adReport/manage/postSdCampaign),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。