開発者ガイドの概要

Amazon Ads APIの概要

商品コレクション

商品コレクション広告タイプを使用すると、選択したランディングページから商品をプロモーションできます。この広告には、ブランドロゴ、カスタム見出し、3つ以上の商品を掲載できます。Amazonの購入者が商品の画像をクリックすると、商品詳細ページに移動します。購入者がブランドロゴや見出しをクリックすると、ストアまたは指定したカスタムランディングページが表示されます。

詳細については、APIリファレンスをご覧ください。

始める前に

商品コレクション広告を作成するには、次のものを用意しておく必要があります。

クリエイティブの仕様

クリエイティブが承認されるには、一定の要件を満たしている必要があります。ブランドロゴの仕様とカスタム画像の仕様を以下に示します。

ブランドロゴの仕様

| 仕様 | 詳細 | |--- |--- | | 画像サイズ | 400×400ピクセル以上 | | ファイルサイズ | 1MB以下 | | ファイル形式 | PNGまたはJPG | | コンテンツ | ロゴは、画像全体を占めているか、白または透明の背景を使用している必要があります。詳細については、ブランドロゴのクリエイティブ承認ポリシーをご覧ください。 |

カスタム画像の仕様

| 仕様 | 詳細 | |--- |--- | | 画像サイズ | 1200×628ピクセル以上 | | ファイルサイズ | 5MB以下 | | ファイル形式 | PNGまたはJPG | | コンテンツ | 画像にはテキスト、グラフィック、ロゴは追加できません。詳細については、カスタム画像のクリエイティブ承認ポリシーをご覧ください。 |

例

簡易ランディングページ

簡易ランディングページでは、クリエイティブに広告掲載される3つのASINを含む、最大100個の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に設定した場合、これは既存のAmazonストアページを参照します。以下の例に示すように、ストア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 enumは、お取引企業様のみがご利用いただけます。出品者様はこの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を取得する必要があります。クリエイティブオブジェクト内で、カスタム画像のサイズを指定できます。サイズを指定しない場合、カスタム画像のサイズはデフォルトで1200x628ピクセルになります。

注

カスタム画像はオプションであり、商品コレクション広告の作成で必須ではありません。

カスタム画像のサイズの編集を含むリクエストの例：

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