Lingxing
切换旧版

创建 SD 广告组

POST/basicOpen/adReport/manage/postSdAdGroup

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/manage/postSdAdGroupHTTPSPOST1

请求参数

profileIdstring必填
必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
adGroupsarray<object>必填
待创建的展示型推广广告组,单次提交 1~100 项。
最少1项
最多100项
隐藏子属性
adProductstring必填
SPONSORED_DISPLAY 表示展示型推广广告。
bidobject
可选的广告组默认最高竞价配置;金额以广告店铺对应币种计价。
隐藏子属性
defaultBidnumber
广告组内广告和投放目标默认使用的最高竞价金额,以广告店铺对应币种计价。当前服务要求非负;本例响应表示 0.5 美元。
campaignIdstring必填
广告组所属活动的唯一标识,必须属于当前授权店铺;使用数字字符串传递,当前外部接口要求正整数值。
creativeTypestring
IMAGE=图片创意
VIDEO=视频创意。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告组。
marketplacesarray<any>必填
须且仅包含一个站点,范围应与所属活动相同或为其子集
US 表示美国站。
最少1项
namestring必填
用于识别和管理广告组的名称。
optimizationobject
创建时提交的优化配置;本次请求的优化指标为 ADD_TO_CART 加入购物车。
隐藏子属性
goalSettingsobject
广告组期望优化的指标配置。
隐藏子属性
kpistring
ADD_TO_CART=增加加入购物车
APPLICATIONS=增加申请
CHECKOUTS=促进结账
CLICKS=增加点击
CONTACTS=增加联系
LEADS=获取潜客线索
OTHER=优化其他指标
PAGE_VIEWS=增加页面浏览
PURCHASES=促进购买
REACH=扩大触达
SEARCH=促进搜索
SIGN_UP=增加注册
SUBSCRIBE=增加订阅。
statestring必填
ENABLED=已启用
PAUSED=已暂停。实际投放仍取决于所属活动状态、投放时间等条件。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdAdGroup?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "adGroups": [
        {
            "adProduct": "SPONSORED_DISPLAY",
            "campaignId": "1234567890123456",
            "marketplaceScope": "SINGLE_MARKETPLACE",
            "marketplaces": [
                "US"
            ],
            "name": "示例广告",
            "state": "PAUSED"
        }
    ]
}'

返回结果

Json Object

codeinteger必填
平台业务状态码,0 表示成功
示例 0
messagestring必填
响应消息
示例 success
error_detailsarray<any>必填
参数校验等错误详情
示例 []
request_idstring必填
请求链路标识
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-19 12:00:00
dataobject必填
响应数据。
隐藏子属性
apiResultarray<object>必填
每项结果通过原始下标对应请求中的广告组;应检查每项结果码,批量或工具调用可能包含失败项。
隐藏子属性
adGroupIdstring必填
亚马逊创建成功后生成的广告组唯一标识;以字符串保存,避免长整数精度丢失。
adProductstring必填
SPONSORED_DISPLAY 表示展示型推广广告。
bidobject必填
亚马逊返回的默认最高竞价及币种。
隐藏子属性
currencyCodestring必填
AED=阿联酋迪拉姆
AUD=澳大利亚元
BRL=巴西雷亚尔
CAD=加拿大元
CHF=瑞士法郎
CNY=人民币
DKK=丹麦克朗
EGP=埃及镑
EUR=欧元
GBP=英镑
INR=印度卢比
JPY=日元
MXN=墨西哥比索
MXP=墨西哥比索
NGN=尼日利亚奈拉
NOK=挪威克朗
NZD=新西兰元
PLN=波兰兹罗提
SAR=沙特里亚尔
SEK=瑞典克朗
SGD=新加坡元
TRY=土耳其里拉
USD=美元
ZAR=南非兰特。
defaultBidnumber必填
广告组内广告和投放目标默认使用的最高竞价金额,以广告店铺对应币种计价。当前服务要求非负;本例响应表示 0.5 美元。
campaignIdstring必填
广告组所属活动的唯一标识,必须属于当前授权店铺;使用数字字符串传递,当前外部接口要求正整数值。
creationDateTimestring必填
亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
creativeTypestring必填
IMAGE=图片创意
VIDEO=视频创意。
lastUpdatedDateTimestring必填
亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告组。
marketplacesarray<any>必填
须且仅包含一个站点,范围应与所属活动相同或为其子集
US 表示美国站。
namestring必填
用于识别和管理广告组的名称。
optimizationobject必填
本次响应回显的指标为 CLICKS 点击,与请求中的 ADD_TO_CART 加入购物车不同。
隐藏子属性
goalSettingsobject必填
响应中回显的广告组优化指标配置。
隐藏子属性
kpistring必填
ADD_TO_CART=增加加入购物车
APPLICATIONS=增加申请
CHECKOUTS=促进结账
CLICKS=增加点击
CONTACTS=增加联系
LEADS=获取潜客线索
OTHER=优化其他指标
PAGE_VIEWS=增加页面浏览
PURCHASES=促进购买
REACH=扩大触达
SEARCH=促进搜索
SIGN_UP=增加注册
SUBSCRIBE=增加订阅。
statestring必填
ENABLED=已启用
PAUSED=已暂停
ARCHIVED=已永久归档且不可重新启用。
codestring必填
SUCCESS 表示当前广告组创建成功。
示例 SUCCESS
indexinteger必填
对应请求广告组数组中的原始下标,从 0 开始。
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "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
}

附加说明

  • profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
  • 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
  • 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
  • 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
  • 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
  • 上游请求样本使用 ADD_TO_CART,响应回显 CLICKS;不能仅凭创建成功认定请求中的优化指标已生效。