giip
SES 商机登记
15分钟阅读

GA 分析报告指南

查看贵组织的 GA4 + Search Console 综合 AI 分析报告(核心内容),以及所选媒体资源/站点的最新指标与历史(辅助信息)。

🔗 打开 GA 分析报告 →

📋 概述

本页面分为两层:

  • 综合报告(核心) — 结合 GA4 与 Search Console 数据的 AI 分析。在右侧历史列表中点击过去的日期,可查看当时的报告;对喜欢的建议点击**“将此建议登记为 Issue”即可直接登记为 giip issue。开启其下方的“生成报告时自动登记 issue”**开关后,此后每次生成新的综合报告都会自动将其建议登记为 giip issue(开启时,当前显示的最新报告若尚未登记,也会立即登记 1 条)。开关关闭时,仍可照旧使用手动登记按钮。
  • 单独的 GA4 / GSC 面板(辅助) — 综合报告下方分别显示各媒体资源的最新指标(KPI 卡片)、最近每日历史表,以及 GSC 热门搜索词。这些面板不再单独生成 AI 分析(上方的综合报告是唯一的最终分析),仅供直接查看原始数字时参考。

✅ 前提条件

  1. GA4 媒体资源与(可选)Search Console 站点需已在您的组织注册 — 见 GA 媒体资源管理、GSC 站点。若任一来源未注册,综合报告会为该项显示“需要设置”的链接。
  2. 采集正在运行,已有数据(见下方“设置采集”)。

🔎 查看报告

  1. 打开页面后综合报告会自动加载。点击右侧历史列表中的日期可切换到当天的报告,点击“返回最新”可回到最新报告。
  2. 若要查看单项指标,请在下方的 GA4/GSC 面板中从下拉框选择已注册的媒体资源/站点(或手动输入)。

📊 指标

指标含义
活跃用户去重活跃用户
会话会话数
页面浏览量屏幕/页面浏览量
跳出率单次交互会话占比(以 % 显示)
转化次数转化事件
平均会话(秒)平均会话时长(秒)
点击次数 / 展示次数 (GSC)Search Console 搜索结果的点击/展示次数
CTR / 平均排名 (GSC)点击率(%) / 平均搜索排名

🤖 AI 如何区分页面

综合报告背后的 AI 会读取每个 URL 路径,自动区分营销/公开页面(访客无需登录即可查看的落地页、博客等)与登录后的产品/管理界面(如仪表盘、仅管理员可见的页面)。后者会被自动排除在“转化入口”相关的批评之外。

如果自动分类与贵组织的实际情况不符(例如刻意将部分公开页面设为无需登录),或希望 AI 更好地体现贵公司自身的服务方向与目标客户,可在 管理员 > Gareport AI 自定义提示词 中输入仅适用于本组织(csn)的附加说明。该说明不会替代全局规则,而是附加在其后。

🔍 AEO/GEO 就绪度

按 8 个项目检查搜索引擎、答案引擎与生成式 AI 是否容易引用我们的页面结构,并给出每个页面的分数。该面板显示在综合报告下方。

检查的 8 个项目

项目看什么
结构化 FAQ问题与回答是否以机器可读的形式写在页面里
作者撰写者个人或组织的名称,以及可核实的地址是否都已写明
组织发布页面的组织名称,以及主地址或标识是否已写明
日期发布日与更新日是否以机器可读的形式存在,且彼此不矛盾
来源正文是否有指向外部站点的依据链接,且这些来源是否没有只集中在一处
可比较信息正文是否有真正能比较的表格(有表头行,且比较对象在两个以上)
数值与依据正文里的每个数值是否都附带期间、来源或依据链接
实体关系这个页面所讲的对象是否与外部的对应标识建立了关联

每个项目判定为达标(2 分)/ 部分达标(1 分)/ 缺失(0 分),无法判定的项目则从分数中排除。

