このガイドでは、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 つの異なるアセット グループ作成方法があります。
- アセットが設定されていないアセット グループ
- 必須アセットをすべて含むアセット グループ（推奨）
アセット グループからアセットを除外すると、Google はリンクされた Merchant Center アカウントで提供されたアセットを自動的に使用して広告を作成します。ただし、すべての広告枠にリーチできるようにアセットを提供することをおすすめします。小売店向けの P-MAX キャンペーンで広告を配信するには、次の最小限のリソースが必要です。
CampaignBudgetCampaign（ShoppingSettingsが入力されている）AssetGroupAssetGroupListingGroupFilter
小売キャンペーンでは Campaign.shopping_settings フィールドに値を入力する必要があります。また、各 AssetGroup に記載されている final_urls は、Campaign.shopping_settings で指定された Merchant Center アカウント ID に関連付けられている URL と一致している必要があります。最後に、各 AssetGroup には、1 つ以上の AssetGroupListingGroupFilter リソースで構成される、関連付けられた有効な商品リスティング グループ ツリーが必要です。指定した Merchant Center フィードのすべての商品を考慮した単一のノードツリーを少なくとも 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の正しい仕様を満たしている必要があります。
mutate リクエストでオペレーションをグループ化する
P-MAX キャンペーンは複数のアセットで構成されており、これらの個別のリソースは、個別のリクエストで作成することも、単一の一括変更リクエストで作成することもできます。ただし、標準の P-MAX キャンペーンの AssetGroups と関連する AssetGroupAssets は、すでに説明したように、単一のアトミック リクエストで作成する必要があります。
このガイド全体で説明されている必要なリソースをすべて作成するまで、キャンペーンは配信対象になりません。個別のリクエストを発行する場合は、後続のリクエストで、参照されるリソースの実際のリソース名を使用します。複数のオペレーションを含む一括 mutate リクエストを発行する場合は、一時 ID を使用して作成されたリソース名を使用します。
オペレーションの順序
一括変更リクエストを使用してパフォーマンスの最大化キャンペーンを作成するかどうかに関係なく、リソースが作成される前にリソースを参照しないようにリクエストとオペレーションを順序付けする必要があります。一括変更リクエストの場合、これは、参照されるリソースが、それらを参照するリソースの前にリストされるようにオペレーションを順序付けることを意味します。
AssetGroup とその AssetGroupAsset リソースを作成するのと同じ一括変更リクエストでアセット リソースを作成する場合は、図に示すように、すべての AssetOperations がすべての AssetGroupAssetOperations の前に来るようにする必要があります。
Google 広告サーバーは、連続する AssetGroupAssetOperations をまとめて、そのグループの最後のオペレーションの後に AssetGroup がアセットの最小要件を満たしているかどうかを評価します。リクエストで AssetOperations と AssetGroupAssetOperations を交互に使用すると、API サーバーは最初のリクエストの AssetGroupAssetOperation の後に最小アセット要件を評価し、リクエストの残りのオペレーションを続行せずにエラーを返します。そのため、リクエスト内のアセットは Google 広告アカウントに追加されません。また、AssetGroup と関連する AssetGroupAsset リソースも作成されません。
アセット グループを更新する
有効な AssetGroup を作成した後は、最小アセット要件を満たさなくなる無効な状態になるリクエストを発行することはできません。このようなリクエストはエラーをスローします。たとえば、単一の MARKETING_IMAGE（最小要件）で AssetGroup を作成した場合、その MARKETING_IMAGE に関連付けられた AssetGroupAsset を削除するリクエストはエラーを返します。
これは、関連付けられたアセットなしで作成されたショッピング キャンペーンのアセット グループの場合に特に重要です。AssetGroupAsset リソースを作成して AssetGroup にアセットを追加する後続のリクエストは、リクエストがすべてのアセット要件を満たしている場合にのみ成功します。つまり、これらのアセット グループにアセットを段階的に追加することはできません。