バージョン4のスポンサーブランド広告キャンペーンへの移行

概要

スポンサーブランド広告の広告主様は、広告グループを作成して、キャンペーンをより適切に整理および管理できるようになりました。広告グループは、広告をブランド別、キーワード別、商品別、カテゴリー別、広告フォーマット別、ランディングページ別、または広告主様の目標やマーケティング戦略に関連するその他の分類別に、キャンペーンを整理および管理する方法です。ブランドは同じ広告グループ内でさまざまなクリエイティブをテストできるため、広告主様はパフォーマンスを比較し、Amazonの買い物客の行動をよりよく理解することができます。

主なメリット

マーケティング戦略と目標に沿った広告グループを作成して、広告主様に合った方法でキャンペーンを構成できます。
レポートを使用して広告グループキャンペーンのパフォーマンスをモニタリングできます。キーワード、キャンペーンの掲載枠、検索ワード、広告に起因する購入、などに基づくレポートを簡単に取得できます。さらに、キャンペーンタイプごとに個別のレポートを作成したり、スポンサーブランド広告の広告費のパフォーマンスを手動で計算したりする手間を省けます。
ブランドの認知の向上、検討の促進、売上の拡大など、目標に応じてテストを最大限に活用できます。さまざまな広告フォーマットやランディングページに対するターゲティングをテストし、そのパフォーマンスを測定できます。また、同じ広告グループ内で同じ広告フォーマットのさまざまなバージョンをテストすることで、買い物客の行動について理解を深めることもできます。
Amazon Adsのスポンサー広告プロダクト全体で一貫した戦略を使用して、キャンペーンをより効果的に実行できます。広告グループ機能は、スポンサープロダクト広告およびスポンサーディスプレイ広告の両方で利用可能です。

エンドポイントの同等性

バージョン3	バージョン4ベータ版	バージョン4一般提供版
POST /sb/campaigns	POST /sb/beta/campaigns	POST /sb/v4/campaigns
GET /sb/campaigns GET /sb/campaigns/{campaignId}	POST /sb/beta/campaigns/list	POST /sb/v4/campaigns/list
PUT /sb/campaigns	-	PUT /sb/v4/campaigns
DELETE /sb/campaigns/{campaignId}	-	POST /sb/v4/campaigns/delete
GET /sb/adGroups GET /sb/adGroups/{adGroupId}	POST /sb/beta/adGroups/list	POST /sb/v4/adGroups/list
-	POST /sb/beta/adGroups	POST /sb/v4/adGroups
-	POST /sb/beta/adGroups/delete	POST /sb/v4/adGroups/delete
-	PUT /sb/beta/adGroups	PUT /sb/v4/adGroups
-	POST /sb/beta/ads/list	POST /sb/v4/ads/list
-	POST /sb/beta/ads/video	POST /sb/v4/ads/video
-	POST /sb/beta/ads/brandVideo	POST /sb/v4/ads/brandVideo
-	POST /sb/beta/ads/productCollection	POST /sb/v4/ads/productCollection
-	POST /sb/beta/ads/storeSpotlight	POST /sb/v4/ads/storeSpotlight
-	PUT /sb/beta/ads	PUT /sb/v4/ads
-	POST /sb/beta/ads/delete	POST /sb/v4/ads/delete

よくある質問

ベータ版エンドポイントから一般提供エンドポイントへの移行にはどれくらいの時間がかかりますか？

バージョン4のベータ版エンドポイントは2023年8月31日まで利用できます。8月31日以降、ベータ版エンドポイントを使用したリクエストコールはすべて拒否されます。

詳細については、「廃止予定」を参照してください。

バージョン4ベータ版エンドポイントと一般公開エンドポイントに違いはありますか？

いいえ。バージョン4の一般提供とオープンベータ版エンドポイントの間には、機能上または契約上の変更はありません。

複数の広告グループによるキャンペーンは、現在のキャンペーン構造とどのように違うのですか？

