Lingxing
切换旧版

创建 SB 广告

POST/basicOpen/adReport/manage/postSbAds

接口信息

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

请求参数

profileIdstring必填
当前租户已授权的亚马逊广告店铺标识。使用正整数形式的字符串,避免长整数精度丢失。
adsarray<object>必填
待创建的品牌推广广告列表,单次提交 1~10 条。
最少1项
最多10项
隐藏子属性
adGroupIdstring必填
广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
adProductstring必填
SPONSORED_BRANDS 表示品牌推广广告。
adTypestring必填
COMPONENT 表示由视频、图片及商品等组件构成的创意广告。
creativeobject必填
创意类型包装对象;品牌推广使用组件式创意。
隐藏子属性
componentCreativeobject必填
包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
隐藏子属性
autoCollectionSettingsobject
自动生成的商品集,支持设置排除商品和通用配置。
隐藏子属性
productExclusionsarray<object>
自动商品集需排除的商品,最多 1000 项。
隐藏子属性
productIdstring
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
sharedSettingsobject必填
不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosobject
商品集通用配置的品牌标志图片,官方定义为单个素材对象。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
brandGallerySettingsobject
展示品牌及其不同分类和商品集的创意。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosarray<object>必填
广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
最少1项
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
cardsarray<object>
创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。
隐藏子属性
customImageobject
当前卡片展示的图片素材。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
headlinestring
当前创意卡片展示的标题文本。
landingPageobject
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
STORE 表示品牌旗舰店页面。
landingPageUrlstring必填
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
creativePropertiesToOptimizearray<any>
允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
customImagesarray<object>
广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
enableCreativeAutoTranslationboolean
true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
headlinesarray<any>
广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
STORE 表示品牌旗舰店页面。
landingPageUrlstring必填
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
manualCollectionSettingsobject
由广告主指定商品的商品集,包含选入商品、通用配置及落地页。
隐藏子属性
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
ASIN_LIST=以广告推广商品生成的商品列表页
STORE=品牌旗舰店页面。
landingPageUrlstring
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
productInclusionsarray<object>必填
手动商品集展示的商品,须包含 3~10 项。
最少1项
隐藏子属性
productIdstring
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
sharedSettingsobject必填
不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosobject
商品集通用配置的品牌标志图片,官方定义为单个素材对象。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
titlestring
手动商品集的可选标题;未提供时可自动生成。
productCollectionSettingsobject
包含多个商品及自定义图片的品牌推广创意。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosarray<object>必填
广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
最少1项
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
creativePropertiesToOptimizearray<any>
允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
customImagesarray<object>必填
广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
最少1项
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
enableCreativeAutoTranslationboolean
true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
headlinesarray<any>必填
广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
最少1项
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageAsinsobject
落地页为 ASIN_LIST 商品列表页时,用于生成该页面的商品标识列表。
隐藏子属性
asinsarray<any>必填
用于生成商品列表落地页的亚马逊商品标识,包含 1~100 项。
最少1项
landingPageTypestring必填
ASIN_LIST=根据推广商品生成的商品列表页
CUSTOM_URL=自定义落地页,仅供应商账户可用
STORE=品牌旗舰店页面。
landingPageUrlstring
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
productsarray<object>
创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
隐藏子属性
productIdstring
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
productVideoSettingsobject
包含视频素材的品牌推广广告创意。
隐藏子属性
brandstring
广告中展示和推广的品牌名称。
brandLogosarray<object>
广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
enableCreativeAutoTranslationboolean
true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
headlinesarray<any>
广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
landingPageobject
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
DETAIL_PAGE=商品详情页
STORE=品牌旗舰店页面。
landingPageUrlstring
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
productsarray<object>
创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
隐藏子属性
productIdstring
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
videosarray<object>必填
广告使用的视频素材,须且仅包含一项。
最少1项
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
storeSpotlightSettingsobject
通过卡片展示品牌旗舰店中的商品和页面。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosarray<object>必填
广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
最少1项
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>
素材裁剪和定位的属性列表,最多 10 项。
隐藏子属性
heightinteger
裁剪后图片的高度,单位为像素。
leftinteger
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger
裁剪后图片的宽度,单位为像素。
cardsarray<object>必填
创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。
最少1项
隐藏子属性
headlinestring必填
当前创意卡片展示的标题文本。
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
STORE 表示品牌旗舰店页面。
landingPageUrlstring必填
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
productsobject必填
当前品牌旗舰店聚焦卡片关联的商品,官方定义为单个商品对象。
隐藏子属性
productIdstring
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
creativePropertiesToOptimizearray<any>
允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
enableCreativeAutoTranslationboolean
true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
headlinesarray<any>必填
广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
最少1项
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
STORE 表示品牌旗舰店页面。
landingPageUrlstring必填
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
namestring必填
用于识别和管理广告的名称。
statestring必填
ENABLED=已启用
PAUSED=已暂停。已启用仍需满足创意审核、父级状态等投放条件。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAds?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "ads": [
        {
            "adGroupId": "1234567890123456",
            "adProduct": "SPONSORED_BRANDS",
            "adType": "COMPONENT",
            "creative": {
                "componentCreative": {
                    "productCollectionSettings": {
                        "brand": "Example Brand",
                        "brandLogos": [
                            {
                                "assetId": "asset-id-placeholder",
                                "assetVersion": "1"
                            }
                        ],
                        "customImages": [
                            {
                                "assetId": "asset-id-placeholder",
                                "assetVersion": "1"
                            }
                        ],
                        "headlines": [
                            "example"
                        ],
                        "landingPage": {
                            "landingPageType": "STORE",
                            "landingPageUrl": "https://www.amazon.com/stores/example"
                        },
                        "products": [
                            {
                                "productId": "B000000001",
                                "productIdType": "ASIN"
                            },
                            {
                                "productId": "B000000002",
                                "productIdType": "ASIN"
                            },
                            {
                                "productId": "B000000003",
                                "productIdType": "ASIN"
                            }
                        ]
                    }
                }
            },
            "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必填
广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
adIdstring必填
亚马逊创建成功后生成的广告唯一标识;以字符串保存,避免长整数精度丢失。
adProductstring必填
SPONSORED_BRANDS 表示品牌推广广告。
adTypestring必填
COMPONENT 表示由视频、图片及商品等组件构成的创意广告。
campaignIdstring必填
广告所属活动的唯一标识,为只读返回字段。
creationDateTimestring必填
广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。
creativeobject必填
创意类型包装对象;品牌推广使用组件式创意。
隐藏子属性
componentCreativeobject必填
包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
隐藏子属性
productCollectionSettingsobject必填
包含多个商品及自定义图片的品牌推广创意。
隐藏子属性
brandstring必填
广告中展示和推广的品牌名称。
brandLogosarray<object>必填
广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>必填
本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
隐藏子属性
heightinteger必填
裁剪后图片的高度,单位为像素。
leftinteger必填
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger必填
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger必填
裁剪后图片的宽度,单位为像素。
customImagesarray<object>必填
广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
隐藏子属性
assetIdstring必填
素材库中图片或视频素材的唯一标识。
assetVersionstring必填
素材库中该图片或视频对应的版本标识。
formatPropertiesarray<object>必填
本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
隐藏子属性
heightinteger必填
裁剪后图片的高度,单位为像素。
leftinteger必填
从原图左边缘到裁剪起点的距离,单位为像素。
topinteger必填
从原图上边缘到裁剪起点的距离,单位为像素。
widthinteger必填
裁剪后图片的宽度,单位为像素。
headlinesarray<any>必填
广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
landingPageobject必填
用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
隐藏子属性
landingPageTypestring必填
ASIN_LIST=根据推广商品生成的商品列表页
CUSTOM_URL=自定义落地页,仅供应商账户可用
STORE=品牌旗舰店页面。
landingPageUrlstring必填
点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
moderationStatusobject必填
广告创意的审核状态信息。
隐藏子属性
moderationStatusstring必填
APPROVED_WITH_EXCEPTIONS=部分流量审核通过,仅在获准流量投放
PENDING_TRANSLATION=等待创意翻译
PUBLISHED=已通过审核并发布投放
REJECTED_BY_MODERATION=审核拒绝
SUBMITTED_FOR_MODERATION=已提交审核,尚未完成审核。
productsarray<object>必填
创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
隐藏子属性
productIdstring必填
推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
productIdTypestring必填
ASIN 表示亚马逊标准商品标识。
untranslatedHeadlinesarray<any>必填
广告主原始输入、未经过翻译的标题。
lastUpdatedDateTimestring必填
广告最后更新时间,采用带时区的日期时间格式;保留接口返回的时区偏移,不改写为本地时间。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告。
marketplacesarray<any>必填
广告对应的亚马逊零售站点代码列表,范围应与所属广告组相同或为其子集
US 表示美国站。
namestring必填
用于识别和管理广告的名称。
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",
                "adId": "1234567890123456",
                "adProduct": "SPONSORED_BRANDS",
                "adType": "COMPONENT",
                "campaignId": "1234567890123456",
                "creationDateTime": "2026-10-20T00:00:00Z",
                "creative": {
                    "componentCreative": {
                        "productCollectionSettings": {
                            "brand": "Example Brand",
                            "brandLogos": [
                                {
                                    "assetId": "asset-id-placeholder",
                                    "assetVersion": "1",
                                    "formatProperties": [
                                        {
                                            "height": 1,
                                            "left": 1,
                                            "top": 1,
                                            "width": 1
                                        }
                                    ]
                                }
                            ],
                            "customImages": [
                                {
                                    "assetId": "asset-id-placeholder",
                                    "assetVersion": "1",
                                    "formatProperties": [
                                        {
                                            "height": 1,
                                            "left": 1,
                                            "top": 1,
                                            "width": 1
                                        }
                                    ]
                                }
                            ],
                            "headlines": [
                                "example"
                            ],
                            "landingPage": {
                                "landingPageType": "STORE",
                                "landingPageUrl": "https://www.amazon.com/stores/example"
                            },
                            "moderationStatus": {
                                "moderationStatus": "SUBMITTED_FOR_MODERATION"
                            },
                            "products": [
                                {
                                    "productId": "B000000001",
                                    "productIdType": "ASIN"
                                }
                            ],
                            "untranslatedHeadlines": [
                                "example"
                            ]
                        }
                    }
                },
                "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
                "marketplaceScope": "SINGLE_MARKETPLACE",
                "marketplaces": [
                    "US"
                ],
                "name": "示例广告",
                "state": "PAUSED",
                "code": "SUCCESS",
                "index": 0
            }
        ]
    },
    "total": 0
}

附加说明

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