このガイドでは、P-MAX キャンペーンの作成と更新を行うリクエストを構成する際の多くの複雑な手順について詳しく説明します。統合を設計する際に役立つリソースですこのガイドでは、P-MAX キャンペーンを変更するリクエストの処理方法について説明し、P-MAX トラブルシューティング ガイドと併せて参照できます。
P-MAX キャンペーンを作成する
Google Ads API では、P-MAX キャンペーンのエンティティは複数の固有のリソースの組み合わせとして表されます。
標準の P-MAX キャンペーン
標準の P-MAX キャンペーンを配信するには、最小限のリソースセットが必要です。
AssetGroup エンティティと AssetGroupAsset エンティティを作成するオペレーションは 1 つのリクエストに含める必要があり、AssetGroupAsset リソースはすべての最小アセット要件と仕様を満たすように組み合わせる必要があります。この点が小売キャンペーンでどのように異なるかをご覧ください。必要な AssetGroupAsset エンティティがすべて指定されていない AssetGroup の作成リクエストは、エラーになります。詳細については、無効な状態と無効なリクエストをご覧ください。
P-MAX キャンペーンを作成するリクエストを構成するには、さまざまな方法があります。オペレーションをグループ化してリクエストを構成する方法は、目標とインフラストラクチャによって大きく異なります。
AssetGroupリソースとAssetGroupAssetリソースを作成する前に、CampaignBudget、Campaign、Assetリソースを別々のリクエストで作成します。- これらのリソースをすべて 1 つの変換リクエストに含めます。
以前のリクエストで CampaignBudget、Campaign、Asset の各リソースを正常に作成することは可能ですが、AssetGroup リソースと AssetGroupAsset リソースも作成されるまで、P-MAX キャンペーンは配信の対象外となります。
有効な P-MAX キャンペーンを配信するための最小要件
図に示すように追加のリソースを作成することで、P-MAX キャンペーンをさらにカスタマイズできます。
AssetGroup リソースと AssetGroupAsset リソースを作成するリクエストに、AssetGroupSignal リソースを作成するオペレーションを含めることができます。または、AssetGroup の作成後に、別のリクエストで AssetGroupSignal エンティティを作成することもできます。
追加オプションがある P-MAX キャンペーン
小売向け P-MAX キャンペーン
小売向けキャンペーンは、有効な配信キャンペーンにつながるアセット グループを作成する方法が 2 つあるという点で異なります。
- アセットのないアセット グループ
- 必要なアセットをすべて含むアセット グループ（推奨）
アセット グループからアセットを除外する場合、リンクされた 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に対して正しい仕様を満たしている必要があります。
変更リクエストを含むオペレーションをグループ化する
P-MAX キャンペーンは複数のリソースで構成され、これらのリソースは別々のリクエストごと、または 1 つの一括変更リクエストの中で作成することができます。ただし、すでに説明したように、通常の P-MAX キャンペーンの AssetGroups とそれに関連する AssetGroupAssets は、単一のアトミック リクエストで作成する必要があります。
このガイドで説明している必要なリソースがすべて適切に作成されるまで、キャンペーンは配信できません。個別のリクエストを発行する場合は、後続のリクエストで参照されるリソースの実際のリソース名を使用します。複数のオペレーションを含む一括変換リクエストを発行する場合は、一時 ID を使って形成されたリソース名を使用します。
オペレーションの順序
一括変換リクエストを使用して P-MAX キャンペーンを作成するかどうかにかかわらず、リソースの作成前にリソースを参照しないようにリクエストとオペレーションの順序を決める必要があります。一括変更リクエストの場合は、参照するリソースが参照先のリソースよりも先に表示されるようにオペレーションを並べ替えます。
AssetGroup とその AssetGroupAsset リソースを作成する同じ一括変更リクエストで Asset リソースを作成する場合、図に示すように、すべての AssetOperations をすべての AssetGroupAssetOperations の前に配置する必要があります。
Google 広告サーバーは、連続する AssetGroupAssetOperations をバッチ処理して、そのグループの最後のオペレーションの後に AssetGroup がアセットの最小要件を満たしているかどうかを評価します。リクエストで AssetOperations と AssetGroupAssetOperations を交互に使用すると、API サーバーは最初の AssetGroupAssetOperation の後に最小アセット要件を評価し、リクエストの残りのオペレーションを続行せずにエラーを返します。結果として、そのリクエストのどのアセットも Google 広告アカウントに追加されません。また、AssetGroup も、関連する AssetGroupAsset リソースも作成されません。
アセット グループを更新
有効な AssetGroup を作成した後は、後続のリクエストを発行できなくなります。その場合、最小アセット要件が満たされなくなる無効な状態が発生します。このようなリクエストではエラーがスローされます。たとえば、単一の MARKETING_IMAGE（最小要件）で AssetGroup を作成する場合、その MARKETING_IMAGE に関連付けられている AssetGroupAsset を削除するリクエストではエラーが返されます。
これは、関連するアセットなしで作成された小売キャンペーンのアセット グループの場合に特に重要です。AssetGroupAsset リソースを作成して AssetGroup にアセットを追加する後続のリクエストは、リクエストがすべてのアセット要件を満たしている場合にのみ成功します。つまり、これらのアセット グループにアセットを段階的に追加することはできません。