現在のキャンペーンエンドポイントでは、広告グループを作成または更新したり、広告クリエイティブを広告グループに関連付けることはできません。現在のキャンペーンには読み取り専用の広告グループが含まれており、クリエイティブは広告グループではなくキャンペーンに関連付けられています。

このガイドでは、複数の広告グループをサポートしていない現在のキャンペーンを従来のキャンペーンと呼び、複数の広告グループをサポートしているキャンペーンを複数の広告グループによるキャンペーンと呼びます。新しい複数の広告グループによるキャンペーンには、キャンペーン、広告グループ、広告の3つのエンティティが含まれています。キャンペーンの階層を理解するには、下の図を参照してください。

キャンペーン：キャンペーンでは、広告の予算および日付ごとに広告がグループ化されます。
**広告グループ：**広告グループを使用すると、ブランド、キーワード、商品、カテゴリー、広告フォーマット、ランディングページ、または目標に合ったその他の分類別に広告を整理して管理できます。
**広告：**広告を使用して、さまざまなクリエイティブのバリエーションを管理できます。ランディングページは同じでも、ASIN、見出し、ライフスタイル画像、商品カテゴリー、動画が異なる複数の広告を各広告グループに関連付けます。

キャンペーンエンティティの図

複数の広告グループによるキャンペーンをサポートするには、どのようなAPI変更が必要ですか？

スポンサーブランド広告キャンペーン管理APIの最新バージョンに移行することをおすすめします。これらは現在一般公開されています。新しいバージョンでは、広告主様は複数の広告グループによるキャンペーンを作成および管理できるだけでなく、以前に作成したスポンサーブランド広告キャンペーンを読み込むことができます。リストキャンペーンレスポンスには、新しいフィールドisMultiAdGroupsEnabledが含まれています。これは、キャンペーンが最新バージョンで構築されている場合にtrueを返します。

新しいエンドポイントの使用手順と使用例については、「複数の広告グループによるキャンペーンの作成チュートリアル」を参照してください。

注

既存のバージョン3のGETキャンペーンエンドポイントは、複数の広告グループによるキャンペーンから最初の広告グループと広告を返します。利用可能なすべての広告グループと広告を表示するには、新しいリストキャンペーンのエンドポイントを使用する必要があります。

既存のバージョン3のGETキャンペーンエンドポイントを使用すると、どのような影響がありますか？

現在のバージョン3のGETエンドポイントでは、複数の広告グループによるキャンペーンのサポートが制限されています。GETレスポンスには、複数の広告グループによるキャンペーンからの最初のクリエイティブのみが含まれます。

バージョン3.3のGETキャンペーンエンドポイントを使用している場合、レスポンスにはオプションのフィールドとしてisMultiAdGroupsEnabled、adGroupCount、adCountが含まれます。これらのフィールドは、キャンペーンが複数の広告グループで有効になっているかどうか、およびキャンペーン内の広告グループと広告の数を判断するのに役立ちます。すべてのキャンペーンタイプのキャンペーンレベルの詳細を取得するには、バージョン4のキャンペーンリストエンドポイントを使用することをおすすめします。

警告

バージョン3.3のGETキャンペーンエンドポイントでは、ブランド動画広告を返しません。ブランド動画広告のクリエイティブの詳細を取得するには、バージョン4POST sb/v4/ads/listエンドポイントを使用します。

注

バージョン3のGETキャンペーン呼び出しで広告フォーマットやクリエイティブタイプのフィルターを使用している場合、レスポンスには複数の広告グループによるキャンペーンは含まれません。バージョン4のキャンペーンでは、広告フォーマットとクリエイティブタイプのフィルターは、キャンペーンエンティティではなく広告エンティティに属します。

警告

広告コンソールは2022年9月に新しいキャンペーンタイプに切り替わります。広告コンソールで作成されたキャンペーンの詳細をすべて取得するには、新しいPOST /sb/v4/campaigns/list endpointエンドポイントを使用する必要があります。また、コンソールで作成されたキャンペーンのデータを取得するために、レポートでcreativeTypeフィルターをallに設定する必要があります。

