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

自 v25_2 版起，Google Ads API 將推出 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法，協助您將智慧廣告活動轉換為最高成效廣告活動。

轉換的運作方式

呼叫 SmartCampaignSettingService.GeneratePMaxDraftCampaign 時，API 會根據現有智慧廣告活動的設定，產生最高成效廣告活動草稿。

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

• status 已設為 PAUSED。
• creation_status 設為 INCOMPLETE。

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

要求參數

注意：目前尚未實作 gbp_enabled 和 image_enabled 參數，如果在要求中將這些參數設為 true，就會導致錯誤。我們會在日後推出的版本中啟用這些欄位。

GeneratePMaxDraftCampaignRequest 訊息接受下列欄位：

• resource_name (必要)：與要轉換的現有智慧廣告活動相關聯的SmartCampaignSetting資源名稱，格式如下：

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

• gbp_enabled (目前不支援)：是否要轉換並連結與智慧廣告活動相關聯的 Google 商家檔案 (GBP) 地點至產生的最高成效廣告活動。目前尚未實作將這個欄位設為 true 的功能，因此會傳回 GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 錯誤。

• image_enabled (目前不支援)：是否自動為最高成效廣告活動產生必要圖片 (例如橫向、正方形和標誌圖片素材資源)。目前尚未實作將這個欄位設為 true 的功能，因此會傳回 IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 錯誤。

回覆詳細資料

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

• pmax_campaign：產生的草稿最高成效廣告活動的 Campaign 資源名稱。
• campaign_budget：與產生的最高成效廣告活動連結的 CampaignBudget 資源名稱。
• asset_group：與產生的最高成效廣告活動連結的 AssetGroup 資源名稱。
• assets：與產生的最高成效廣告活動連結的 Asset 資源名稱清單。
• validated_info：當 validate_only 設為 true 時，系統會傳回額外的驗證資訊或可能的轉換問題。

建議工作流程

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

1. 產生廣告活動草稿：只使用必要 resource_name 集呼叫 SmartCampaignSettingService.GeneratePMaxDraftCampaign (將 gbp_enabled 和 image_enabled 設為未設定或 false)。儲存傳回的 pmax_campaign、campaign_budget、asset_group 和 assets 資源名稱。
2. 檢查及自訂廣告活動：由於系統是使用 status = PAUSED 和 creation_status = INCOMPLETE 建立最高成效廣告活動草稿，請檢查並設定廣告活動的預算、素材資源群組和素材資源。
3. 啟用廣告活動：準備好放送廣告時，請將廣告活動的 status 更新為 ENABLED，並將 creation_status 更新為 COMPLETE。

注意：在日後發布的版本中啟用 gbp_enabled 和 image_enabled 後，你也可以自動遷移 Google 商家檔案地點和圖片資產。