このガイドでは、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 キャンペーンをさらにカスタマイズできます。
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リソースを作成できます。キャンペーンの作成リクエストは成功しますが、キャンペーンにAssetGroupを 1 つ以上追加するまで、キャンペーンは配信対象になりません。リクエストは成功してもキャンペーンまたはアセット グループが配信されない場合は、トラブルシューティング ガイドに記載されているように、CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus、AssetGroupPrimaryStatusReasonを使用して原因を特定できます。 - リクエストが無効です
- キャンペーンまたはリソースが無効な状態になるため、成功しないリクエスト。たとえば、最低限必要なアセットを含めずに、小売以外のキャンペーンの
AssetGroupを作成しようとすると、Google Ads API によってエラーがスローされます。そのため、同じリクエストにAssetGroupリソースとそのAssetGroupAssetリソースを含める必要があります。また、リクエスト全体が失敗しないように、すべてのAssetGroupAssetリソースが特定のfield_typeの正しい仕様に準拠している必要があります。
ミューテーション リクエストでオペレーションをグループ化する
P-MAX キャンペーンは複数のリソースで構成されています。これらの個別のリソースは、個別のリクエストで作成することも、1 つの一括変更リクエストで作成することもできます。ただし、通常の P-MAX キャンペーンの AssetGroups と関連する AssetGroupAssets は、すでに説明したように、単一のアトミック リクエストで作成する必要があります。
このガイドで説明する必要なリソースをすべて正常に作成するまで、キャンペーンは配信できません。個別のリクエストを発行する場合は、後続のリクエストで参照されるリソースの実際のリソース名を使用します。複数のオペレーションを含む一括 mutate リクエストを発行する場合は、一時 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 を削除するリクエストはエラーを返します。
これは、関連するアセットなしで作成された小売キャンペーンのアセット グループの場合に特に重要です。AssetGroupAsset リソースを作成して AssetGroup にアセットを追加する後続のリクエストは、リクエストがすべてのアセット要件を満たしている場合にのみ成功します。つまり、これらのアセット グループにアセットを段階的に追加することはできません。