リクエストの構成

このガイドでは、P-MAX キャンペーンを作成、更新するリクエストの構造について詳しく説明します。統合を設計する際に役立つリソースです。このガイドでは、P-MAX キャンペーンを変更するリクエストの処理方法について説明します。P-MAX のトラブルシューティング ガイドと P-MAX のバッチ処理ガイドの補足リソースとしてご利用ください。

P-MAX キャンペーンを作成する

Google Ads API では、P-MAX キャンペーンのエンティティは、複数の固有のリソースの組み合わせとして表されます。

標準の P-MAX キャンペーン

標準の P-MAX キャンペーンを配信するには、最小限のリソースが必要です。

ブランド ガイドラインが有効になっているキャンペーンの場合、Campaign と必要な CampaignAsset リソースを作成するオペレーションを 1 つのリクエストに含める必要があります。また、CampaignAsset リソースは、アセットの最小要件と仕様を満たしている必要があります。

AssetGroup エンティティと AssetGroupAsset エンティティを作成するオペレーションは、1 つのリクエストにまとめて含める必要があります。また、AssetGroupAsset リソースは、アセットの最小要件と仕様をすべて満たすように組み合わせる必要があります。小売店向けキャンペーンとの違いをご覧ください。必要なすべての AssetGroupAsset エンティティを指定せずに AssetGroup を作成するリクエストはエラーになります。詳細については、無効な状態と無効なリクエストをご覧ください。

P-MAX キャンペーンを作成するリクエストの構成には、さまざまなオプションがあります。オペレーションをグループ化する方法とリクエストを構造化する方法は、主に目標とインフラストラクチャによって異なります。

  • AssetGroup リソースと AssetGroupAsset リソースを作成する前に、CampaignBudget、Campaign、Asset、CampaignAsset リソースを個別のリクエストで作成します。（ブランド ガイドラインが有効になっているキャンペーンの場合、Campaign と必須の CampaignAsset リソースを 1 つのリクエストに含める必要があります）。
  • これらのリソースをすべて 1 つの変更リクエストに含めます。

CampaignBudget、Campaign、Asset、CampaignAsset の各リソースは、事前に別々のリクエストで作成できますが、AssetGroup リソースと AssetGroupAsset リソースも作成されるまで、P-MAX キャンペーンは配信対象になりません。

有効な P-MAX キャンペーンを配信するための最小要件

イメージ

図に示すように、追加のリソースを作成することで、P-MAX キャンペーンをさらにカスタマイズできます。

AssetGroup リソースと AssetGroupAsset リソースを作成する同じリクエストに、AssetGroupSignal リソースを作成するオペレーションを含めることができます。または、AssetGroup の作成後に別のリクエストで AssetGroupSignal エンティティを作成することもできます。

追加オプション付きの P-MAX キャンペーン

イメージ

小売向けの P-MAX キャンペーン

小売店向けキャンペーンは、有効な配信キャンペーンとなるアセット グループを作成する方法が 2 つあるという点で、他とは異なります。

  • カスタム アセットがない（または HTML5 MEDIA_BUNDLE アセットのみがある）アセット グループ
  • 必要なアセットがすべて含まれているアセット グループ（推奨）

アセット グループからアセットを除外すると、リンクされた Merchant Center アカウントで提供されているアセットが自動的に使用されて広告が作成されます。ただし、すべての広告枠にリーチできるよう、アセットを提供することをおすすめします。 P-MAX 小売店向けキャンペーンを配信するには、少なくとも次のリソースセットが必要です。

  • CampaignBudget
  • Campaign（ShoppingSetting が入力されている）
  • AssetGroup
  • AssetGroupListingGroupFilter

小売店向けキャンペーンでは、Campaign.shopping_setting フィールドに値を入力する必要があります。また、AssetGroup に記載されている final_urls は、Campaign.shopping_setting で指定された Merchant Center アカウント ID に関連付けられているウェブサイトのドメインと一致している必要があります。最後に、各 AssetGroup には、1 つ以上の AssetGroupListingGroupFilter リソースで構成される、有効な商品リスティング グループ ツリーが関連付けられている必要があります。少なくとも、指定した Merchant Center フィードのすべての商品を考慮する 1 つのノードツリーを作成する必要があります。

これらのリソースは、個別に作成することも、1 つのリクエストで作成することもできます。ただし、これらのリソースがすべて正しく作成されるまで、キャンペーンは配信対象になりません。

有効な配信を行う P-MAX 小売店向けキャンペーンの最小要件

イメージ

P-MAX 小売店向けキャンペーンでは、アセット グループのシグナル、キャンペーンのコンバージョン目標、キャンペーンの条件の作成など、標準の P-MAX キャンペーンで使用できるすべてのオプションを使用できます。AssetGroup リソースの作成時に、カスタム アセット（HTML5 MEDIA_BUNDLE アセット以外）を AssetGroup に追加する場合は、リクエストがすべての最小アセット要件（ブランド ガイドラインが有効になっている場合は、キャンペーン単位のブランド アセットを含む）を満たしている必要があります。つまり、カスタム アセットをまったく含めないか、必要なアセットをすべて含めるかのいずれかにします。

