GA 媒体资源管理指南

注册和管理组织的 GA4 媒体资源,以便在 GIIP 中采集、分析和展示。

🔗 打开 GA 媒体资源管理 →

📋 概述

GIIP 按媒体资源(property)采集 Google Analytics 4(GA4)指标。采集或查看数据前,必须在本页将每个 GA4 媒体资源注册到您的组织(CSN)。一个组织可注册多个。

🔑 谁可以管理

属于该组织(CSN)的任何用户都可查看和管理其 GA 媒体资源。权限在服务端强制,无需单独的管理员角色。

🧭 查找 GA4 媒体资源 ID

1. 打开 Google Analytics → 管理(齿轮)。
2. 在媒体资源下打开媒体资源详情。
3. 复制媒体资源 ID(例如 123456789)。
4. 在 GIIP 中以 properties/123456789 格式输入(保留 properties/ 前缀)。

⚠️ 媒体资源 ID 与衡量 ID 不是一回事 — 容易混淆

GA4 中有两个名字相近的 ID,用途完全不同。

	媒体资源 ID	衡量 ID
格式	纯数字(例如 123456789)	以 G- 开头的字符串(例如 G-RD96JF3S6Q)
查看位置	管理 → 媒体资源 → 媒体资源详情	管理 → 数据流 → 点击对应的网站数据流
使用位置	GIIP 的"GA 媒体资源"输入框(properties/<数字> 格式)。GIIP 采集器调用 GA4 Data API 时使用。	网站中嵌入的 gtag 代码片段(如 giipv3/src/app/layout.tsx 中的 GA_ID)。访问者浏览器实际发送事件时使用。

两者必须指向同一个媒体资源。 一个媒体资源下可以有多个数据流,每个数据流都有自己的衡量 ID——仅凭"媒体资源 ID"无法判断实际网站是否正在向该媒体资源发送数据。

真实案例(giip-911/912)：在 GIIP 中注册的媒体资源 ID 是对的,但网站的 gtag 衡量 ID 指向了另一个(旧的)媒体资源,导致 GIIP 查询的媒体资源里从未收到过该网站的流量(反而显示了无关网站的页面数据)。排查步骤:

1. 确认在 GIIP 中注册的媒体资源 ID(properties/<数字>)。
2. 在 GA4 中打开该媒体资源的数据流 → 衡量 ID。
3. 与网站源码中的 gtag 衡量 ID(layout.tsx 中的 GA_ID 或 NEXT_PUBLIC_GA_ID 环境变量)进行核对。
4. 如果不一致,要么把网站的衡量 ID 改成该媒体资源的,要么把 GIIP 的注册改成网站实际发送到的那个媒体资源。

🛠️ 管理媒体资源

本页始终针对您的当前组织(CSN),显示在标题旁。

添加

1. 输入 GA 媒体资源(例如 properties/123456789)。
2. 可选输入标签(例如 营销网站)。
3. 点击添加 → 出现在下方列表。

编辑

1. 点击行的编辑;表单填入其值。
2. 修改标签(或媒体资源 ID)并点击更新。取消放弃。

删除

点击行的删除并确认。仅删除注册(不删除已采集指标)。

🔐 注册 GA4 服务账号密钥(giip-803)

要让实际采集(GA 采集流水线 页的"开始采集"按钮)生效,每个媒体资源都需要注册一个 GA4 服务账号密钥。无需预先在服务器上放置密钥文件——直接在本页粘贴即可安全存入数据库,采集器会在运行时自动获取并使用。

1. 在 Google Cloud Console 创建服务账号并下载其 JSON 密钥。
2. 在 GA4 管理界面(媒体资源访问权限管理)中,为该服务账号授予**查看者(Viewer)**权限。
3. 复制下载的 JSON 文件全部内容,粘贴到 GA4 服务账号密钥(JSON) 字段。
4. 点击添加/更新——保存后,列表中的密钥状态列会变为已注册。

• 只修改标签而不填写密钥,现有密钥保持不变。
• 列表中永远不会再次显示密钥原文(仅显示"已注册"/"未注册")。要替换请粘贴新的 JSON。

🔗 后续

• 已注册的媒体资源可在 GA 分析报告 页的下拉框中选择。
• 采集代理只能为已注册的媒体资源推送指标(未注册返回 403)。
• 在 GA 采集流水线 页,可通过"开始采集"按钮立即触发采集(需已注册服务账号密钥)。

🧩 字段

字段	含义
GA 媒体资源	GA4 资源名 properties/<id>,组织内唯一。
标签	列表中用于识别的自由文本。
状态	启用/停用。停用保留但不采集。
GA4 服务账号密钥(JSON)	采集器调用 GA4 Data API 所用的凭据。保存后不再显示。
密钥状态	已注册/未注册——仅列表提示(非密钥原文)。

故障排除

现象	原因	解决
“未选择组织(CSN)”	会话中无活动组织	在顶部选择项目/组织后重新打开。
“您没有该组织的权限”	非该组织成员	请管理员添加,或切换组织。
GA 报告中看不到媒体资源	未注册或属于其他组织	在正确组织下注册。
采集器返回 403	媒体资源 ID 未注册	先在此注册准确的 properties/<id>。
点击“开始采集”提示“该组织尚未注册 GA 采集器”	该媒体资源尚未注册服务账号密钥	按上方“注册 GA4 服务账号密钥”步骤粘贴密钥。
粘贴密钥后提示“不是有效的 JSON 格式”	粘贴内容不是完整 JSON(如只复制了一部分)	重新复制 Google 下载的完整 .json 文件内容并粘贴。

---

版本: 1.1 最后更新: 2026-07-29 源文件: giipv3/public/help/ga-property.zh-CN.md