ContactLoop

內部上手指南 · 請先登入

沒有密碼?請向管理員索取。

SW Manager 功能說明

Google Offline Conversions:把轉換回傳給 Google Ads

每天早上把轉換整理成 Google 的 offline conversion 格式,寫進一份 Google Sheet,Google Ads 再從 Sheet 讀進去。

💡

為什麼要回傳給 Google:大部分廣告點擊不會在網頁上直接成交,真正有價值的是之後的通話。把這些通話(用 GCLID 對應到原本的點擊)回傳給 Google,Google 就能往會帶來真實 lead 的點擊去最佳化,而不只是看表單填寫。

三個分頁

  • Overview —— 目前的設定和每天的檔案。
  • GCLID coverage —— 新進的 contact 有沒有帶 click ID。
  • Settings —— 修改設定(三個步驟)。

還沒設定過的帳號只會看到設定精靈,不會有三個分頁。帳號沒有任何 conversion 時,會顯示「沒有可以匯出的 conversion」。

Overview — 目前生效的設定

項目意思
狀態標籤Active — generating daily / Inactive(關掉了,或沒有勾選 conversion)/ Not connected(Sheet 還沒連好)。
Committed第一次存檔的日期,之後再改設定也不會變。
Conversions sent勾選了幾個 conversion。
Rolling window往回 N 天(1–90),包含今天,而且是累積的 —— 每次都送整段時間的資料。
Runs每天 06:00 太平洋時間自動跑。每個帳號會再隨機延後 0–30 分鐘。如果到 07:30 還沒開始,那天的排程就跳過。

Edit configuration 會跳到 Settings 第 1 步。

Publish now

立刻產生一份新檔案,並整份覆蓋 Sheet。沒有確認視窗 —— 按下去之後每 3 秒檢查一次,最多等 120 秒,結果顯示在按鈕旁邊。沒有次數限制,但同一個帳號同時只能跑一個,撞到的話會標成 Skipped。沒有連結 Sheet 時會出錯:「no connected Google Sheet」。

⚠️

只有開了 flag 的環境看得到這個按鈕(staging、CL1),正式環境不會出現。

Daily files — 每日檔案

每天跑一次留一筆紀錄,同一天跑了不只一次的可以展開來看。

Status意思
Delivered成功寫進 Sheet。
Written, not verified寫進去了,但回頭檢查沒有通過。
Failed失敗,滑過去可以看原因,例如 CLP 沒有寫入權限。
Skipped跳過 —— 沒有勾選 conversion、算出來沒資料、太晚開始、或撞到另一個正在跑的。算出來是空的時候不會覆蓋 Sheet。
In progress正在跑。

Latest 標在最新一筆成功送達的檔案上,不一定是最上面那一列。
With GCLID % = 放進檔案的列數 ÷(放進去的 + 沒有 contact 的 + 沒有 click ID 的),算的是整個時間範圍,不是最近 24 小時。
Download 下載 CSV,檔案保留 90 天,過期後顯示 Expired。

File format — 固定 8 個欄位

第一列會自動寫入欄位名稱。

  1. Google Click ID / GBRAID / WBRAID —— 只會填其中一個,優先順序 GCLID → GBRAID → WBRAID,從 contact 的 custom.gclid / gbraid / wbraid 讀取。
  2. Conversion Name
  3. Phone —— E.164 格式(+1…)。Ava 的號碼如果不是美加格式,這欄會是空的。
  4. Conversion Time —— 格式像 2026-08-13 14:05:00-07:00。
  5. Conversion Value —— 整數。
  6. Conversion Currency —— USD。金額空白的話,這欄也是空白。
⚠️

沒有 click ID 或沒有 contact 的轉換,不會放進檔案。這就是為什麼要盯 GCLID coverage。

Sheet 的兩種權限

要兩個條件都成立,Google 才拿得到資料:

  • CLP write —— 系統用 service account 寫入 Sheet,需要編輯權限。如果權限被拿掉、Sheet 被刪、找不到 Conversions 分頁,排程那次會失敗,連線會被標成 error。CLP 沒有寫入權限就不能繼續,按鈕停用時滑過去會看到原因。
  • Google read —— 使用者要把 Sheet 用 Viewer 權限分享給 Google Ads 提供的 …@partnercontent.gserviceaccount.com(在 Google Ads 的 Uploads 畫面找得到),然後自己勾確認。
