智慧廣告活動

注意： 自 2026 年 9 月 23 日起，建立智慧廣告活動的功能將淘汰，不再支援。嘗試建立智慧廣告活動時，v24 以上版本會傳回 SmartCampaignError.CREATION_FAILED，v23 則會傳回 AuthorizationError.ACTION_NOT_PERMITTED。帳戶中的智慧廣告活動會繼續放送廣告，且仍可更新或在報表中查詢。

注意： 在 v25 以上版本中，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 將智慧廣告活動轉換為最高成效廣告活動 (不適用於 v24 以下版本)。詳情請參閱「將智慧廣告活動轉換為最高成效廣告活動」指南。

智慧廣告活動旨在協助小型商家在線上觸及更多顧客。只需進行最基本的設定和維護。智慧廣告活動會根據商家詳細資料和目標 (例如吸引顧客來電、鼓勵顧客親臨門市，或促使顧客在網站上採取行動)，運用 Google 廣告技術自動最佳化廣告活動。

建立廣告活動

建立智慧廣告活動的工作流程與其他廣告活動類型不同，需要幾個步驟。最佳做法是在單一 GoogleAdsService.Mutate 要求中新增實體。

以下是智慧廣告活動建立工作流程中的步驟 (在帳戶中檢查或更新智慧廣告活動時，也適用這些步驟中說明的實體關係和設定)。詳情請參閱完整的程式碼範例。

1. 根據 SmartCampaignSuggestService、KeywordThemeConstantService 或任意形式的關鍵字主題建議，建立關鍵字主題清單。這些關鍵字主題可用於擷取不同層級的預算建議、建立關鍵字主題廣告活動條件，以及產生廣告文字素材建議。
2. 從 SmartCampaignSuggestService 取得預算金額、廣告標題和說明建議。這項服務會根據您的商家資訊、指定地區、指定語言和關鍵字主題，建議high、low或recommended每日預算金額，以及最多三個廣告標題和兩個廣告說明文字。
3. 使用建議的預算金額建立 CampaignBudget。使用建議預算金額，有助於盡量提升廣告活動成效。智慧廣告活動預算無法與其他廣告活動共用。
4. 建立 Campaign 和 SmartCampaignSetting。SmartCampaignSetting 無法與相關聯的 Campaign 分開存在，因此請使用負數暫時資源名稱 (例如 customers/{customer_id}/campaigns/-1) 連結依附資源，在同一個 Mutate 要求中一併建立這兩個實體。
5. 建立 CampaignCriterion 物件清單。本指南會使用步驟 1 彙整的關鍵字主題，建立關鍵字主題廣告活動條件，並說明其他支援的廣告活動條件類型。
6. 建立 AdGroup。一個智慧廣告活動只能有一個相關聯的AdGroup。
7. 使用包含 3 到 15 個廣告標題和 2 到 4 則說明的 SmartCampaignAdInfo，建立 AdGroupAd。

商家檔案地點

產生建議或設定廣告活動時，請提供商家檔案位置 ID，盡量提升智慧廣告活動的成效。

你可以透過商家檔案 API 的 name 欄位或商家檔案使用者介面，取得商家檔案地點 ID。

在 SmartCampaignSuggestionInfo 或 SmartCampaignSetting 物件上設定時，ID 應為以下格式的字串：

locations/locationId

如果是從商家檔案 API 擷取，ID 格式會正確無誤。不過，如果是從使用者介面擷取，則必須將 ID 附加至 locations/。

廣告活動狀態

如要擷取智慧廣告活動的狀態，請使用廣告活動的 SmartCampaignSetting resource_name (customers/{customer_id}/smartCampaignSettings/{campaign_id}) 呼叫 SmartCampaignSettingService.GetSmartCampaignStatus。相較於 campaign.primary_status 或 campaign.primary_status_reasons，這個方法提供的智慧廣告活動狀態匯總檢視畫面更完整。

GetSmartCampaignStatusResponse 包含 SmartCampaignStatus (ELIGIBLE、NOT_ELIGIBLE、PENDING、PAUSED、REMOVED 或 ENDED) 和狀態專屬詳細資料：

• not_eligible_details：包含 SmartCampaignNotEligibleReason (ACCOUNT_ISSUE、BILLING_ISSUE、BUSINESS_PROFILE_LOCATION_REMOVED 或 ALL_ADS_DISAPPROVED)。
• eligible_details：包括 last_impression_date_time (前 48 小時內觀察到的最後一次曝光時間戳記) 和 end_date_time (如適用)。
• paused_details、removed_details 和 ended_details：在客戶時區 (yyyy-MM-dd HH:mm:ss) 中，加入相應的 paused_date_time、removed_date_time 或 end_date_time 時間戳記。

檢舉注意事項

智慧廣告活動的結構經過簡化，每個廣告活動只能有一個廣告群組。這種結構對報表有特定影響：

• 廣告群組層級指標：每個智慧廣告活動只有一個廣告群組，因此廣告群組層級的任何成效指標 (例如點擊次數、曝光次數和轉換次數) 都與整個廣告活動的指標相同。
• 指標擷取：查詢成效資料時，您可以在廣告活動層級擷取指標。雖然您可以在廣告群組層級擷取指標，但這些指標不會提供廣告活動層級以外的額外詳細資料。

如要取得有關智慧廣告活動的大部分報表，查詢 campaign 和相關聯的指標，即可全面瞭解成效。