开发人员指南概述

亚马逊广告 API 概览

视频

这种广告格式可以展示单件商品的视频，并链接到商品详情页或品牌旗舰店。视频广告可以投放在移动设备和桌面设备的购物搜索结果中。

请参阅适用于视频的 API 参考 或适用于品牌视频的 API 参考。

视频与品牌视频格式

如果您的目标是提高转化量和购买量，则可以使用视频资源 来推广单件商品，并将该视频链接到商品详情页。如果您的目标是提高认知度和购买意向，则可以使用品牌视频资源 来推广您的品牌，并将该视频链接到您的品牌旗舰店。

这两种类型的视频广告活动都会展示一个 ASIN 和一个相关的视频。如果您使用品牌旗舰店作为落地页，则广告中展示的 ASIN 也必须展示在您的品牌旗舰店落地页上。否则，落地页将是精选商品的商品详情页面。

前提条件

这两种类型的广告活动都需要以下信息：

视频创意素材组件

所有视频

视频和品牌视频素材均包含精选 ASIN 和视频。

| 素材 | 备注 | |--- |--- | | 精选视频 | 使用素材库上传视频。请参阅视频要求和优秀实践。 | | 精选 ASIN | 确保您的 ASIN 符合条件。 |

品牌视频

链接到品牌旗舰店的视频素材还包含品牌徽标、标题和品牌名称。

| 内容 | 描述 | |--- |--- | | 品牌徽标图片 | 使用素材库上传您的徽标。
图片大小： 400 x 400 像素或更高
文件大小： 1MB 或更小
文件格式： PNG 或 JPG
内容： 徽标必须填满图片或置于白色或透明背景上 | | 标题 | 标题文案应符合亚马逊的广告标准。除日本站点（限制 30 个字符）以外的所有地区的标题最大长度为 50 个字符 | | 品牌名称 | 您的品牌名称将显示在创意素材中。 |

示例

商品详情落地页示例

对于商品详情落地页视频广告活动，您无需指定落地页。亚马逊使用广告中指定的 ASIN，引导点击广告的顾客直接进入该商品详情页。

请参阅适用于视频的 API 参考。

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/video' \
--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' \
--header 'Content-Type: application/json' \
--data '{
"ads": [{
    "name": "Name of the video ad",
    "state": "ENABLED",
    "adGroupId": "{{adGroupId}}",
    "creative": {
        "asins": [
            "B001000000"
        ],
        "videoAssetIds": [
            "amzn1.assetlibrary.asset1.xxxxxx"
        ]
    }
}]
}
'

品牌旗舰店落地页示例

品牌视频需要使用 STORE 作为落地页类型。确保您的创意素材中使用的 ASIN 也展示在品牌旗舰店页面 URL 上。您可以使用 GET /pageAsins 接口 查看页面上所显示的 ASIN。

请参阅适用于品牌视频的 API 参考。

curl --location 'https://advertising-api.amazon.com/sb/v4/ads/brandVideo' \
--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' \
--header 'Content-Type: application/json' \
--data '{
"ads": [{
    "landingPage": {
        "pageType": "STORE",
        "url": "https://www.amazon.com/stores/page/xxxxxx"
    },
    "name": "Name of the video ad",
    "state": "ENABLED",
    "adGroupId": "{{adGroupId}}",
    "creative": {
        "asins": [
            "B001000000"
        ],
        "videoAssetIds": [
            "amzn1.assetlibrary.asset1.xxxxxx"
        ],
        "brandName": "My brand",
        "brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
        "headline": "The headline text of the product in the ad"
    }
}]
}
'
Amazon Advertising logo