⚠️

系統沒有去 Google 檢查,只會記下誰在什麼時候確認的,Undo 可以取消。而且沒確認也可以繼續 —— 所以這一項做了沒做,畫面上看不出真假。

GCLID coverage

檢查最近 24 小時新進的 contact 有沒有帶 click ID。狀態完全由後端計算,前端只負責顯示。這個表格只是標示,不會發任何通知。

怎樣算有覆蓋:contact 的 custom.gclid、custom.gbraid、custom.wbraid 任一個是非空字串就算。

⚠️

放在最外層的 gclid 不算 —— 一定要在 custom 底下。

什麼是「有足夠的歷史資料」:看 24 小時之前的 7 天,至少 50 個 contact 有 click ID,而且比例 ≥ 20%。

判斷順序(由上往下,符合就停):

  1. 0 個新 contact → No new contacts
  2. 沒有足夠歷史資料,而且有 click ID 的比例 < 1% → Set up GCLID(代表客戶可能根本還沒開始送)
  3. 有足夠歷史資料、新 contact ≥ 20、缺少比例 > 10% → Investigate(紅)
  4. 其他 → OK(綠),或是 Not enough data
💡

邊界值例子(有足夠歷史資料時):20 個缺 2 個(10%)→ OK;20 個缺 3 個(15%)→ Investigate;19 個全缺 → Not enough data。剛好 10% 不算。

表格欄位:New (24h) 是往回滾動 24 小時內新建立的 contact 數(已刪除的不算);With GCLID 是其中有 click ID 的數量;Missing 是沒有的數量;% missing = Missing ÷ New。

Set up GCLID 會開 API 文件的 gclid 段落(/doc/contacts-v2#gclid):要放在 custom.gclid、不送也不會出錯(contact 照樣會建立,只是不能回傳給 Google)、值要原封不動轉送不要截斷。

Settings — 三個步驟

What to send → Deliver → Review & commit。前一步的條件沒有滿足就不能按繼續。從 Overview 按 Edit configuration 進來,一律從第 1 步開始。存檔後從下一次早上的排程開始生效。

第 1 步 — 選要送什麼

第一次設定時,Primary 的 conversion 會預設被勾選。一個都沒勾就不能繼續,提示是「Include at least one conversion — an empty file would clear the sheet Google reads.」Created 和 Last seen 可以幫你分辨哪些 conversion 還在用、哪些已經沒在用。

⚠️

這裡的 Last 7 days 用的是瀏覽器所在地的時區,跟 Define 頁(太平洋時間)可能對不起來。

Rolling window:每份檔案往回放幾天的資料。1–90 的整數,預設 90,超出範圍顯示「Enter a whole number between 1 and 90 days.」是累積的 —— 每天的檔案都包含整段時間的資料,包含今天。

第 2 步 — Deliver

CLP 會把每天的檔案寫進這份 Sheet 的「Conversions」分頁。第一次設定時用網址連結一份現有的 Sheet,也可以從範本建一份新的。Change 只是重新打開輸入網址的地方 —— 真的換成另一個網址之前,原本的連線和確認都會保留。換成另一份 Sheet 之後,Google read 的確認會被清掉。

Re-check access 會立刻檢查一次:可以寫入就變成 Granted;沒有權限、找不到 Sheet、找不到分頁就變成 error。另外兩種送法(下載檔案、HTTPS)是 Coming soon。

第 3 步 — Review & commit

預覽只顯示前 3 列。「≈ N rows」是估計的上限,實際列數可能比較少,因為沒有 click ID 的會被拿掉。估計超過 100,000 列會跳警告 —— 還是可以存檔,但之後每天的排程會被跳過。估計是 0 列時顯示「Nothing to send yet」。預覽載入失敗不影響存檔。

按 Save & commit — generate daily 存檔。成功後回到 Overview 並立即生效,下一次早上的排程就會用新的設定。失敗時顯示後端的錯誤訊息,或是「The configuration could not be saved.」後端也會再檢查一次:至少 1 個 conversion、必須是這個帳號的、天數 1–90。

來源:同事提供的 Conversion Tracking 說明(2026-10-06),逐條對照後整理。相關畫面見介面導覽的 Google Offline Conversions 面板;轉換怎麼定義見 Conversions。