この記事は Devin Chasanoff による Google Ads Blog の記事 "Performance Max: create listing groups using batch processing " を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。 新機能 2023 年 10 月 4 日より、Google Ads API のバッチ処理で、非同期に AssetGroupListingGroupFilters BatchJobService AssetGroupListingGroupFilter エンティティなどの P-MAX リソース を作成する場合、リスティング グループのツリー作成 中にエラーが発生しても、残りのエンティティの作成はブロックされません。ただし、リスティング グループのツリーを作成する操作がアトミックである点は変わりません。つまり、リスティング グループのツリー作成に関連する操作でエラーが返された場合、そのリスティング グループのツリーに関連するすべての操作も失敗します。ただし、いくつかの注意事項があります。こちらのジョブおよびリスティング グループ フィルタガイド に詳しく記載されているので、ご覧ください。
リスティング グループ フィルタの作成操作を含まない既存のバッチジョブの動作は、今回のアップデートで変更されることはありません。
これまでの動作 2023 年 10 月 4 日より前の時点では、AssetGroupListingGroupFilters は GoogleAdsService.Mutate AssetGroupListingGroupFilterService.MutateAssetGroupListingGroupFilters AssetGroupListingGroupFilterOperation 操作が含まれている場合、GoogleAdsService.Mutate メソッドによるリクエストは常にアトミックです。このような動作になるのは、この操作で partial_failure がサポートされていないためです。つまり、リスティング グループのツリー作成でエラーが発生した場合、リクエスト内の他のすべての操作がブロックされます。2023 年 10 月 4 日より前にバッチ処理で AssetGroupListingGroupFilter エンティティを作成しようとすると、MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE エラーが返されます。
変更の理由 バッチ処理 は Google Ads API の機能で、同期的に操作の完了を待つことなく、一連の操作を複数のサービスにディスパッチできます。その際に、それぞれの操作に相互依存関係があっても問題ありません。今回は、AssetGroupListingGroupFilters でバッチ処理を利用できるようにして、同じリクエストの他の操作をブロックすることなく、リスティング グループのツリー作成を非同期でも行えるようにしました。これは、皆さんからのフィードバック にお応えしたものです。
実装の詳細 バッチジョブで AssetGroupListingGroupFilter を追加するには、次の手順を実行します。
AssetGroupListingGroupFilterOperation を含む MutateOperation を作成します。これは、GoogleAdsService.Mutate サービスを使って MutateOperation を作成する操作 と同様です。バッチジョブに MutateOperation を追加します。これは、他のタイプの操作と同様です 。 次の例は、既存のバッチジョブに 1 つの AssetGroupListingGroupFilter を追加するプロセスを示しています。AssetGroupListingGroupFilter エンティティを使って製品パーティション ツリーを作成する方法については、ショッピング リスティング グループの作成に関するガイド をご覧ください。
// Constructs the AssetGroupListingGroupFilter.
AssetGroupListingGroupFilter listingGroupFilter =
AssetGroupListingGroupFilter.newBuilder()
.setAssetGroup(assetGroupResourceName)
.setType(ListingGroupFilterType.UNIT_INCLUDED)
.setVertical(ListingGroupFilterVertical.SHOPPING)
.build();
// Constructs the operation to create the AssetGroupListingGroupFilter.
MutateOperation operation = MutateOperation.newBuilder()
.setAssetGroupListingGroupFilterOperation(
AssetGroupListingGroupFilterOperation
.newBuilder()
.setCreate(listingGroupFilter))
.build();
// Sends a request to add the operation to the batch job.
AddBatchJobOperationsResponse response =
batchJobServiceClient.addBatchJobOperations(
AddBatchJobOperationsRequest.newBuilder()
.setResourceName(batchJobResourceName)
.addMutateOperations(operation)
.build());
以下のリソースには、連携の際に役立つ追加情報が含まれています。
P-MAX 連携の改善についてのブログシリーズ この記事は、皆さんから要望があった新機能や今後予定されている機能についてお伝えするシリーズの一部です。今後も、新機能や現在の実装アプローチとの違いについて説明してまいります。
今後のアップデートや改善についてお伝えするデベロッパー ブログ にご注目ください。Google Ads API と P-MAX の連携についてのフィードバック も、引き続きお寄せください。サポートが必要な場合は、いつものようにチームにお問い合わせ ください。
Thanet Knack Praneenararat - Ads Developer Relations Team
