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

在 v25 (自 v25.2起)，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法將智慧廣告活動轉換為最高成效廣告活動。這個方法不適用於 v24 和更早的版本。

轉換的運作方式

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

產生的最高成效廣告活動草稿會初始化為status 設為 PAUSED (放送資格會反映在 primary_status 中)。如果智慧廣告活動的所有功能轉換器都無法通過驗證，要求就會失敗並顯示 SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL 錯誤。

這樣一來，您就能在啟用廣告活動放送廣告前，檢查、修改及改善產生的最高成效廣告活動、預算、素材資源群組和素材資源。產生最高成效廣告活動草稿時，系統不會修改或暫停原始智慧廣告活動，該廣告活動會持續放送，直到您手動暫停為止。

要求參數

GeneratePMaxDraftCampaignRequest 訊息接受下列欄位：

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

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

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

• image_enabled (不支援)：選填。 是否要產生必要的最高成效廣告活動圖片 (例如橫向、正方形和標誌圖片類型)。請將這個欄位留空或設為 false；如果設為 true，v25 不會實作，並傳回 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. 產生廣告活動草稿：只使用必要 resource_name 集呼叫 SmartCampaignSettingService.GeneratePMaxDraftCampaign (將 gbp_enabled 和 image_enabled 設為未設定或 false)。儲存傳回的 pmax_campaign、campaign_budget、asset_group 和 assets 資源名稱。
2. 檢查及自訂廣告活動：由於系統是使用 status = PAUSED 建立最高成效廣告活動草稿，請檢查並設定廣告活動的預算、素材資源群組和素材資源。
3. 啟用廣告活動並暫停原始廣告活動：準備放送廣告時，請將最高成效廣告活動的 status 更新為 ENABLED，然後將原始智慧廣告活動的 status 更新為 PAUSED，避免重複放送。