开发人员指南概述

亚马逊广告 API 概览

商品集

借助商品集广告类型，您可以通过自己选择的落地页推广您的商品。此类广告可以展示您的品牌徽标、自定义标题以及三种或更多种商品。亚马逊顾客在点击商品图片后会进入相应的商品详情页。点击品牌徽标或标题后，顾客将进入您的品牌旗舰店或您指定的自定义落地页。

有关更多详情，请参阅API 参考。

前提条件

在创建商品集广告之前，您必须具备以下条件：

创意素材规范

创意素材必须满足一定的要求才能被接受。以下是品牌徽标和自定义图片的规范。

品牌徽标规范

| 规范 | 详细信息 | |--- |--- | | 图片大小 | 400x400 像素或更大 | | 文件大小 | 1MB 或更小 | | 文件格式 | PNG 或 JPG | | 内容 | 徽标必须填满图片或置于白色或透明背景上。如需了解更多信息，请访问品牌徽标创意素材接受政策。 |

自定义图片规范

| 规范 | 详细信息 | |--- |--- | | 图片大小 | 1200x628 像素或更大 | | 文件大小 | 5MB 或更小 | | 文件格式 | PNG 或 JPG | | 内容 | 图片中未添加任何文本、图形或徽标。如需了解更多信息，请访问自定义图片创意素材接受政策。 |

示例

简单落地页

一个简单的落地页最多支持 100 个 ASIN，包括创意素材中的三个推广的 ASIN。如果您希望获得一个简单的落地页，请将 pageType 设置为 PRODUCT_LIST，并在落地页对象上添加 ASIN 列表，如下例所示：

请求体示例： PRODUCT_LIST

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/productCollection' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxx' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--data '{
"ads": [{
    "landingPage": {
        "asins": [
            "B001000000",
            "B020000000",
            "B000000000"
        ],
        "pageType": "PRODUCT_LIST"
    },
    "name": "Name of product collection ad",
    "state": "ENABLED",
    "adGroupId": "{{adgroupId}}",
    "creative": {
        "brandLogoCrop": {
            "top": 0,
            "left": 0,
            "width": 400,
            "height": 400
        },
        "asins": [
            "B001000000",
            "B020000000",
            "B000000000"
        ],
        "brandName": "Name of the brand",
        "customImageAssetId": "amzn1.assetlibrary.asset1.xxxxxx",
        "brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxxx",
        "headline": "The headline text of the products in the ad"
    }
}]
}
'

品牌旗舰店

如果您将 pageType 设置为 STORE，则将引用现有的亚马逊站点页面。站点 URL 必须包含在落地页对象中，如下例所示。进一步了解品牌旗舰店。

请求体示例： STORE

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/productCollection' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxx' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--data '{
"ads": [{
    "landingPage": {
        "pageType": "STORE",
        "url": "https://www.amazon.com/stores/page/xxxxxx"
    },
    "name": "Name of product collection ad",
    "state": "ENABLED",
    "adGroupId": "{{adGroupId}}",
    "creative": {
        "brandLogoCrop": {
            "top": 0,
            "left": 0,
            "width": 400,
            "height": 400
        },
        "asins": [
            "B000000000",
            "B020000000",
            "B001000000"
        ],
        "brandName": "Name of the brand",
        "customImageAssetId": "amzn1.assetlibrary.asset1.xxxxxx",
        "brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
        "headline": "The headline text of the products in the ad"
    }
}]
}
'

自定义 URL

如果您是供应商并且拥有自定义落地页，则可以将 pageType 设置为 CUSTOM_URL。落地页必须包含广告活动中推广的至少 3 件商品的 ASIN。

注意

只有供应商才能使用 CUSTOM_URL 枚举。此 pageType 不适用于卖家。

请求体示例： CUSTOM_URL

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/productCollection' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxx' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--header 'Content-Type: application/json' \
--data '{
"ads": [{
    "landingPage": {
        "pageType": "CUSTOM_URL",
        "url": "https://www.amazon.com/stores/page/xxxxxx"
    },
    "name": "Name of product collection ad",
    "state": "ENABLED",
    "adGroupId": "{{adGroupId}}",
    "creative": {
        "brandLogoCrop": {
            "top": 0,
            "left": 0,
            "width": 400,
            "height": 400
        },
        "asins": [
            "B001000000",
            "B020000000",
            "B000000000"
        ],
        "brandName": "Name of the brand",
        "customImageAssetId": "amzn1.assetlibrary.asset1.xxxxxx",
        "brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
        "headline": "The headline text of the products in the ad"
    }
}]
}
'

自定义图片

要添加自定义图片，必须首先使用素材库 API 来获取 assetId。在创意素材对象中，您可以指定自定义图片的尺寸。如果您未指定尺寸，则自定义图片的将默认采用 1200 x 628 像素的图片尺寸。

注意

自定义图片可选，并不是创建商品集广告所必需的素材。

具有自定义图片裁剪尺寸的请求示例：

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/productCollection' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxx' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--header 'Content-Type: application/json' \
--data '{
"ads": [{
    "landingPage": {
        "asins": [
            "B000000000",
            "B020000000",
            "B001000000"
        ],
        "pageType": "PRODUCT_LIST"
    },
    "name": "Name of product collection ad",
    "state": "ENABLED",
    "adGroupId": "{{adGroupId}}",
    "creative": {
        "brandLogoCrop": {
            "top": 0,
            "left": 0,
            "width": 410,
            "height": 410
        },
        "asins": [
            "B000000000",
            "B001000000",
            "B020000000"
        ],
        "brandName": "Name of the brand",
        "customImageAssetId": "amzn1.assetlibrary.asset1.xxxxxx",
        "customImageCrop": {
            "top": 0,
            "left": 0,
            "width": 1200,
            "height": 630
        },
        "brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
        "headline": "The headline text of the products in the ad"
    }
}]
}
'
Amazon Advertising logo