このガイドでは、P-MAX キャンペーンを作成および更新するリクエストを構成する際の複雑な作業について詳しく説明します。統合を設計する際に役立つリソースです。このガイドでは、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 にアセットを追加する後続のリクエストは、そのリクエストがすべてのアセット要件を満たしている場合にのみ成功します。つまり、これらのアセット グループにアセットを段階的に追加することはできません。