P-MAX のバッチ処理

バッチ処理を使用すると、相互に依存する可能性のある一連のオペレーションを複数のサービスにディスパッチできます。このとき、オペレーションの完了を同期的に待つ必要はありません。バッチ処理を使用して、P-MAX キャンペーンを作成、管理できます。

このガイドでは、バッチ処理を使用する際の P-MAX キャンペーンに固有の詳細について説明します。一般的なバッチ処理ガイドには、バッチ処理に関する一般的な情報が記載されています。また、リクエストの構造ガイドには、P-MAX キャンペーンを作成または管理するためのリクエストの作成に関する詳細情報が記載されています。

バッチ処理を使用して P-MAX キャンペーンを作成する手順は次のとおりです。

新しいバッチジョブを作成する

BatchJob リソースを作成するための一般的なバッチ処理ジョブ作成手順に従います。

mutate オペレーションのリストを準備する

P-MAX キャンペーンでは、いくつかの関連リソースを作成するオペレーションが必要です。詳しくは、リクエストの構造化ガイドをご覧ください。バッチジョブに含めるリソースごとに MutateOperation を作成します。

CampaignOperation と CampaignAssetOperation の要件

注: この要件は、ブランド アセットの要件を満たすために CampaignAsset を使用して Asset リソースが関連付けられている Campaign リソースにのみ適用されます。

キャンペーンでブランド ガイドラインが有効になっている場合（ブランド ガイドラインを参照）、CampaignAsset リソースを使用してブランド アセットをキャンペーンにリンクする必要があります。さらに、バッチジョブでは、これらの CampaignAsset リソースの作成は、Campaign リソース自体の作成直後に行う必要があります。Campaign リソースの直後に CampaignAsset リソースが作成されない場合（ブランド ガイドラインが有効になっている場合 - トラブルシューティングを参照）、リクエストは失敗し、アセットが見つからないことを示す CampaignError が返されます。同じオペレーション リストの後半に CampaignAsset 作成オペレーションを含めても、このエラーは回避できません。

AssetGroupOperation と AssetGroupAssetOperation の要件

注: この要件は、最小アセット要件に準拠するために、AssetGroupAsset を使用して Asset リソースが関連付けられている AssetGroup リソースにのみ適用されます。

バッチジョブで AssetGroup リソースと AssetGroupAsset リソースを作成する MutateOperation タイプのオペレーションは、処理時にこれらのオペレーションがグループ化されるため、間に他のオペレーションを挟まずに、順番に実行する必要があります。そうしないと、最小アセット要件を満たすために必要なオペレーションがオペレーション リストの後半に含まれていても、リクエストは一部のアセットが欠落していることを示す AssetGroupError をスローします。

AssetGroupListingGroupFilterOperation のベスト プラクティス

注: AssetGroupListingGroupFilter リソースは、商品フィードを使ったオンライン販売の P-MAX キャンペーンでのみ使用できます。 このようなキャンペーンの AssetGroup リソースには、1 つ以上の AssetGroupListingGroupFilter リソースが関連付けられた有効な商品グループツリーが必要です。すべての商品をターゲットに設定するには、単一ノードのツリーを使用します。

AssetGroupListingGroupFilter のコンテキストでリスティング グループ フィルタを操作する場合は、同じ AssetGroup をターゲットとする AssetGroupListingGroupFilterOperation オペレーションをバッチジョブに連続して追加することをおすすめします。これにより、バッチ分割中に一連のオペレーションがアトミックに処理されます。バッチ分割や、リスティング グループに影響するその他の要因について詳しくは、リスティング グループのバッチ処理ガイドをご覧ください。

ジョブに mutate オペレーションを追加する

ステップ 2 の mutate オペレーションをリストに追加し、AddBatchJobOperations を呼び出して、ステップ 1 で作成したバッチジョブにミューテーションのリストを追加します。一般的なバッチ処理ガイドの広告オペレーションを追加する手順に沿って、ミューテーション オペレーションのリストを追加します。

バッチジョブを実行する

RunBatchJob を呼び出して、アップロードされたジョブの実行を開始できるようにします。例については、一般的なバッチ処理ガイドのバッチジョブを実行するステップをご覧ください。

ジョブのステータスを取得する

バッチジョブは長時間実行オペレーションとして開始され、通常は完了までに時間がかかります。ジョブを開始したら、長時間実行オペレーションの GetOperation メソッドを使用して、ジョブが完了するまでジョブのステータスをポーリングします。

すべてのバッチジョブが完了したら、ListBatchJobResults を呼び出して、一般的なバッチ処理ガイドのすべてのバッチジョブの結果を一覧表示する手順に沿って、ステータスとレスポンスを出力します。