従来のキャンペーンに複数の広告グループを追加できますか？

従来のキャンペーンに新しい広告グループを追加することはできません。これらのキャンペーンの広告グループはGET操作のみをサポートします。広告グループの作成と管理は、新しいバージョン4のエンドポイントによる新しい複数の広告グループによるキャンペーンでのみサポートされます。バージョン4のエンドポイントを使用して従来の広告グループを更新しようとすると、INVALID_ARGUMENTエラーが発生します。

複数の広告グループによるキャンペーンを更新するまたは非表示にするにはどうすればよいですか？

PUTエンドポイントとDELETEエンドポイントは、バージョン4のキャンペーン管理APIから利用できます。

注

POST sb/v4/adGroups/listエンドポイントの**NameFilter**は、従来のキャンペーンでは機能しません。広告グループ名がキャンペーン名に基づいて自動生成されるためです。従来のキャンペーンにはこのフィルターを使用しないことをお勧めします。

詳細については、「複数の広告グループによるキャンペーンの管理ガイド」をご覧ください。

レポーティングAPIを使用してレポートデータを取得するには、どのような変更が必要ですか？

複数の広告グループによるキャンペーンのレポートデータを取得するには、レポートリクエストの一部として"creativeType": "all"を含める必要があります。このフィルターを使用したレポートは、複数の広告グループによるキャンペーンと従来のキャンペーンの両方のレポートデータを返します。

注

このフィルターを使用しない場合、レポートには複数の広告グループによるキャンペーンに関連するデータは含まれません。

広告レポートでは、複数の広告グループによるキャンペーンがadId指標をサポートしているため、広告のパフォーマンスを追跡できます。従来のキャンペーンでは、広告レポートにadIdは表示されません。

ターゲティングAPIやレコメンデーションAPIに影響はありますか？

ターゲットエンドポイントや推奨エンドポイントに変更はありません。既存のエンドポイントは、すべてのタイプのキャンペーンに対応しています。新しいキャンペーンでは、キーワードのモデレーションは行われません。キーワードは、広告グループに追加されるとすぐに有効になります。

広告クリエイティブの審査に変更はありますか？

複数の広告グループによるキャンペーンの場合、広告ポリシーでは広告のみが審査されます。広告ポリシー違反が原因で広告が却下されても、キャンペーンステータスは変わりません。従来のキャンペーンでは、クリエイティブはキャンペーンにリンクされていました。そのため、広告ポリシーによってクリエイティブが却下された場合、キャンペーンステータスが却下済みに変わります。モデレーションAPIを使用して、広告の審査の状況を確認できます。

注

新しいキャンペーンでは、アクティブな広告が1つあれば、引き続きインプレッションを獲得できます。

どの広告フォーマットがサポートされていますか？

新しいAPIは、商品コレクション、ストアスポットライト、動画、ブランド動画の広告フォーマットをサポートします。新しい広告フォーマットであるブランド動画を利用して、ブランド動画をストアページにリンクできます。

警告

既存のバージョン3のAPIでは、ブランド動画広告を作成、更新、取得することはできません。

複数の広告グループによるキャンペーンは、スナップショットに含まれますか？

いいえ。バージョン4のエンドポイントを使用して作成されたキャンペーンはスナップショットに含まれません。

バージョン4のクリエイティブに変更はありますか？

はい。アセットライブラリAPIを使用して、動画と画像の両方のクリエイティブをアップロードし、assetIdを生成する必要があります。その後、広告を作成するときにそのassetIdを使用できます。

バージョン3のキャンペーンの一部として作成された広告にはadIdがありますか？

いいえ。バージョン3のキャンペーンの一部として作成された広告には、関連するadIdもnameもありません。詳細については、広告の管理をご覧ください。