怎么读这个分数

  • 一定要和 已判定 n/8 一起看。 只看分数是不够的:分数的含义是"在已判定的项目中拿到了可得分数的百分之几",而分母是几个只写在旁边的 已判定 n/8 里。
  • 这不是整站分数。 测量对象是搜索流量较高的页面(每次最多 20 个),其余页面不测量。因此我们也不会把页面分数求平均当作"本站分数"。
  • –(从分数中排除)与 0(缺失)不同。 0 是"已读取页面且确实没有这个要素"这一事实,– 则表示"没有判定"。把读不到的页面算作 0 分,等于报告一个不存在的缺陷,所以我们不这么做。
  • 各项目的分母可能不同。 正文完全没有数值的页面,"数值与依据"这一项本就按不适用排除。所以即使测量了 10 个页面,"数值与依据"的已判定页面也可能只有 6 个。这正是按项目汇总的表格不设百分比列的原因。
  • 等级(A/B/C、好与坏)、与行业平均的对比、百分位都不提供。 唯一的比较是同一页面自己过去的测量值。

测量每周一次

测量每周日执行一次。刚修改完内容不会立即反映,分数从下一次测量开始变化。面板上方的测量日期告诉你这些值是什么时候测的;若该日期已超过 14 天,面板会同时提示"之后的内容变更未纳入"。

AEO 不是分数,而是以报告叙述的形式给出

对问题的直接回答、明确的事实、服务定义、术语定义、案例 — 这 5 项不产生分数。 而是由 AI 在综合报告正文中判断,并带上 [EXPERT_HYPOTHESIS](专家假设)标记,写成"应该在哪个页面的哪个小标题下补什么"。

不给分数的原因是:这不是重测也会给出同一答案的测量。 8 个项目是机器照着页面结构直接数出来的,重复执行结果相同。而"这一段是否直接回答了问题"属于解读,若每次执行答案都变,分数走势就失去意义。因此 8 项计分、5 项叙述。报告中原样引用测量值的地方会带 [MEASURED](实测)标记。

看不到分数时

现象原因处理
"暂无 AEO/GEO 测量数据"该组织还从未运行过每周一次的测量确认已注册 GSC 站点或 GA4 媒体资源,然后等待下一次测量。
某个页面不在列表里测量对象只有搜索流量较高的页面 — 其余页面不测量等该页面积累了搜索流量,之后的测量就会把它纳入。
分数栏显示"未能测量 — 无分数"未能读取页面 — 地址不存在(4xx)、抓取失败,或 robots.txt 禁止采集查看"抓取"列显示的原因,检查地址、连通性与 robots.txt。
分数栏显示"判定项目不足 — 无分数"页面读到了,但 8 项中能判定的不足 6 项说明结构化数据为空,或未能确定正文区域。仅靠 JavaScript 渲染的页面,其结构化数据我们读不到。
项目栏显示 –该页面本就没有这一项的测量对象(例如正文数值为 0 个)这不是缺陷,它会从分数的分母中排除。

⚙️ 设置采集 (管理员)

指标由 GIIP 代理/服务器采集,并由 AI 定期综合分析。一次性设置:

  1. 注册 GA4 媒体资源(GA 媒体资源管理)与注册 GSC 站点(GSC 站点) — 两个数据源都需注册,综合报告才完整。
  2. 服务账号密钥 — 创建具有 GA4 读取权限的 Google 服务账号并将媒体资源共享给它。将密钥 JSON 放置于 giipdb mgmt/ga-collector.config.json.sample 中 serviceAccountKeyFile 字段指定的路径(实际路径: giipdb/.secrets/ga-service-account.json,gitignore)。giipfaw 的 ProcessGaCollect 读取此文件并直接调用 Google Data API。
  3. 采集作业 — giipfaw 的定时函数(ProcessGaCollect)通过读取 DB(tGaConfig) 中注册的活动媒体资源列表自动执行采集。无需单独的 PC/代理部署。CQE 指南 和 giipdb docs/30_Specs/CQE_SPECIFICATION.md 仅适用于旧版基于代理的采集方式。
  4. AI 分析(综合) — giipfaw 的 ProcessComboReport 会同时读取 GA4 与 GSC 数据并生成综合报告。若样本量过小(例如访客数不足),报告会一并注明该限制。

采集运行后本页会自动填充。

故障排除

现象原因解决
“暂无报告”综合报告批处理尚未运行确认采集/设置状态,并等待下次运行。
出现“需要设置”链接GA4 媒体资源或 GSC 站点其中之一未注册通过提示的链接(GA 媒体资源管理 / GSC 站点)完成注册。
媒体资源/站点下拉框为空该组织无已注册媒体资源/站点在对应管理页面中注册。
403 / 访问被拒无该媒体资源组织的权限使用您所属的组织。
AI 分析误解了我们的服务结构自动页面分类未覆盖本组织的特殊情况在 Gareport AI 自定义提示词页面中补充说明。

