Google Ads API 整合
在 WittiGrow 內使用 Google Ads
WittiGrow 是為香港中小企而設的推廣平台。我們使用 Google Ads API，讓你可以在 WittiGrow 介面內，於你自己的 Google Ads 帳戶中建立、投放及停止 Google 搜尋廣告系列。本頁逐項說明這代表我們可以對你的帳戶做什麼。
我們用這個 API 做什麼
以下所有操作，都只會在你連接時自行選定的 Google Ads 帳戶內進行，並使用你自己的付款方式。WittiGrow 不會用我們的管理員帳戶代你投放廣告。
- 帳戶識別—— 你連接後，我們會列出你登入的 Google 使用者可存取的 Google Ads 帳戶，並讀取每個帳戶的名稱、貨幣、時區及管理員（MCC）標記，讓你選擇正確的帳戶，也確保我們不會誤將廣告寫入管理員帳戶。
- 建立廣告系列—— 每次啟動會建立一個搜尋廣告系列，連同每日預算、地區定位、你所選每個受眾各一個廣告群組、每個群組一則回應式搜尋廣告，以及相關關鍵字。廣告系列、廣告群組與廣告，一律以
已暫停（PAUSED）狀態建立。 - 開啟與暫停廣告系列及廣告—— 你可以在 WittiGrow 介面內啟用或暫停廣告系列、廣告群組或個別廣告。詳見下文。
- 移除廣告與廣告系列—— 你可以在 WittiGrow 介面內移除個別廣告，或移除整個廣告系列。詳見下文。
- 讀取成效與設定—— 廣告系列、廣告群組與廣告的狀態、預算、現行廣告文案與關鍵字，以及最多約 90 日的每日成效數據（曝光、點擊、花費、轉換），讓介面反映你帳戶的真實情況，而不是我們最後一次寫入的內容。
- 關鍵字研究—— 你草擬廣告系列時，我們會呼叫 Google 的關鍵字規劃服務，建議關鍵字及出價估算。
WittiGrow 可以改動你帳戶內的哪些東西
以下是完整清單。每一項都必須由你在 WittiGrow 內按下按鈕才會執行，全部都不會定時執行，也不會在你沒有動作的情況下發生。
- 建立廣告系列及其預算、地區定位、廣告群組、回應式搜尋廣告與關鍵字 —— 一律先暫停。
- 啟用廣告系列。由於下層一旦暫停，廣告系列便無法投放，所以在 WittiGrow 啟用一個廣告系列，同時會啟用其廣告群組與廣告。這代表你的預算會開始花費。這是一個切換掣，沒有二次確認。
- 暫停廣告系列、廣告群組或個別廣告，同樣一按即成。
- 啟用個別廣告—— 若其所屬廣告群組或廣告系列仍在暫停中，我們不會靜靜替你開啟上層，而是先告知你上層處於暫停狀態，並徵詢你的同意。
- 移除個別廣告，或整個廣告系列。詳見緊接下文。
WittiGrow 可以刪除你 Google Ads 帳戶內的廣告系列
WittiGrow 的廣告系列清單設有刪除功能。它會對該廣告系列送出 Google Ads API 的 remove 操作，將其狀態設為 REMOVED。另有批量版本，可一次移除多個廣告系列。
- 此操作永久生效。已移除的廣告系列無法重新啟用 —— 無論在 WittiGrow 或在 Google Ads 皆不可以。其歷史數據仍會保留在你的 Google Ads 報表內。
- 同時會刪除我們自己的紀錄，包括我們為該廣告系列儲存的廣告文案與關鍵字。若在 Google Ads 的移除失敗，我們會保留紀錄，以免失去對一個仍在投放的廣告系列的追蹤。
- 此操作設有確認對話框，移除個別廣告亦然。啟用與暫停則沒有 —— 因為那些操作可以還原。
- 如果你只是想停止花費，請改用暫停。暫停完全可以還原。
WittiGrow 絕不會自行、定時或在任何自動流程中移除廣告系列或廣告。必須由真人按下刪除並確認。
哪些操作不需要你按任何按鈕
有兩項操作會自動讀取你的 Google Ads 帳戶，兩者都只讀取、不寫入：
- 每週帳戶檢查（每星期一香港時間上午 9 時），讀取廣告系列狀態與成效，讓你下次開啟介面時看到的是最新數據。
- 開啟 WittiGrow 的廣告頁面時，重新讀取我們已知廣告系列的狀態與成效 —— 包括你直接在 Google Ads 內所作的改動，例如你自行啟用了某個廣告系列。
除非你親自按下按鈕，WittiGrow 不會在你的 Google Ads 帳戶內建立、修改、啟用、暫停或移除任何東西。 沒有自動改動廣告系列，沒有自動調整預算，也沒有自動暫停。
OAuth 授權範圍
只有一個：https://www.googleapis.com/auth/adwords。
Google Ads 並未提供更細分的授權範圍。同一個授權範圍既涵蓋讀取你的帳戶，也涵蓋在帳戶內建立、修改及移除廣告系列、廣告群組、廣告與關鍵字 —— 正因如此，上文才要逐項列明我們實際會做什麼。
我們不會要求 Drive、Gmail、Cloud Platform 或個人檔案的授權範圍。
我們儲存什麼
- 你的 OAuth 存取憑證及更新憑證，儲存於我們在 Google Cloud 的資料庫。
- 你的 Google Ads 客戶編號、帳戶名稱、貨幣，以及管理員（MCC）標記。
- WittiGrow 所建立的每個廣告系列：其資源名稱、我們生成的廣告標題、描述與關鍵字、你設定的每日預算，以及最後已知狀態。
我們絕不儲存帳單資料或付款方式，亦不會將你的 Google Ads 帳戶資料送交任何人工智能模型。
在設定 → 平台連接中中斷連接，即會刪除已儲存的憑證，並停止一切對 Google Ads API 的存取。但這不會將 WittiGrow 從你 Google 帳戶的已授權應用程式中移除 —— 若要撤回授權本身，請前往 myaccount.google.com/permissions。已建立的廣告系列會留在你的 Google Ads 帳戶內，由你自行掌控。
客戶如何連接
在 WittiGrow 介面的設定 → 平台連接中操作：
客戶介面中的平台連接面板
廣告建立流程
連接後，你可在廣告分頁開啟 Google Ads 精靈。WittiGrow 會根據你自己的網站與產品分析提出受眾方向，由你挑選哪些要變成廣告群組。針對每一個，WittiGrow 會草擬回應式搜尋廣告的標題、描述與關鍵字，你可以逐項覆核及即時修改，然後才確認。確認後，我們會在你的帳戶內建立一個搜尋廣告系列 ——處於暫停狀態，並採用你所設定的每日預算。在廣告系列被啟用之前，不會有任何曝光，也不會花費一分一毫；啟用可以由你在 Google Ads 內進行，也可以由你在 WittiGrow 內用切換掣進行。
客戶介面中的廣告頁面 —— 廣告建立精靈的入口
保障措施
- WittiGrow 建立的一切都以
已暫停狀態開始，不會自行開始花費。 - 每日預算由你在建立時設定。WittiGrow 沒有任何程式路徑可以在事後調高、調低或改動 Google Ads 的預算 —— 要改預算，就要由你重新啟動一次。
- 對你帳戶的每一次寫入（建立、啟用、暫停、移除），都必須由你工作區中已登入的成員明確按下按鈕觸發，不會定時執行。
- 兩項破壞性操作 —— 移除廣告與移除廣告系列 —— 都設有確認對話框。
- 若要啟用一則上層仍在暫停中的廣告，我們會先徵詢你的同意，而不是把整個廣告系列順帶開啟。
- API 的使用受制於 Google 就該帳戶所核准的開發者權杖級別，以及 Google 就該級別公布的用量上限。
帳戶擁有權
你始終是使用你自己的 Google Ads 帳戶與你自己的付款方式。WittiGrow 不會用內部 MCC 代客戶投放廣告 —— 每個廣告系列都在你的帳戶內，你隨時可以直接在 Google Ads 內改動或移除，不論有沒有經過 WittiGrow。