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