轻易云
注册体验

领星ERP创建 SB 广告接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
广告 / 广告管理 · POST · 请求参数 152 个(必填 69) · 响应参数 51 个 · 限流令牌桶容量 1
更新日期
2026-11-21

创建 SB 广告

POST/basicOpen/adReport/manage/postSbAds
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSbAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAds?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"profileId\": \"1234567890123456\",\n    \"ads\": [\n        {\n            \"adGroupId\": \"1234567890123456\",\n            \"adProduct\": \"SPONSORED_BRANDS\",\n            \"adType\": \"COMPONENT\",\n            \"creative\": {\n                \"componentCreative\": {\n                    \"productCollectionSettings\": {\n                        \"brand\": \"Example Brand\",\n                        \"brandLogos\": [\n                            {\n                                \"assetId\": \"asset-id-placeholder\",\n                                \"assetVersion\": \"1\"\n                            }\n                        ],\n                        \"customImages\": [\n                            {\n                                \"assetId\": \"asset-id-placeholder\",\n                                \"assetVersion\": \"1\"\n                            }\n                        ],\n                        \"headlines\": [\n                            \"example\"\n                        ],\n                        \"landingPage\": {\n                            \"landingPageType\": \"STORE\",\n                            \"landingPageUrl\": \"https://www.amazon.com/stores/example\"\n                        },\n                        \"products\": [\n                            {\n                                \"productId\": \"B000000001\",\n                                \"productIdType\": \"ASIN\"\n                            },\n                            {\n                                \"productId\": \"B000000002\",\n                                \"productIdType\": \"ASIN\"\n                            },\n                            {\n                                \"productId\": \"B000000003\",\n                                \"productIdType\": \"ASIN\"\n                            }\n                        ]\n                    }\n                }\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",
          "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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1profileId当前租户已授权的亚马逊广告店铺标识string—必填当前租户已授权的亚马逊广告店铺标识。使用正整数形式的字符串,避免长整数精度丢失。
