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

在 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 連結 (在同一個原子變更要求中，或在連結新素材資源後，確保仍符合最低素材資源規定)。

要求參數

GeneratePMaxDraftCampaignRequest 訊息接受下列欄位：

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

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

• gbp_enabled (不支援)：選填。是否要轉換已連結至最高成效廣告活動的 Google 商家檔案地點。請將這個欄位留空或設為 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. 產生草稿廣告活動：只使用必要 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，然後將原始智慧廣告活動的 status 更新為 PAUSED，以免重複放送。