获取自定义报告(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 有速率限制。过多的请求可能会触发限制，请稍后再试。