POST sb/v4/ads/listおよびGET sb/campaignsで、一部のクリエイティブのフィールドが欠落しているのはなぜですか？

一部の広告主様では、古いクリエイティブでクリエイティブレベルのフィールドが欠落するという既知の問題が発生しています。クリエイティブレベルのすべてのフィールドを受け取るには、より新しいバージョンのクリエイティブアセットをアップロードすることをおすすめします。

従来のキャンペーンのバージョン4でキャンペーンの`state`が`ENABLED`と表示されるのはなぜですか？

従来のキャンペーンのキャンペーンstateは、バージョン3とバージョン4のGETキャンペーンエンドポイントからの応答で異なります。バージョン3のキャンペーン状態には、ユーザーが実行したアクションとキャンペーンの配信ステータスの組み合わせが含まれます。バージョン4のGETレスポンスでは、従来のキャンペーンと複数の広告グループによるキャンペーンの状態管理が標準化されました。キャンペーンのstateフィールドはユーザーアクションを表し、拡張データフィールドのキャンペーンservingStatusはキャンペーンの配信状態を判別するのに役立ちます。このアプローチは、スポンサープロダクト広告キャンペーンやスポンサーディスプレイ広告キャンペーンの状態管理と似ています。従来のキャンペーンと同様の状態レスポンスを維持したい場合は、キャンペーンの状態とキャンペーンサービスのステータスを組み合わせて使用することをおすすめします。

詳細はこちら

2023年6月の更新

概要

すべてのスポンサー広告プログラム間で一貫性を保つために、スポンサーブランド広告では、従来のバージョン3のAPI用のバックエンドデータストレージを変更しています。スポンサーブランド広告バージョン3のキャンペーン管理APIは、バージョン4の複数の広告グループによるキャンペーン構造を使用して、新しいキャンペーンと下書きを作成するようになりました。APIコントラクトやリクエスト/レスポンスのオブジェクトの変更はありません。バージョン3のキャンペーン管理APIはすべて、引き続き変更なしで予期されるとおりに機能します。

影響を受けるのは誰ですか？

現在、スポンサーブランド広告（SB）の従来のバージョン3のAPIを使用してキャンペーンや下書きを作成している広告主様、代理店、ツールプロバイダー。この変更は現在、米国マーケットプレイスのキャンペーンで展開されています。今後数ヶ月のうちに、米国外でも変更を展開していく予定です。

どのような影響がありますか？

このような変更をAmazonが導入した理由

Amazonのスポンサー広告プログラムはすべて、業界標準の広告グループデータ構造を使用する共通のドメインモデルに移行しています。この変更により、広告主様は従来のバージョン3とバージョン4のAPIをまたいで、標準的なエクスペリエンスを新しいキャンペーンに利用できるようになります。5月23日以降に作成された新しいキャンペーンは、広告グループキャンペーン構造であるため、バージョン3とバージョン4の両方のキャンペーン管理に対応しています。

Amazon広告コンソールのエクスペリエンスに影響はありますか？

今後は、広告コンソールに、複数の広告グループの形式でキャンペーンが表示されることになります。キャンペーン、広告グループ、広告の階層を掘り下げていくことができます。これらのワークフローと情報カードは、2022年10月から広告コンソールで利用できるようになりました。すでに広告コンソールを使用してキャンペーンを作成している場合は、バージョン3のAPIを使用して作成されたキャンペーンでも同じ動作が見られるようになります。

以下のスクリーンショットには、従来のキャンペーンのキャンペーン詳細ページが示されています。この画面には広告グループ機能はありません。

従来のキャンペーンのコンソール

下の画像は、複数の広告グループによるキャンペーンのキャンペーン詳細ページの例です。画面上の広告グループの機能が強調されています

新しいキャンペーンのコンソール

Amazon広告コンソールで追加の広告グループや広告を作成した場合はどうなりますか？

