リクエストの構成

このガイドでは、構成の複雑なリクエストを作成し、 更新する方法を説明しますアプリケーションを設計する際に役立つリソース 必要がありますこのガイドでは、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 キャンペーンですオペレーションとオペレーションのグループ化の方法は、 構造リクエストは、目標とインフラストラクチャに大きく依存します。

  • CampaignBudget、Campaign、Asset の各リソースを別々に作成する AssetGroup リソースと AssetGroupAsset リソースを作成する前にリクエストを実行します。
  • これらのリソースをすべて 1 つの変更リクエストに含めます。

CampaignBudget、Campaign、Asset は正常に作成できますが、 以前のリクエストに分けておけば、P-MAX キャンペーンで AssetGroup リソースと AssetGroupAsset リソースが使用可能になるまで、 確認できます。

有効な P-MAX キャンペーンの配信に必要な最小要件

画像

P-MAX キャンペーンをさらにカスタマイズするには、追加の Google Cloud リソースを管理できます

AssetGroupSignal リソースを作成するオペレーションを含めることができます。 AssetGroup リソースと AssetGroupAsset リソースを作成するリクエスト。 別のリクエストで AssetGroupSignal エンティティを作成することもできます。 （AssetGroup の作成後）。

追加オプションのある P-MAX キャンペーン

画像

小売向け P-MAX キャンペーン

小売キャンペーンの特徴は、 有効な配信につながるアセット グループを作成する 2 つの方法 campaign:

  • アセットのないアセット グループ
  • 必須のアセットをすべて含むアセット グループ（推奨）

アセット グループからアセットを除外すると、自動的に オーディエンスシグナルを使って リンクされた Merchant Center アカウント できます。ただし、すべての広告枠に配信できるようにアセットを指定することをおすすめします。 小売向け P-MAX キャンペーンでは、最低でも次の設定が必要です 提供する必要があります。

  • CampaignBudget
  • Campaign（ShoppingSettings が入力済み）
  • AssetGroup
  • AssetGroupListingGroupFilter

なお、Campaign.shopping_settings フィールドは 小売キャンペーンに使用されますさらに、各モジュールにリストされている final_urls は、 AssetGroup は Merchant Center アカウント ID に関連付けられている URL と一致する必要があります Campaign.shopping_settings で指定された値。最後に、各 AssetGroup は 有効な商品リスティング グループ ツリーが関連付けられていること。このツリーは 1 つ以上の AssetGroupListingGroupFilter リソース。少なくとも、サーバーを 1 つずつ ノードツリーを作成し、指定した Merchant Center フィードのすべての商品を対象とします。

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

小売業向け P-MAX キャンペーンの有効な配信に関する最小要件

画像

小売キャンペーンでは、標準のショッピング キャンペーンと P-MAX キャンペーン（アセット グループのシグナルの作成、 コンバージョン目標、キャンペーンの条件です新しい P-MAX キャンペーンで AssetGroup リソースを作成するとき、AssetGroup は次のようになります。AssetGroup アセットの最小要件が適用されます言い換えると、 アセットが含まれていないか、必要なアセットがすべて含まれている。

小売向け P-MAX キャンペーンと追加オプション

画像

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

Google Ads API で P-MAX キャンペーンを使用する場合は、 無効な状態と無効なリクエストの重要な違いについて説明します。

ステータスが無効です
キャンペーンは、設定内容が原因で配信できません。対象 たとえば、Terraform で記述された単一の ID を持つスタンドアロンの Campaign リソースを advertising_channel_type/PERFORMANCE_MAX。作成リクエストは キャンペーンで成功した場合、少なくとも 1 つ追加しないと配信できません キャンペーンに対する AssetGroup。リクエストが成功してもキャンペーンや アセット グループが配信されていない場合は、CampaignPrimaryStatus を使用できます。 CampaignPrimaryStatusReason、AssetGroupPrimaryStatus、 AssetGroupPrimaryStatusReason で理由を判断します。詳細は、 トラブルシューティング ガイドをご覧ください。
リクエストが無効です
キャンペーンや 無効な状態にできます。たとえば、Google Ads API では、次の場合にエラーがスローされます。 小売以外のキャンペーンのAssetGroupを作成してみます。ただし、 最低限必要なアセットこれは、 AssetGroup とその AssetGroupAsset リソースを リクエストできます。これは、すべての AssetGroupAsset リソースが 特定の field_type の正しい仕様を満たすものと見なして、 防ぐことができます。

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

P-MAX キャンペーンは複数のリソースで構成されており、 個別のリクエストでこれらのリソースを作成したり、 一括変更リクエスト。ただし、AssetGroups および 標準の P-MAX キャンペーンで関連付けられた「AssetGroupAssets」は、 単一のアトミックなリクエストで作成されます。

すべてのキャンペーンを リソースが表示されます。個別に 後続のモジュールで参照されるリソースの実際のリソース名を できます。複数のオペレーションを含む一括変更リクエストを発行する場合、 一時的な ID を使用して形成されるリソース名。

オペレーションの順序

P-MAX の作成に一括変更リクエストを使用するかどうかに関係なく リクエストとオペレーションの順序は、 作成前にリソースを参照することができます。一括変更の場合 つまり、参照される順序にオペレーションの順序が そのリソースを参照するリソースの前に一覧表示されます。

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

画像

Google 広告サーバーが連続する AssetGroupAssetOperations を一括で処理する 次に、AssetGroup が次のアセットの最小要件を満たしているかどうかを評価します。 最後のオペレーションです。AssetOperations を交互にする場合 と AssetGroupAssetOperations の両方を含む場合、API サーバーは 最初の AssetGroupAssetOperation より後のアセットの最小要件と、 の残りの操作を続行せずにエラーを返す リクエストできます。そのため、リクエスト内のどのアセットも Google 広告アカウントさらに、AssetGroup も関連付けられた AssetGroupAsset 個のリソースが作成されます。

アセット グループを更新

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

これは、小売業のキャンペーンのアセット グループの場合に特に重要となります。 アセットが一切含まれていない状態です後続のリクエストでは、 AssetGroupAsset リソースを作成して AssetGroup を実行すると、次の場合にのみ成功します。 リクエストがすべてのアセット要件を満たしています。つまり、アセットの追加先は アセットグループが対象になります

前へ
Reporting
次へ
バッチ処理