2ads待创建的品牌推广广告列表array<object>—必填待创建的品牌推广广告列表,单次提交 1~10 条。 最少1项 最多10项
2.1adGroupId广告所属广告组的唯一标识string—必填广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
2.2adProductadProductstring—必填SPONSORED_BRANDS 表示品牌推广广告。
2.3adTypeadTypestring—必填COMPONENT 表示由视频、图片及商品等组件构成的创意广告。
2.4creative创意类型包装对象object—必填创意类型包装对象;品牌推广使用组件式创意。
2.4.1componentCreative包含具体的创意配置object—必填包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
2.4.1.1autoCollectionSettings自动生成的商品集object—可选自动生成的商品集,支持设置排除商品和通用配置。
2.4.1.1.1productExclusions自动商品集需排除的商品array<object>—可选自动商品集需排除的商品,最多 1000 项。
2.4.1.1.1.1productId推广商品的亚马逊标准商品标识string—可选推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.1.1.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
2.4.1.1.2sharedSettings不同商品集类型共享的品牌配置object—必填不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
2.4.1.1.2.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
2.4.1.1.2.2brandLogos商品集通用配置的品牌标志图片object—可选商品集通用配置的品牌标志图片,官方定义为单个素材对象。
2.4.1.1.2.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.1.2.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.1.2.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.1.2.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.1.2.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.1.2.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.1.2.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.2brandGallerySettings展示品牌及其不同分类和商品集的创意object—可选展示品牌及其不同分类和商品集的创意。
2.4.1.2.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
2.4.1.2.2brandLogos广告使用的品牌标志图片素材array<object>—必填广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.2.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.2.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.2.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.2.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.2.3cards创意中的卡片子元素array<object>—可选创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。
2.4.1.2.3.1customImage当前卡片展示的图片素材object—可选当前卡片展示的图片素材。
2.4.1.2.3.1.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.2.3.1.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.2.3.1.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.3.1.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.2.3.1.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.3.1.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.3.1.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.2.3.2headline当前创意卡片展示的标题文本string—可选当前创意卡片展示的标题文本。
2.4.1.2.3.3landingPage用户点击广告或卡片后到达的页面object—可选用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.2.3.3.1landingPageTypeSTORE 表示品牌旗舰店页面string—必填STORE 表示品牌旗舰店页面。
2.4.1.2.3.3.2landingPageUrl点击广告后到达的页面地址string—必填点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.2.4creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—可选允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.2.5customImages广告展示的自定义图片素材array<object>—可选广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
2.4.1.2.5.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.2.5.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.2.5.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.5.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.2.5.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.5.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.5.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.2.6enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—可选true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.2.7headlines广告主提交的创意标题array<any>—可选广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
2.4.1.2.8landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.2.8.1landingPageTypeSTORE 表示品牌旗舰店页面string—必填STORE 表示品牌旗舰店页面。
2.4.1.2.8.2landingPageUrl点击广告后到达的页面地址string—必填点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.3manualCollectionSettings由广告主指定商品的商品集object—可选由广告主指定商品的商品集,包含选入商品、通用配置及落地页。
2.4.1.3.1landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.3.1.1landingPageTypelandingPageTypestring—必填ASIN_LIST=以广告推广商品生成的商品列表页 STORE=品牌旗舰店页面。
2.4.1.3.1.2landingPageUrl点击广告后到达的页面地址string—可选点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.3.2productInclusions手动商品集展示的商品array<object>—必填手动商品集展示的商品,须包含 3~10 项。 最少1项
2.4.1.3.2.1productId推广商品的亚马逊标准商品标识string—可选推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.3.2.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
2.4.1.3.3sharedSettings不同商品集类型共享的品牌配置object—必填不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
2.4.1.3.3.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
2.4.1.3.3.2brandLogos商品集通用配置的品牌标志图片object—可选商品集通用配置的品牌标志图片,官方定义为单个素材对象。
2.4.1.3.3.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.3.3.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.3.3.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.3.3.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.3.3.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.3.3.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.3.3.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.3.4title手动商品集的可选标题string—可选手动商品集的可选标题;未提供时可自动生成。
2.4.1.4productCollectionSettings包含多个商品及自定义图片的品牌推广创意object—可选包含多个商品及自定义图片的品牌推广创意。
2.4.1.4.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
2.4.1.4.2brandLogos广告使用的品牌标志图片素材array<object>—必填广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.4.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.4.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.4.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.4.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.4.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.4.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.4.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.4.3creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—可选允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.4.4customImages广告展示的自定义图片素材array<object>—必填广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。 最少1项
2.4.1.4.4.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.4.4.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.4.4.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.4.4.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.4.4.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.4.4.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.4.4.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.4.5enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—可选true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.4.6headlines广告主提交的创意标题array<any>—必填广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。 最少1项
2.4.1.4.7landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.4.7.1landingPageAsins落地页为 ASIN_LIST 商品列表页时object—可选落地页为 ASIN_LIST 商品列表页时,用于生成该页面的商品标识列表。
2.4.1.4.7.1.1asins用于生成商品列表落地页的亚马逊商品标识array<any>—必填用于生成商品列表落地页的亚马逊商品标识,包含 1~100 项。 最少1项
2.4.1.4.7.2landingPageTypeASIN_LIST=根据推广商品生成的商品列表页string—必填ASIN_LIST=根据推广商品生成的商品列表页 CUSTOM_URL=自定义落地页,仅供应商账户可用 STORE=品牌旗舰店页面。
2.4.1.4.7.3landingPageUrl点击广告后到达的页面地址string—可选点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.4.8products创意中展示的商品array<object>—可选创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
2.4.1.4.8.1productId推广商品的亚马逊标准商品标识string—可选推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.4.8.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
2.4.1.5productVideoSettings包含视频素材的品牌推广广告创意object—可选包含视频素材的品牌推广广告创意。
2.4.1.5.1brand广告中展示和推广的品牌名称string—可选广告中展示和推广的品牌名称。
2.4.1.5.2brandLogos广告使用的品牌标志图片素材array<object>—可选广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
2.4.1.5.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.5.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.5.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.5.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.5.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.5.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.5.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.5.3enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—可选true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.5.4headlines广告主提交的创意标题array<any>—可选广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
2.4.1.5.5landingPage用户点击广告或卡片后到达的页面object—可选用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.5.5.1landingPageTypeDETAIL_PAGE=商品详情页string—必填DETAIL_PAGE=商品详情页 STORE=品牌旗舰店页面。
2.4.1.5.5.2landingPageUrl点击广告后到达的页面地址string—可选点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.5.6products创意中展示的商品array<object>—可选创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
2.4.1.5.6.1productId推广商品的亚马逊标准商品标识string—可选推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.5.6.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
2.4.1.5.7videos广告使用的视频素材array<object>—必填广告使用的视频素材,须且仅包含一项。 最少1项
2.4.1.5.7.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.5.7.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.6storeSpotlightSettings通过卡片展示品牌旗舰店中的商品和页面object—可选通过卡片展示品牌旗舰店中的商品和页面。
2.4.1.6.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
2.4.1.6.2brandLogos广告使用的品牌标志图片素材array<object>—必填广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.6.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
2.4.1.6.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
2.4.1.6.2.3formatProperties素材裁剪和定位的属性列表array<object>—可选素材裁剪和定位的属性列表,最多 10 项。
2.4.1.6.2.3.1height裁剪后图片的高度integer—可选裁剪后图片的高度,单位为像素。
2.4.1.6.2.3.2left从原图左边缘到裁剪起点的距离integer—可选从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.6.2.3.3top从原图上边缘到裁剪起点的距离integer—可选从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.6.2.3.4width裁剪后图片的宽度integer—可选裁剪后图片的宽度,单位为像素。
2.4.1.6.3cards创意中的卡片子元素array<object>—必填创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。 最少1项
2.4.1.6.3.1headline当前创意卡片展示的标题文本string—必填当前创意卡片展示的标题文本。
2.4.1.6.3.2landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.6.3.2.1landingPageTypeSTORE 表示品牌旗舰店页面string—必填STORE 表示品牌旗舰店页面。
2.4.1.6.3.2.2landingPageUrl点击广告后到达的页面地址string—必填点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.6.3.3products当前品牌旗舰店聚焦卡片关联的商品object—必填当前品牌旗舰店聚焦卡片关联的商品,官方定义为单个商品对象。
2.4.1.6.3.3.1productId推广商品的亚马逊标准商品标识string—可选推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.6.3.3.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
2.4.1.6.4creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—可选允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.6.5enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—可选true=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.6.6headlines广告主提交的创意标题array<any>—必填广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。 最少1项
2.4.1.6.7landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.6.7.1landingPageTypeSTORE 表示品牌旗舰店页面string—必填STORE 表示品牌旗舰店页面。
2.4.1.6.7.2landingPageUrl点击广告后到达的页面地址string—必填点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.5name用于识别和管理广告的名称string—必填用于识别和管理广告的名称。
2.6stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停。已启用仍需满足创意审核、父级状态等投放条件。

