Google Ads

Google Ads 是一個連接器：它把 MeDo 應用程式連接到一個 Google Ads 帳戶，讓應用程式可以列出可存取客戶、讀取成效報表、查找活動，並在確認後建立暫停草稿或暫停／啟用活動。應用程式看到的一切都來自你連接的帳戶。

#可以建立什麼

• 成效看板。 列出業主可存取的客戶，並依明確日期範圍顯示客戶、活動、廣告或關鍵字指標。
• 經理帳戶選擇器。 列出經理帳戶（MCC）下的子帳戶，並在其中一個客戶帳戶上打開報表——不要在經理帳戶本身查花費。
• 活動檢視頁。 以 ID 或精確名稱查找單一活動，確認後再暫停或啟用。
• 開投工作台。 預覽帶每日預算、廣告群組、文案、地域或轉換動作的暫停 Search 活動，確認後才建立。

當應用程式需要業主真實的廣告帳戶時，Google Ads 就很合適。它不是開戶工具、出價引擎，也不能讓每位訪客用自己的 Ads 帳戶登入，詳見限制。

#建立範例

把以下其中一段複製到提示框中。第一段是最小可用的起點。

Use @Google Ads to build a private website console that lists my accessible customers, then shows an account report for a selected customer and date range.

Use @Google Ads to build a private manager console that lists sub-accounts under my MCC and shows a campaign report for one client account.

Use @Google Ads to build a private campaign review page where I look up one campaign by ID or name and pause or enable it only after I confirm.

Use @Google Ads to build a private launch workspace that creates a paused Search campaign with a daily budget on my client account after I confirm the name and amount.

用詞很重要：說明這個工具給誰用、要完成什麼。「給帳戶業主使用的私人廣告控制台」與「一個列出活動的頁面」會產生完全不同的應用程式。

#準備與連接

你需要一個已經能打開目標 Ads 帳戶的 Google 帳戶。不需要 API 金鑰、Google Cloud 專案或帳單設定。MeDo 不能代你新開廣告帳戶、綁付款或完成廣告主核驗。

1. 點擊側欄的 Skills & Connectors（技能與連接器），然後搜尋 Google Ads。
2. 開啟 Google Ads 卡片並點擊 Connect（連接）。
3. 登入該 Google 帳戶，並同意 MeDo 要求的存取權限。流程也可能要求 Customer ID——有經理帳戶就填 MCC，否則填客戶帳戶 ID。
4. 按鈕變成 Connected（已連接） 即為成功，不需要把任何資訊複製回應用程式。

如果在連接前就開始建立，MeDo 會注意到，並在回覆下方顯示 Google Ads 連接按鈕。也可以改走上面的連接器卡片。若沒有按鈕，就用連接器卡片。

#在應用程式中使用

• 應用程式使用建立者連接的 Google Ads 帳戶，不是每位訪客自己的 Ads 帳戶。 能看到帳戶或報表的訪客，看到的都是同一個連接。這些頁面必須放在應用程式自己的登入之後，並限制給應有權限的人。標題寫「私人」本身不是存取控制。
• 報表與寫入都要落在客戶帳戶。 經理帳戶（MCC）ID 只用來列子帳戶。對經理帳戶查花費、點擊或改活動會失敗。請複製連接器回傳的 customer ID，不要自行編造。
• 可存取客戶清單不是完整的 MCC 樹。 它只列出該 Google 使用者能直接打開的帳戶。要在經理帳戶下選子帳戶，先列出子帳戶。
• 報表必須指定日期範圍。 關鍵字或廣告列為空，通常代表該區間沒有物件，不是連線失敗。
• 寫入都要先確認，而且不會自動重試。 MeDo 會預覽客戶、名稱、預算、狀態、文案或地域，等明確確認。結果不明時，先再讀帳戶，不要再建一筆。重試可能多出第二個活動、預算、廣告或轉換動作。
• 新建的 Search 活動、廣告群組與回應式搜尋廣告都會以暫停狀態建立。 啟用活動是另一次確認。
• 應用程式自己的筆記留在應用程式裡。 開投清單、審核狀態與備註應存在應用程式資料表，並以真實客戶、活動、預算或廣告群組 ID 為鍵，它們不是 Google Ads 欄位。

#限制與疑難排解

應用程式出現「Connection required」。 Google Ads 連接收歸應用程式業主。請業主打開連接器卡片並點擊 Connect，然後重新載入。

報表或寫入提示請求落在經理帳戶。 改用子帳戶清單裡的客戶 customer ID，不要對 MCC 送報表或活動變更。

寫入結果不明。 不要再按一次。先用名稱或 ID 查找活動或轉換。

訪客不該看到廣告資料時卻看得到。 連接是共用的。為應用程式加上登入與伺服器端限制，見管理存取與角色。

#相關內容

• 連接器目錄 — 其他連接器及其用途。
• 技能與連接器 — 技能如何調用、計價與限制。
• 管理登入與使用者 — 在公開已連接資料前，先給應用程式自己的帳戶。