追加オプション付きの小売店向け P-MAX キャンペーン

イメージ

無効な状態と無効なリクエスト

Google Ads API で P-MAX キャンペーンを操作する場合、無効な状態と無効なリクエストを区別することが重要です。

ステータスが無効です
キャンペーンの設定内容が原因で、配信できません。たとえば、advertising_channel_type が PERFORMANCE_MAX のスタンドアロン Campaign リソースを作成できます。キャンペーンを作成するリクエストは成功しますが、キャンペーンに少なくとも 1 つの AssetGroup を追加するまで、キャンペーンは配信対象になりません。リクエストは成功したものの、キャンペーンまたはアセット グループが配信されていない場合は、CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus、AssetGroupPrimaryStatusReason を使用して原因を特定できます。詳しくは、トラブルシューティング ガイドをご覧ください。
リクエストが無効です
キャンペーンまたはリソースが無効な状態になるため、成功しないリクエスト。たとえば、最低限必要なアセットを含めずに、小売店向けキャンペーン以外のキャンペーン（ローカル サービスの P-MAX キャンペーン以外）の AssetGroup を作成しようとすると、Google Ads API でエラーがスローされます。そのため、同じリクエストに AssetGroup とその AssetGroupAsset リソースを含める必要があります。これは、リクエスト全体が失敗しないように、すべての AssetGroupAsset リソースが特定の field_type の正しい仕様を満たしている必要があることも意味します。

変更リクエストでオペレーションをグループ化する

P-MAX キャンペーンは複数のリソースで構成されており、これらのリソースを個別のリクエストで作成することも、1 つの一括変更リクエストで作成することもできます。ただし、前述のとおり、標準の P-MAX キャンペーンの AssetGroups と関連する AssetGroupAssets は、1 つのアトミック リクエストで作成する必要があります。

このガイドに記載されている必要なリソースをすべて作成するまで、キャンペーンは配信できません。個別のリクエストを発行する場合は、後続のリクエストで参照されるリソースの実際のリソース名を使用します。複数のオペレーションを含む一括変更リクエストを発行する場合は、一時 ID を使用して形成されたリソース名を使用します。

オペレーションの順序

一括変更リクエストを使用して P-MAX キャンペーンを作成するかどうかにかかわらず、リクエストとオペレーションは、リソースが作成される前に参照されないように順序付ける必要があります。一括変更リクエストの場合、参照されるリソースが参照元のリソースよりも前にリストされるようにオペレーションを並べ替えます。

AssetGroup とその AssetGroupAsset リソースを作成する同じ一括変更リクエストでアセット リソースを作成する場合は、図に示すように、すべての AssetOperations をすべての AssetGroupAssetOperations の前に配置する必要があります。

イメージ

Google 広告サーバーは、連続する AssetGroupAssetOperations をまとめてバッチ処理し、そのグループの最後のオペレーションの後に AssetGroup が最小アセット要件を満たしているかどうかを評価します。リクエストで AssetOperations と AssetGroupAssetOperations を交互に指定すると、API サーバーは最初の AssetGroupAssetOperation の後に最小アセット要件を評価し、リクエスト内の残りのオペレーションを続行せずにエラーを返します。そのため、リクエスト内のアセットは Google 広告アカウントに追加されません。さらに、AssetGroup も、関連する AssetGroupAsset リソースも作成されません。

アセット グループを更新する

有効な AssetGroup を作成した後は、アセット グループがアセットの最小要件を満たさなくなるようなリクエストを送信することはできません。このようなリクエストはエラーをスローします。たとえば、1 つの MARKETING_IMAGE（最小要件）で AssetGroup を作成した場合、その MARKETING_IMAGE AssetGroupAsset のみを削除するリクエストはエラーを返します。ただし、P-MAX 小売店向けキャンペーンでは、1 つのリクエストですべてのカスタム AssetGroupAsset リンクを削除することで、Google Merchant Center で自動生成されたアセットの使用に戻すことができます。AssetGroup

関連付けられたカスタム アセットなしで作成された P-MAX 小売店向けキャンペーンのアセット グループの場合、カスタム アセット（HTML5 MEDIA_BUNDLE アセット以外）をリンクする後続のリクエストでは、AssetGroup に少なくとも 1 つの final_urls が設定されていることを確認し（元々省略されていた場合は、最初に設定します）、最小限必要なアセット（ブランド ガイドラインが有効になっている場合は、キャンペーン単位のブランド アセットを含む）をすべて 1 つのアトミック リクエストで提供する必要があります。YOUTUBE_VIDEO などのオプションの広告アセットを単独でリンクしたり、複数のリクエストにわたって広告アセットを段階的に追加したりしないでください。オプションのカスタム アセットのみをリンクすると、アセット グループがサポートされていない状態になり、Google 広告の管理画面で編集できなくなります。詳しくは、P-MAX 小売店向けキャンペーンでアセット グループをアセットにリンクするをご覧ください。

前へ
キャンペーン条件レポート
次へ
バッチ処理