Community研究與資料分析github.com

wvuhskr/lsa-回應追蹤器

從任何支援原始 GAQL 的 Google Ads 連接器,生成私密且可重現的在地服務廣告回應報告。

lsa-回應追蹤器 是什麼?

LSA 回應追蹤器是一個 CLI 工具,旨在從 Google Ads API 的 `local_services_lead_conversation` 資源中,收集並生成在地服務廣告 (LSA) 的回應時間與潛在客戶狀態代理報告。使用者需先透過一個能執行原始 GAQL 的連接器(如特定工具或腳本)來發現、檢查並提取資料,然後使用工具內建的 `probe` 與 `report` 指令處理這些原始回應,最終產出一份私密的報告。此工具特別適合從傳統獨立儀表板遷移到以潛在客戶計費的 Performance Max 廣告活動的帳戶,因為它直接讀取 Google Ads API 而非舊有介面。注意事項包括:這份報告僅為代理指標,並非 Google 官方的 LSA 回應數據;使用者必須遵守嚴格的流程以避免洩漏憑證、客戶 ID 或原始資料;且遷移後的相容性需通過所有驗證步驟才能確認。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add wvuhskr/lsa-responsiveness-tracker

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

LSA 回應追蹤器

以打包的 CLI 作為資料攝取、指標計算與報告生成的唯一權威。其結果為回應時間與潛在客戶狀態的代理指標,並非 Google 官方的 LSA 回應數據。訊息時間在所需事件完整時精確;電話連線狀態則為近似值。

在收集資料前,請先閱讀連接器合約。使用操作手冊處理私人檔案、CLI 指令、退出碼意義及復原方式。

工作流程

  1. 根據能力而非供應商或工具名稱來發現一個即時連接器。它必須能夠對 local_services_lead_conversation 執行原始 GAQL,接受選定的客戶,並返回包含分頁證據的完整資料列。不支援僅聚合的連接器。
  2. 檢查即時工具的 schema。識別其查詢與客戶參數、可選的管理員或登入客戶參數,以及分頁參數。請勿猜測參數名稱。
  3. 如果連接器支援帳戶發現,則列出或識別可存取的帳戶。否則,詢問使用者客戶 ID,並僅在 schema 要求時詢問登入客戶 ID。切勿在此技能、追蹤檔案或聊天輸出中放置識別碼或憑證。
  4. 對所選帳戶執行一個小型存取探測。如果驗證、客戶選擇、資源存取或分頁不可用,則停止並提供復原指引。
  5. 使用合約的明確欄位執行必要資源與欄位探測。僅在使用者明確同意時才請求選用的訊息文字欄位。如果結果僅聚合、缺少必要的返回欄位、回報錯誤、部分或不完整,則停止。
  6. 執行有界限的報告查詢並提取每個頁面,保留返回的欄位元資料與頁面權杖鏈。僅在具有明確且真實的完成證據時,才可接受連接器完整的已儲存結果。將原始回應與清單直接儲存至私密的本地檔案;切勿將真實資料列貼到聊天中。
  7. 對每個已儲存的回應執行 probe CLI 指令。若退出碼非零則不要繼續;請遵循操作手冊中的復原行動。
  8. 使用私密設定與私密輸出目錄執行 report CLI 指令。呈現生成的報告,並重複代理指標、訊息與電話的注意事項。

絕不計算回退百分比或重複指標公式。絕不在聊天中摘要私密資料列的值。絕不在聊天中暴露憑證、存取權杖、客戶識別碼、訊息文字或連接器輸入/輸出檔案名稱。安裝收據只能包含安裝程式定義的套件與 CLI 路徑,絕不能包含連接器資料。

將已遷移到 Performance Max 按潛在客戶計費廣告活動的 LSA 帳戶視為未驗證,直到該帳戶通過即時存取探測、必要欄位探測、分頁檢查與 CLI 探測。此工具專為過渡期間設計,因為它讀取的是 Google Ads API 的潛在客戶對話資源,而非即將淘汰的獨立儀表板,但在未經直接驗證的情況下,請勿保證遷移後相容性不變。

相關技能