/basicOpen/adReport/manage/postSdAdGroup{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/postSdAdGroup"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdAdGroup?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"profileId\": \"1234567890123456\",\n \"adGroups\": [\n {\n \"adProduct\": \"SPONSORED_DISPLAY\",\n \"campaignId\": \"1234567890123456\",\n \"marketplaceScope\": \"SINGLE_MARKETPLACE\",\n \"marketplaces\": [\n \"US\"\n ],\n \"name\": \"示例广告\",\n \"state\": \"PAUSED\"\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": [
{
"adGroupId": "1234567890123456",
"adProduct": "SPONSORED_DISPLAY",
"bid": {
"currencyCode": "USD",
"defaultBid": 1
},
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"creativeType": "IMAGE",
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"name": "示例广告",
"optimization": {
"goalSettings": {
"kpi": "CLICKS"
}
},
"state": "PAUSED",
"code": "SUCCESS",
"index": 0
}
]
},
"total": 0
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | profileId | 必须属于当前授权企业的广告店铺唯一标识 | string | — | Required | 必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。 |
| 2 | adGroups | 待创建的展示型推广广告组 | array<object> | — | Required | 待创建的展示型推广广告组,单次提交 1~100 项。 最少1项 最多100项 |
| 2.1 | adProduct | adProduct | string | — | Required | SPONSORED_DISPLAY 表示展示型推广广告。 |
| 2.2 | bid | 可选的广告组默认最高竞价配置 | object | — | Optional | 可选的广告组默认最高竞价配置;金额以广告店铺对应币种计价。 |
| 2.2.1 | defaultBid | 广告组内广告和投放目标默认使用的最高竞价金额 | number | — | Optional | 广告组内广告和投放目标默认使用的最高竞价金额,以广告店铺对应币种计价。当前服务要求非负;本例响应表示 0.5 美元。 |
| 2.3 | campaignId | 广告组所属活动的唯一标识 | string | — | Required | 广告组所属活动的唯一标识,必须属于当前授权店铺;使用数字字符串传递,当前外部接口要求正整数值。 |
| 2.4 | creativeType | IMAGE=图片创意 | string | — | Optional | IMAGE=图片创意 VIDEO=视频创意。 |
| 2.5 | marketplaceScope | marketplaceScope | string | — | Required | SINGLE_MARKETPLACE 表示单站点广告组。 |
| 2.6 | marketplaces | 须且仅包含一个站点 | array<any> | — | Required | 须且仅包含一个站点,范围应与所属活动相同或为其子集 US 表示美国站。 最少1项 |
| 2.7 | name | 用于识别和管理广告组的名称 | string | — | Required | 用于识别和管理广告组的名称。 |
| 2.8 | optimization | 创建时提交的优化配置 | object | — | Optional | 创建时提交的优化配置;本次请求的优化指标为 ADD_TO_CART 加入购物车。 |
| 2.8.1 | goalSettings | 广告组期望优化的指标配置 | object | — | Optional | 广告组期望优化的指标配置。 |
| 2.8.1.1 | kpi | ADD_TO_CART=增加加入购物车 | string | — | Optional | ADD_TO_CART=增加加入购物车 APPLICATIONS=增加申请 CHECKOUTS=促进结账 CLICKS=增加点击 CONTACTS=增加联系 LEADS=获取潜客线索 OTHER=优化其他指标 PAGE_VIEWS=增加页面浏览 PURCHASES=促进购买 REACH=扩大触达 SEARCH=促进搜索 SIGN_UP=增加注册 SUBSCRIBE=增加订阅。 |
| 2.9 | 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 | adGroupId | 亚马逊创建成功后生成的广告组唯一标识 | string | — | Required | 亚马逊创建成功后生成的广告组唯一标识;以字符串保存,避免长整数精度丢失。 |
| 6.1.2 | adProduct | adProduct | string | — | Required | SPONSORED_DISPLAY 表示展示型推广广告。 |
| 6.1.3 | bid | 亚马逊返回的默认最高竞价及币种 | object | — | Required | 亚马逊返回的默认最高竞价及币种。 |
| 6.1.3.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.3.2 | defaultBid | 广告组内广告和投放目标默认使用的最高竞价金额 | number | — | Required | 广告组内广告和投放目标默认使用的最高竞价金额,以广告店铺对应币种计价。当前服务要求非负;本例响应表示 0.5 美元。 |
| 6.1.4 | campaignId | 广告组所属活动的唯一标识 | string | — | Required | 广告组所属活动的唯一标识,必须属于当前授权店铺;使用数字字符串传递,当前外部接口要求正整数值。 |
| 6.1.5 | creationDateTime | 亚马逊记录的广告组创建时间 | string | — | Required | 亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.6 | creativeType | IMAGE=图片创意 | string | — | Required | IMAGE=图片创意 VIDEO=视频创意。 |
| 6.1.7 | lastUpdatedDateTime | 亚马逊记录的广告组最后更新时间 | string | — | Required | 亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.8 | marketplaceScope | marketplaceScope | string | — | Required | SINGLE_MARKETPLACE 表示单站点广告组。 |
| 6.1.9 | marketplaces | 须且仅包含一个站点 | array<any> | — | Required | 须且仅包含一个站点,范围应与所属活动相同或为其子集 US 表示美国站。 |
| 6.1.10 | name | 用于识别和管理广告组的名称 | string | — | Required | 用于识别和管理广告组的名称。 |
| 6.1.11 | optimization | 本次响应回显的指标为 CLICKS 点击 | object | — | Required | 本次响应回显的指标为 CLICKS 点击,与请求中的 ADD_TO_CART 加入购物车不同。 |
| 6.1.11.1 | goalSettings | 响应中回显的广告组优化指标配置 | object | — | Required | 响应中回显的广告组优化指标配置。 |
| 6.1.11.1.1 | kpi | ADD_TO_CART=增加加入购物车 | string | — | Required | ADD_TO_CART=增加加入购物车 APPLICATIONS=增加申请 CHECKOUTS=促进结账 CLICKS=增加点击 CONTACTS=增加联系 LEADS=获取潜客线索 OTHER=优化其他指标 PAGE_VIEWS=增加页面浏览 PURCHASES=促进购买 REACH=扩大触达 SEARCH=促进搜索 SIGN_UP=增加注册 SUBSCRIBE=增加订阅。 |
| 6.1.12 | state | ENABLED=已启用 | string | — | Required | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。 |
| 6.1.13 | code | SUCCESS 表示当前广告组创建成功 | string | SUCCESS | Required | SUCCESS 表示当前广告组创建成功。 |
| 6.1.14 | index | 对应请求广告组数组中的原始下标 | integer | — | Required | 对应请求广告组数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | Required | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
The 创建 SD 广告组 API (/basicOpen/adReport/manage/postSdAdGroup) 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.