開発者ガイドの概要

Amazon Ads APIの概要

動画

この広告フォーマットでは、商品詳細ページやブランドストアにリンクしている単一商品の動画を掲載できます。動画広告は、商品検索結果のモバイル掲載枠とデスクトップ掲載枠で利用できます。

動画のAPIリファレンスまたはブランド動画のAPIリファレンスをご覧ください。

動画フォーマットとブランド動画フォーマットの違い

コンバージョンと購入を促進することが目標の場合は、動画リソースを使用して単一商品を宣伝し、その動画を商品詳細ページにリンクします。認知度を高め、より多くの人に購入の検討を促すことが目標の場合は、ブランド動画リソースを使用してブランドを宣伝し、その動画をストアにリンクします。

どちらのタイプの動画キャンペーンでも、1つのASINとそれに関連する動画が掲載されます。ストアをランディングページとして使用している場合は、クリエイティブでおすすめするASINをストアのランディングページにも掲載する必要があります。そうでない場合は、ランディングページはおすすめ商品の商品詳細ページになります。

始める前に

どちらのタイプのキャンペーンでも、次の情報が必要です。

動画クリエイティブコンポーネント

すべての動画

動画クリエイティブとブランド動画クリエイティブのいずれにも、おすすめのASINと動画が含まれています。

| アセット | 注記 | |--- |--- | | おすすめの動画 | クリエイティブアセットライブラリを使用して動画をアップロードします。動画の要件とベストプラクティスをご覧ください。 | | おすすめのASIN | ASINに利用資格があることを確認します。 |

ブランド動画

ブランドストアにリンクする動画クリエイティブには、ブランドロゴ、見出し、ブランド名も含まれます。

| コンテンツ | 説明 | |--- |--- | | ブランドロゴ画像 | クリエイティブアセットライブラリを使用してロゴをアップロードします。
画像サイズ: 400 x 400 px以上
ファイルサイズ: 1MB以下
ファイル形式: PNGまたはJPG
コンテンツ: ロゴは、画像全体を占めているか、白または透明の背景を使用している必要があります | | 見出し | 見出しの文章は、Amazon Advertisingの基準を満たしている必要があります。日本を除くすべての地域で、最大長は50文字です(日本は30文字)。 | | ブランド名 | ブランドの名前がクリエイティブに表示されます。 |

**商品詳細ランディングページの例 **

商品詳細ランディングページの動画キャンペーンでは、ランディングページを指定する必要はありません。広告をクリックしたお客様には、クリエイティブで指定されている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にも表示されることを確認してください。ページにどのASINが表示されるかを確認するには、GET /pageAsinsエンドポイントを使用します。

ブランド動画の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"
    }
}]
}
'