🔌 供 AI 使用的最新数据查询 API

这是一个只读 API,让外部 AI 无需解读界面或登录 Google 账号,仅凭组织标识值(csn)与该组织的密钥(SK),即可一次读取 GIIP 已采集的 GA4/GSC 最新快照与综合报告。它不包含任何重新采集、重新分析或修改设置的功能。

⚠️ 范围限制: 此 API 仅提供最新的一份快照,不包含界面上的历史列表(按日期查看的历史报告)或完整的每日历史表格 — 只能查询最近一次采集/生成的数据。若需要按日期查看的历史报告或每日历史数据,请使用下方的 供 AI 使用的历史(按日期多条)查询 API(giipGareportHistory)一节。

请求

项目值
方法GET
URLhttps://giipfaw.azurewebsites.net/api/giipGareportSnapshot?csn={CSN}
头部x-api-key: {SK}
参数仅一个正整数 csn

成功响应 (HTTP 200)

{
  "csn": 47,
  "retrievedAt": "2026-09-01T00:00:00Z",
  "sources": {
    "gsc": { "status": "READY", "siteCount": 1 },
    "ga4": { "status": "READY", "propertyCount": 1 },
    "combinedReport": { "status": "READY" }
  },
  "gscSites": [ { "siteUrl": "...", "label": "...", "collectedAt": "...", "data": { } } ],
  "ga4Properties": [ { "propertyId": "...", "label": "...", "collectedAt": "...", "data": { } } ],
  "combinedReport": { "reportId": 0, "generatedAt": "...", "dataSources": "ga+gsc", "missingConfig": null, "language": "zh-CN", "content": "## 1. 当前状况\n最近28天的活跃用户比前28天增长了12%...\n\n## 2. 今日核心瓶颈\n落地页A的跳出率高达78%,阻碍了流量转化...\n\n## 3. 依据\n[MEASURED] ...\n\n## 4. 现在应执行的操作\n对象: /pricing ...\n\n## 5. 暂缓判断\n..." }
}
  • gscSites[].data 原样保存该站点的最新 GSC 原始 JSON(totals、topQueries、topPageQueries、date、range、collectedAt、source)。
  • ga4Properties[].data 是该媒体资源的最新 GA4 原始 JSON 对象,包含以下字段(依据 giipfaw ProcessGaCollect 的采集结构):
    • propertyId、range(采集对应日期)、collectedAt、source
    • metrics: activeUsers、sessions、screenPageViews、bounceRate、conversions、averageSessionDuration
    • topPages: 按浏览量排名前 10 的页面数组 — 每项包含 pagePath、screenPageViews、bounceRate、averageSessionDuration
    • landingPages: 按会话数排名前 10 的落地页数组 — 每项包含 landingPage、sessions、bounceRate
    • events: 按发生次数排名前 20 的事件数组 — 每项包含 eventName、eventCount
    • coreWebVitals: 仅当同时设置了站点 URL 和组织自有的 PageSpeed API 密钥时才有值,否则为 null。有值时,mobile/desktop 各自包含 performanceScore、lcpMs、clsScore、inpMs、fcpMs、ttfbMs
    • periods: 按比较周期(current_3d、current_7d、current_28d、previous_28d、current_90d)分组的 startDate/endDate/metrics(该周期采集失败时为 null)
  • combinedReport 是最新的一份综合报告(若无则为 null)。content 是如上所示由 5 个部分(当前状况/今日核心瓶颈/依据/现在应执行的操作/暂缓判断)组成的 Markdown 字符串 —— 以上示例仅用于展示结构,实际取值因组织与周期而异。
  • gscKeyJson、gaKeyJson、Google 服务账号密钥、SK、AK、数据库连接信息都不会包含在任何响应中。

错误响应

错误正文始终为 { "error": { "code": "...", "message": "..." } } 格式。

条件HTTPerror.code
SK 缺失或无效401UNAUTHENTICATED
SK 无法访问请求的 csn403FORBIDDEN_CSN
csn 缺失、非数字或 ≤ 0400INVALID_CSN
服务器或数据库错误500INTERNAL_ERROR

