LSA 回應追蹤器
以打包的 CLI 作為資料攝取、指標計算與報告生成的唯一權威。其結果為回應時間與潛在客戶狀態的代理指標,並非 Google 官方的 LSA 回應數據。訊息時間在所需事件完整時精確;電話連線狀態則為近似值。
在收集資料前,請先閱讀連接器合約。使用操作手冊處理私人檔案、CLI 指令、退出碼意義及復原方式。
工作流程
- 根據能力而非供應商或工具名稱來發現一個即時連接器。它必須能夠對
local_services_lead_conversation執行原始 GAQL,接受選定的客戶,並返回包含分頁證據的完整資料列。不支援僅聚合的連接器。 - 檢查即時工具的 schema。識別其查詢與客戶參數、可選的管理員或登入客戶參數,以及分頁參數。請勿猜測參數名稱。
- 如果連接器支援帳戶發現,則列出或識別可存取的帳戶。否則,詢問使用者客戶 ID,並僅在 schema 要求時詢問登入客戶 ID。切勿在此技能、追蹤檔案或聊天輸出中放置識別碼或憑證。
- 對所選帳戶執行一個小型存取探測。如果驗證、客戶選擇、資源存取或分頁不可用,則停止並提供復原指引。
- 使用合約的明確欄位執行必要資源與欄位探測。僅在使用者明確同意時才請求選用的訊息文字欄位。如果結果僅聚合、缺少必要的返回欄位、回報錯誤、部分或不完整,則停止。
- 執行有界限的報告查詢並提取每個頁面,保留返回的欄位元資料與頁面權杖鏈。僅在具有明確且真實的完成證據時,才可接受連接器完整的已儲存結果。將原始回應與清單直接儲存至私密的本地檔案;切勿將真實資料列貼到聊天中。
- 對每個已儲存的回應執行
probeCLI 指令。若退出碼非零則不要繼續;請遵循操作手冊中的復原行動。 - 使用私密設定與私密輸出目錄執行
reportCLI 指令。呈現生成的報告,並重複代理指標、訊息與電話的注意事項。
絕不計算回退百分比或重複指標公式。絕不在聊天中摘要私密資料列的值。絕不在聊天中暴露憑證、存取權杖、客戶識別碼、訊息文字或連接器輸入/輸出檔案名稱。安裝收據只能包含安裝程式定義的套件與 CLI 路徑,絕不能包含連接器資料。
將已遷移到 Performance Max 按潛在客戶計費廣告活動的 LSA 帳戶視為未驗證,直到該帳戶通過即時存取探測、必要欄位探測、分頁檢查與 CLI 探測。此工具專為過渡期間設計,因為它讀取的是 Google Ads API 的潛在客戶對話資源,而非即將淘汰的獨立儀表板,但在未經直接驗證的情況下,請勿保證遷移後相容性不變。