ãã®è¨äºã¯ Devin Chasanoff ã«ãã Google Ads Blog ã®è¨äº "Performance Max: create listing groups using batch processing " ãå
ã«ç¿»è¨³・å çãããã®ã§ã。詳ããã¯å
è¨äºãã覧ãã ãã。 æ°æ©è½ 2023 å¹´ 10 æ 4 æ¥ãã、Google Ads API ã®ãããå¦çã§、éåæã« AssetGroupListingGroupFilters
ãä½æã§ããããã«ãªãã¾ãã。BatchJobService
ã使ã£ã¦ 1 åã®ãªã¯ã¨ã¹ã㧠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 ã®é£æºã«ã¤ãã¦ã®ãã£ã¼ããã㯠ã、å¼ãç¶ããå¯ããã ãã。ãµãã¼ããå¿
è¦ãªå ´åã¯、ãã¤ãã®ããã«ãã¼ã ã«ãåãåãã ãã ãã。
Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team