调用示例 (不含真实密钥,使用环境变量)

export GIIP_API_BASE_URL="https://giipfaw.azurewebsites.net"
export GIIP_CSN="47"
export GIIP_SK="仅在运行时设置"

curl --fail-with-body \
  -H "x-api-key: ${GIIP_SK}" \
  "${GIIP_API_BASE_URL}/api/giipGareportSnapshot?csn=${GIIP_CSN}"

⚠️ 安全: 不要将 SK 放入 URL、Issue、代码仓库、提示词正文或日志。只能从运行时环境变量或密钥存储中传递。

状态值与 AI 应采取的行动

GSC 数据通常延迟两到三天(Google 确定延迟)。

状态含义AI 应采取的行动
READY有活动媒体资源且有最新采集的原始数据将该数据作为事实进行总结
NOT_CONFIGURED该 csn 无活动媒体资源不要臆测,原样报告为“未配置”
NO_DATA有活动媒体资源但无最新采集数据不要臆测,原样报告为“无数据”

AI 调用固定流程

  1. 只查询一次快照。
  2. 先检查 sources 中的每个状态。
  3. 只将 READY 的数据作为事实总结,NOT_CONFIGURED/NO_DATA 不臆测、原样报告。
  4. 将综合报告的 content 视为建议,将 GSC/GA4 data 中的数字视为事实数据,两者区分对待。
  5. 若需要历史报告或每日历史数据,请改用下方的历史(按日期多条)查询 API(giipGareportHistory),而非此快照 API —— 快照负责"当前最新状态",历史 API 负责"某一时间范围内按日期的变化"。

🔌 供 AI 使用的历史(按日期多条)查询 API

与上方快照 API 只返回"最新一份"不同,这个只读历史 API 会返回某一时间范围(from/to)内的综合报告以及 GA4/GSC 每日原始数据,一次多条(分页)。当需要按日期判定"截至昨天采集是否正常"时,就使用此 API。与快照 API 一样,它不含任何重新采集、重新分析或修改设置的功能。

请求

项目值
方法GET
URLhttps://giipfaw.azurewebsites.net/api/giipGareportHistory?csn={CSN}&from={YYYY-MM-DD}&to={YYYY-MM-DD}&page={N}&pageSize={N}
头部x-api-key: {SK}
参数必填含义
csn必填组织编号(正整数)
from可选查询起始日(YYYY-MM-DD)。省略时为 to 往前 30 天
to可选查询结束日(YYYY-MM-DD,含当日)。省略时为今天(UTC)
page可选从 1 开始的页码。省略时为 1
pageSize可选每页条数。省略时为 30,最大 100(超出按 100 限制)

page/pageSize 会分别独立地应用于综合报告历史以及各 GA4 媒体资源、GSC 站点的每日历史(按来源分窗口)。每个来源各自返回自己的 totalCount/hasMore(或 combinedReportPagination)元数据。

成功响应 (HTTP 200)

{
  "csn": 47,
  "retrievedAt": "2026-10-30T00:00:00Z",
  "from": "2026-09-30",
  "to": "2026-10-30",
  "page": 1,
  "pageSize": 30,
  "combinedReportPagination": { "page": 1, "pageSize": 30, "totalCount": 12, "hasMore": false },
  "combinedReportHistory": [
    { "reportId": 0, "generatedAt": "2026-10-30T00:00:00Z", "dataSources": "ga+gsc", "missingConfig": null, "language": "zh-CN", "content": "## 1. 当前状况 ...\n## 2. 今日核心瓶颈 ...\n## 3. 依据 ...\n## 4. 现在应执行的操作 ...\n## 5. 暂缓判断 ..." }
  ],
  "gscSites": [
    { "siteUrl": "...", "label": "...", "totalCount": 30, "page": 1, "pageSize": 30, "dailyHistory": [ { "collectedAt": "2026-10-29T00:00:00Z", "data": { } } ] }
  ],
  "ga4Properties": [
    { "propertyId": "...", "label": "...", "totalCount": 30, "page": 1, "pageSize": 30, "dailyHistory": [ { "collectedAt": "2026-10-29T00:00:00Z", "data": { } } ] }
  ]
}
  • combinedReportHistory[] 以从新到旧的多条形式保存该时间范围内的综合报告。每个 content 都是与快照 API 相同的由 5 个部分(当前状况/今日核心瓶颈/依据/现在应执行的操作/暂缓判断)组成的 Markdown 字符串 —— 以上示例仅用于说明结构,实际取值因组织与周期而异。
  • gscSites[].dailyHistory[].data / ga4Properties[].dailyHistory[].data 是该日期的 GSC/GA4 原始采集 JSON,与快照 API 的 data 字段结构相同(GA4 含 metrics、topPages、landingPages、events、coreWebVitals、periods 等,GSC 含 totals、topQueries、topPageQueries、date、range 等)。区别仅在于不是"最新一份",而是"时间范围内按日期的多条"。
  • collectedAt 是该每日记录的采集时刻(UTC)。按日期判定是否已采集,依据此值以及 data 中的 date/range。
  • gscKeyJson、gaKeyJson、Google 服务账号密钥、SK、AK、数据库连接信息都不会包含在任何响应中。

