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