接口响应参数

序号字段名称类型默认值必填描述
1code平台业务状态码integer0必填平台业务状态码,0 表示成功
2message响应消息stringsuccess必填响应消息
3error_details参数校验等错误详情array<any>[]必填参数校验等错误详情
4request_id请求链路标识stringexample-request-id必填请求链路标识
5response_time响应时间string2026-10-19 12:00:00必填响应时间
6data响应数据object—必填响应数据。
6.1apiResult每项结果通过原始下标对应请求中的广告array<object>—必填每项结果通过原始下标对应请求中的广告;应检查每项结果码,批量或工具调用可能包含失败项。
6.1.1adGroupId广告所属广告组的唯一标识string—必填广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
6.1.2adId亚马逊创建成功后生成的广告唯一标识string—必填亚马逊创建成功后生成的广告唯一标识;以字符串保存,避免长整数精度丢失。
6.1.3adProductadProductstring—必填SPONSORED_BRANDS 表示品牌推广广告。
6.1.4adTypeadTypestring—必填COMPONENT 表示由视频、图片及商品等组件构成的创意广告。
6.1.5campaignId广告所属活动的唯一标识string—必填广告所属活动的唯一标识,为只读返回字段。
6.1.6creationDateTime广告创建时间string—必填广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。
6.1.7creative创意类型包装对象object—必填创意类型包装对象;品牌推广使用组件式创意。
6.1.7.1componentCreative包含具体的创意配置object—必填包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
6.1.7.1.1productCollectionSettings包含多个商品及自定义图片的品牌推广创意object—必填包含多个商品及自定义图片的品牌推广创意。
6.1.7.1.1.1brand广告中展示和推广的品牌名称string—必填广告中展示和推广的品牌名称。
6.1.7.1.1.2brandLogos广告使用的品牌标志图片素材array<object>—必填广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
6.1.7.1.1.2.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
6.1.7.1.1.2.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
6.1.7.1.1.2.3formatProperties本次实际返回为含 null 元素的数组array<object>—必填本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
6.1.7.1.1.2.3.1height裁剪后图片的高度integer—必填裁剪后图片的高度,单位为像素。
6.1.7.1.1.2.3.2left从原图左边缘到裁剪起点的距离integer—必填从原图左边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.2.3.3top从原图上边缘到裁剪起点的距离integer—必填从原图上边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.2.3.4width裁剪后图片的宽度integer—必填裁剪后图片的宽度,单位为像素。
6.1.7.1.1.3customImages广告展示的自定义图片素材array<object>—必填广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
6.1.7.1.1.3.1assetId素材库中图片或视频素材的唯一标识string—必填素材库中图片或视频素材的唯一标识。
6.1.7.1.1.3.2assetVersion素材库中该图片或视频对应的版本标识string—必填素材库中该图片或视频对应的版本标识。
6.1.7.1.1.3.3formatProperties本次实际返回为含 null 元素的数组array<object>—必填本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
6.1.7.1.1.3.3.1height裁剪后图片的高度integer—必填裁剪后图片的高度,单位为像素。
6.1.7.1.1.3.3.2left从原图左边缘到裁剪起点的距离integer—必填从原图左边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.3.3.3top从原图上边缘到裁剪起点的距离integer—必填从原图上边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.3.3.4width裁剪后图片的宽度integer—必填裁剪后图片的宽度,单位为像素。
6.1.7.1.1.4headlines广告主提交的创意标题array<any>—必填广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
6.1.7.1.1.5landingPage用户点击广告或卡片后到达的页面object—必填用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
6.1.7.1.1.5.1landingPageTypeASIN_LIST=根据推广商品生成的商品列表页string—必填ASIN_LIST=根据推广商品生成的商品列表页 CUSTOM_URL=自定义落地页,仅供应商账户可用 STORE=品牌旗舰店页面。
6.1.7.1.1.5.2landingPageUrl点击广告后到达的页面地址string—必填点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
6.1.7.1.1.6moderationStatus广告创意的审核状态信息object—必填广告创意的审核状态信息。
6.1.7.1.1.6.1moderationStatusmoderationStatusstring—必填APPROVED_WITH_EXCEPTIONS=部分流量审核通过,仅在获准流量投放 PENDING_TRANSLATION=等待创意翻译 PUBLISHED=已通过审核并发布投放 REJECTED_BY_MODERATION=审核拒绝 SUBMITTED_FOR_MODERATION=已提交审核,尚未完成审核。
6.1.7.1.1.7products创意中展示的商品array<object>—必填创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
6.1.7.1.1.7.1productId推广商品的亚马逊标准商品标识string—必填推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
6.1.7.1.1.7.2productIdTypeASIN 表示亚马逊标准商品标识string—必填ASIN 表示亚马逊标准商品标识。
6.1.7.1.1.8untranslatedHeadlines广告主原始输入、未经过翻译的标题array<any>—必填广告主原始输入、未经过翻译的标题。
6.1.8lastUpdatedDateTime广告最后更新时间string—必填广告最后更新时间,采用带时区的日期时间格式;保留接口返回的时区偏移,不改写为本地时间。
6.1.9marketplaceScopemarketplaceScopestring—必填SINGLE_MARKETPLACE 表示单站点广告。
6.1.10marketplaces广告对应的亚马逊零售站点代码列表array<any>—必填广告对应的亚马逊零售站点代码列表,范围应与所属广告组相同或为其子集 US 表示美国站。
6.1.11name用于识别和管理广告的名称string—必填用于识别和管理广告的名称。
6.1.12stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.13codeSUCCESS 表示当前广告创建成功stringSUCCESS必填SUCCESS 表示当前广告创建成功。
6.1.14index对应请求广告数组中的原始下标integer—必填对应请求广告数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0必填统一响应中的总数,本创建接口未设置分页总数,默认为0

领星ERP的接口:创建 SB 广告(/basicOpen/adReport/manage/postSbAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。