错误响应

错误正文始终为 { "error": { "code": "...", "message": "..." } } 格式(与快照 API 相同)。

条件HTTPerror.code
SK 缺失或无效401UNAUTHENTICATED
SK 无法访问请求的 csn403FORBIDDEN_CSN
csn 缺失、非数字或 ≤ 0400INVALID_CSN
from/to 格式错误或 from > to400INVALID_DATE_RANGE
page 非整数400INVALID_PAGE
pageSize 非整数400INVALID_PAGE_SIZE
服务器或数据库错误500INTERNAL_ERROR

调用示例 (不含真实密钥,使用环境变量)

export GIIP_API_BASE_URL="https://giipfaw.azurewebsites.net"
export GIIP_CSN="47"
export GIIP_SK="仅在运行时设置"

# 最近 7 天历史(按日期确认是否截至昨天已采集时使用)
curl --fail-with-body \
  -H "x-api-key: ${GIIP_SK}" \
  "${GIIP_API_BASE_URL}/api/giipGareportHistory?csn=${GIIP_CSN}&from=2026-10-23&to=2026-10-29&page=1&pageSize=30"

⚠️ 安全: 不要将 SK 放入 URL、Issue、代码仓库、提示词正文或日志。只能从运行时环境变量或密钥存储中传递。

AI 调用固定流程 (采集缺失判定)

  1. 设定判定范围: 若要查看"截至昨天是否已采集",将 to 设为昨天日期,from 设为足够早的过去(例如 7 天前)进行查询。
  2. 按来源确认日期: 在 ga4Properties[]、gscSites[] 各项的 dailyHistory[] 中,确认 collectedAt(或 data 的 date/range)是否包含昨天日期。
  3. 缺失判定: 若活动媒体资源/站点已注册(即对应数组中有项),却没有任何昨天日期的每日历史,则报告为"采集缺失"。但 GSC 通常延迟 2~3 天(Google 确定延迟)属正常,因此 GSC 的缺失判定需将此延迟计入(GA4 几乎无延迟)。
  4. 遍历所有 csn: 对账号可访问的每个 csn 重复 1~3。管理员 SK 可访问所有 csn,普通 SK 仅能访问自己的 csn(请求其他 csn 时返回 403)。
  5. 区分事实/建议: combinedReportHistory[].content(综合报告)是建议,dailyHistory[].data 中的数字是事实数据 —— 采集缺失判定必须依据后者(事实数据)的日期有无来进行。

版本: 1.7 最后更新: 2026-10-30 变更记录: giip 4313 —— 新增"供 AI 使用的历史(按日期多条)查询 API"(giipGareportHistory)一节(含按日期范围判定采集缺失的流程),并将快照 API 一节中"无法查询历史"的表述更新为指向历史 API。 / giip #4023 —— 新增"AEO/GEO 就绪度"章节(检查的 8 个项目、把分数和 已判定 n/8 一起读、–(排除)与 0(缺失)的区别、每周一次的测量、AEO 为何以报告叙述而非分数给出、看不到分数时怎么办)。 / giip 2709 —— 为综合报告新增“生成报告时自动登记 issue”开关(开关关闭时保留手动登记按钮)。 / giip #2068 —— 明确说明该 API 仅提供最新的一份快照,补充 ga4Properties[].data 的实测字段结构,并扩充了 combinedReport.content 示例。 源文件: giipv3/public/help/gareport.zh-CN.md