獲取自定義報告(Get Custom Report)：可自定義的 Google Analytics 報告，可指定指標和維度獲取自定義 Google Analytics 報告（可指定指標和維度）
- 參數說明：
  - propertyId(必填): Google Analytics 屬性 ID (例如: 42XXXXX01)
  - startDate(必填): 開始日期 (格式: YYYY-MM-DD)
  - endDate(必填): 結束日期 (格式: YYYY-MM-DD)
  - dimensions (可選): 查詢的維度 (例如: country, city, pagePath, sessionSource)
  - metrics(必填): 查詢的指標 (例如: activeUsers, active1DayUsers, active7DayUsers, active28DayUsers)
  - limit(可選): 限制結果數量，默認為50

📌 提示：更多維度和指標可參考 Google Analytics API 文檔。

獲取活躍用戶數據(Get Active Users Data)：獲取活躍用戶數據（1 天、7 天、28 天）
- 參數說明：
  - propertyId(必填): Google Analytics 屬性 ID (例如: 42XXXXX01)
  - startDate(必填): 開始日期 (格式: YYYY-MM-DD)
  - endDate(必填): 結束日期 (格式: YYYY-MM-DD)
  - limit(可選): 限制結果數量，默認為50

配置步驟

Google Analytics 技能集依賴 Google Cloud 服務帳戶憑證(Google Credentials)。可參考以下步驟配置：

訪問 Google Cloud 控制台並登錄或創建帳戶。
創建一個新項目或選擇現有項目。
啟用 Analytics Data API：
- 在 Google Cloud 控制台中，轉到 "APIs & Services" > "Library"
- 搜尋 "Analytics Data API"
- 點擊它並啟動 "Enable"
創建服務帳戶：
- 轉到 "IAM & Admin" > "Service Accounts"
- 點擊 "Create Service Account"
- 給它起一個名字，如 "bika-analytics"，然後點擊 "Create"
- 分配 "Viewer" 角色，點擊 "Continue" 然後 "Done"
創建並下載憑證：
- 點擊您的新服務帳戶
- 轉到 "Keys" 標籤
- 點擊 "Add Key" > "Create new key"
- 選擇 "JSON" 並點擊 "Create"
- 安全地保存下載的 JSON 文件
在 Google Analytics 中授予權限：
- 轉到 Google Analytics
- 點擊 "Admin"（齒輪圖標）
- 選擇包含您要訪問數據的媒體資源的帳戶
- 在 "Account" 部分下選擇 "Account Access Management"
- 點擊 "+" 按鈕，添加服務帳戶的郵箱（來自 JSON 文件中的 client_email 字段）
- 分配 "Viewer" 權限
獲取您的 Google Analytics Property ID：
- 在 Google Analytics 中，點擊 "Admin"（齒輪圖標）
- 選擇 "Property" > "Property details"
- 複製 "PROPERTY ID: 42XXXXX01" ，稍後在與AI的對話中或 Prompt 中作為參數使用(示例見步驟 2)。

⚠️ 如果設置過程複雜，您也可以參考 Google Analytics 智能體模板文檔獲取更詳細的操作示例。

使用示例

讓 AI 生成自定義分析報告：

示例提示："查看用戶總數"

metrics: totalUsers 為用戶總數，直接告訴AI可以避免可能存在的錯誤，這取決於 LLM 對於 Google Analytics 的理解能力。

示例提示："按國家分類分析過去一個月的頁面瀏覽量和會話數"

分析瀏覽量和會話數 metrics：screenPageViews、sessions

📌 提示：

讓 AI 獲取用戶活動指標：

示例提示："顯示活躍用戶數"

顯示活躍用戶數

Q: 連線失敗怎麼辦？ A: 請檢查 JSON 是否完整貼上、是否添加了多餘符號，或服務帳戶信箱是否已配置權限。

Q: 功能無法使用怎麼辦？ A: 請確認在配置頁面上已啟用並儲存了相應技能。

Q: 呼叫受限怎麼辦？ A: Google Analytics API 有速率限制。過多的請求可能會觸發限制，請稍後再試。

示例提示："顯示活躍用戶數"

顯示活躍用戶數

Q: 連線失敗怎麼辦？ A: 請檢查 JSON 是否完整貼上、是否添加了多餘符號，或服務帳戶信箱是否已配置權限。

Q: 功能無法使用怎麼辦？ A: 請確認在配置頁面上已啟用並儲存了相應技能。

Q: 呼叫受限怎麼辦？ A: Google Analytics API 有速率限制。過多的請求可能會觸發限制，請稍後再試。