リクエストの構成

このガイドでは、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 つの異なる方法があるという点で、他とは異なります。

  • アセットのないアセット グループ
  • 必要なアセットがすべて含まれているアセット グループ（推奨）

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

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

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

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

有効なショッピング P-MAX キャンペーンの最小要件

イメージ

小売店向けキャンペーンでは、アセット グループ シグナルの作成、キャンペーンのコンバージョン目標、キャンペーンの条件など、通常の P-MAX キャンペーンで利用できるすべてのオプションを利用できます。AssetGroup リソースの作成時に AssetGroup に広告アセットを追加する場合は、AssetGroup が最小アセット要件を満たす必要があります。つまり、アセットをまったく含めないか、必要なアセットをすべて含めるかのいずれかです。

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

イメージ

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

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

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

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

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

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

オペレーションの順序

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

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

イメージ

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

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

有効な AssetGroup を作成した後は、最小アセット要件を満たさなくなる無効な状態になるリクエストを発行することはできません。このようなリクエストはエラーをスローします。たとえば、単一の MARKETING_IMAGE（最小要件）で AssetGroup を作成した場合、その MARKETING_IMAGE に関連付けられた AssetGroupAsset の削除リクエストはエラーを返します。

これは、関連付けられたアセットなしで作成された小売店向けキャンペーンのアセット グループの場合に特に重要です。AssetGroupAsset リソースを作成して AssetGroup にアセットを追加する後続のリクエストは、リクエストがすべてのアセット要件を満たしている場合にのみ成功します。つまり、これらのアセット グループにアセットを段階的に追加することはできません。

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