將智慧廣告活動轉換為最高成效廣告活動

在 v25 以上版本中，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法，將智慧廣告活動轉換為最高成效廣告活動。這個方法不適用於 v24 以下版本。

轉換的運作方式

呼叫 SmartCampaignSettingService.GeneratePMaxDraftCampaign 時，API 會根據要求中提供的智慧廣告活動設定，產生最高成效廣告活動、預算、素材資源群組和素材資源草稿。生成後，請先檢查、修改及強化新資源，再啟用廣告活動放送廣告。

產生的最高成效草稿廣告活動會以下列狀態值初始化：

• status 設為 PAUSED。
• 其放送資格會反映在 primary_status 中。
• 根據預設，contains_eu_political_advertising 會設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING (如果智慧廣告活動尚未指定)。如果廣告活動含有歐盟政治廣告，請驗證並更新這個欄位。

這樣一來，您就能在啟用廣告活動放送廣告前，檢查、修改及強化產生的最高成效廣告活動、預算、素材資源群組和素材資源。

素材資源草稿

新廣告活動會隨附一組預留位置圖片，必須先替換這些圖片，才能啟用新廣告活動。如果要求支援 image_enabled 欄位，且該欄位設為 true，API 就會自動生成圖片，而非使用預留位置圖片。您可以在回應的 assets 欄位中檢查新素材資源，並按照下列步驟進行替換：

1. 請參閱素材資源規定指南。
2. 請按照上傳圖片素材資源範例上傳新圖片。
3. 請按照將素材資源群組連結至素材資源指南，將新素材資源連結至草稿廣告活動的素材資源群組，然後移除預留位置圖片的 AssetGroupAsset 連結 (在同一個原子變更要求中，或在連結新素材資源後，確保仍符合最低素材資源規定)。

要求參數

注意： 系統不支援 gbp_enabled 和 image_enabled 參數，如果在要求中設為 true，會導致錯誤。請將這兩個欄位留空，或設為 false。

GeneratePMaxDraftCampaignRequest 訊息接受下列欄位：

• resource_name (必要)：要轉換的智慧廣告活動中，SmartCampaignSetting 的資源名稱，格式如下：

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (選用)：如果為 true，系統會驗證要求，但不會執行。系統只會在回應的 validated_info 欄位中傳回驗證錯誤、警告或可能的轉換問題，不會建立草稿實體。

• gbp_enabled (不支援)：選填。是否要轉換與最高成效廣告活動連結的 Google 商家檔案 (GBP) 地點。請將這個欄位留空或設為 false。不支援設為 true，否則會傳回 SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 錯誤。

• image_enabled (不支援)：選填。是否要生成必要的最高成效廣告活動圖片 (例如橫向、正方形和標誌圖片類型)。請將這個欄位留空或設為 false；不支援設為 true，否則會傳回 SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 錯誤。

回覆詳細資料

GeneratePMaxDraftCampaignResponse 訊息會傳回產生的最高成效草稿廣告活動，以及相關聯實體的資源名稱：

• pmax_campaign：產生的最高成效廣告活動草稿Campaign資源名稱。
• campaign_budget：連結至所產生最高成效廣告活動的 CampaignBudget 資源名稱。
• asset_group：連結至所產生最高成效廣告活動的AssetGroup資源名稱。
• assets：連結至所產生最高成效廣告活動的 Asset 資源名稱清單。
• validated_info：轉換檢查傳回的驗證資訊或可能發生的轉換問題 (當 validate_only 設為 true 時，以及 validate_only 為 false 時，與產生的實體資源名稱一併填入)。

建議的工作流程

如要轉換智慧廣告活動，請按照下列工作流程操作：

1. 產生草稿廣告活動：呼叫 SmartCampaignSettingService.GeneratePMaxDraftCampaign，僅設定必要的 resource_name (gbp_enabled 和 image_enabled 則不設定，或設為 false)。儲存傳回的 pmax_campaign、campaign_budget、asset_group 和 assets 資源名稱。
2. 查看及自訂廣告活動：由於最高成效廣告活動草稿是使用 status = PAUSED 和 creation_status = INCOMPLETE 建立，因此請檢查並設定預算、素材資源群組和素材資源。
3. 啟用廣告活動並暫停原始廣告活動：準備好放送廣告時，請將最高成效廣告活動的 status 更新為 ENABLED，然後將原始智慧廣告活動的 status 更新為 PAUSED，以免重複放送。

注意： 未來版本啟用 gbp_enabled 和 image_enabled 後，您也可以自動遷移 Google 商家檔案地點和圖片素材資源。