バージョン3のAPIを使用して作成したキャンペーンに追加の広告グループまたは広告を作成した場合は、最初の広告グループのみが表示されます。他の広告グループや広告がキャンペーンに存在していても、バージョン3のAPIではそれらは表示されません。スポンサーブランド広告の従来のバージョン3のAPIに新機能が追加されることはありません。新機能を利用したり、複数の広告グループ形式のキャンペーンを作成したりするために、パートナー様にはスポンサーブランド広告バージョン4のAPIに移行することをおすすめします。

レポーティングAPIを使用してレポートデータを取得するには、どのような変更が必要ですか？

レポートへの影響はありません。広告コンソール、一括シート、従来のバージョン3のAPI、およびバージョン4のAPIを使用して作成されたすべてのキャンペーンのパフォーマンスデータが、バージョン2のレポートAPIに含められます。

広告クリエイティブの審査に変更はありますか？

従来のキャンペーンでは、クリエイティブがキャンペーンにリンクされていたので、広告ポリシーでクリエイティブが却下された場合は、キャンペーン全体のステータスが却下に変更されていました。新しい広告グループベースのキャンペーンでは、個々の広告の広告ポリシーへの準拠性が審査されます。広告グループ階層内のいずれかの広告が却下された場合でも、キャンペーンのステータスは変わりません。モデレーションAPIを使用して、広告の審査の状況を確認できます。

複数の広告グループによるキャンペーンはスナップショットに含まれますか？

スナップショットでは、広告グループベースのキャンペーンはまだサポートされていません。当社は、バージョン4のキャンペーンをスナップショットでサポートする予定です。

お困りですか？

応答時間が改善される以外に、レスポンスに変化はないはずです。レスポンスに問題がある場合は、開発者サポートチケットを開いてください。

開発者ガイドの概要

Amazon Ads APIの概要

バージョン4のスポンサーブランド広告キャンペーンへの移行

概要

主なメリット

エンドポイントの同等性

よくある質問

ベータ版エンドポイントから一般提供エンドポイントへの移行にはどれくらいの時間がかかりますか？

バージョン4ベータ版エンドポイントと一般公開エンドポイントに違いはありますか？

複数の広告グループによるキャンペーンは、現在のキャンペーン構造とどのように違うのですか？

複数の広告グループによるキャンペーンをサポートするには、どのようなAPI変更が必要ですか？

注

既存のバージョン3のGETキャンペーンエンドポイントを使用すると、どのような影響がありますか？

警告

注

警告

従来のキャンペーンに複数の広告グループを追加できますか？

複数の広告グループによるキャンペーンを更新するまたは非表示にするにはどうすればよいですか？

注

レポーティングAPIを使用してレポートデータを取得するには、どのような変更が必要ですか？

注

ターゲティングAPIやレコメンデーションAPIに影響はありますか？

広告クリエイティブの審査に変更はありますか？

注

どの広告フォーマットがサポートされていますか？

警告

複数の広告グループによるキャンペーンは、スナップショットに含まれますか？

バージョン4のクリエイティブに変更はありますか？

バージョン3のキャンペーンの一部として作成された広告にはadIdがありますか？

POST sb/v4/ads/listおよびGET sb/campaignsで、一部のクリエイティブのフィールドが欠落しているのはなぜですか？

従来のキャンペーンのバージョン4でキャンペーンのstateがENABLEDと表示されるのはなぜですか？

詳細はこちら

2023年6月の更新

概要

影響を受けるのは誰ですか？

どのような影響がありますか？

このような変更をAmazonが導入した理由

Amazon広告コンソールのエクスペリエンスに影響はありますか？

Amazon広告コンソールで追加の広告グループや広告を作成した場合はどうなりますか？

レポーティングAPIを使用してレポートデータを取得するには、どのような変更が必要ですか？

広告クリエイティブの審査に変更はありますか？

複数の広告グループによるキャンペーンはスナップショットに含まれますか？

お困りですか？

従来のキャンペーンのバージョン4でキャンペーンの`state`が`ENABLED`と表示されるのはなぜですか？