google-analytics

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Google Analytics 4 Complete Guide

Google Analytics 4（GA4）完整指南

Overview

概述

Google Analytics 4 (GA4) is Google's event-based analytics platform for measuring user interactions across websites and applications. This comprehensive skill provides guidance on all aspects of GA4 - from initial property setup through advanced analysis, implementation methods, and compliance.

GA4 uses an event-based data model where every user interaction is tracked as an event with associated parameters. This differs from the session-based model of Universal Analytics, providing more flexibility and cross-platform measurement capabilities.

Google Analytics 4（GA4）是谷歌推出的基于事件的分析平台，用于衡量网站和应用程序上的用户交互行为。这份全面的指南涵盖了GA4的所有方面——从初始媒体资源设置到高级分析、实施方法以及合规性相关内容。

GA4采用基于事件的数据模型，每个用户交互行为都被追踪为带有关联参数的事件。这与Universal Analytics的基于会话的模型不同，提供了更高的灵活性和跨平台衡量能力。

When to Use This Skill

适用场景

Invoke this skill for any GA4-related task, including:

Setup and Configuration:

Creating GA4 properties and data streams
Configuring Measurement IDs (G-XXXXXXXXXX)
Setting up data retention and collection settings
Managing property access and permissions

Implementation:

Installing GA4 via gtag.js, GTM, or CMS plugins
Implementing event tracking (automatic, recommended, custom)
Setting up ecommerce tracking
Configuring cross-domain measurement

Events and Tracking:

Understanding event architecture and parameters
Implementing recommended events (purchase, login, sign_up)
Creating custom events for business-specific tracking
Working with event parameters and limits

Analysis and Reporting:

Using standard reports and Explorations
Building funnel and path analyses
Creating audiences and segments
Exporting data to BigQuery

Advanced Topics:

Measurement Protocol for server-side tracking
User ID and cross-device tracking
Privacy compliance and Consent Mode
DebugView testing and validation

在处理任何与GA4相关的任务时均可参考本指南，包括：

设置与配置：

创建GA4媒体资源和数据流
配置衡量ID（G-XXXXXXXXXX）
设置数据保留和收集规则
管理媒体资源访问权限

实施部署：

通过gtag.js、GTM或CMS插件安装GA4
实施事件追踪（自动、推荐、自定义）
设置电商追踪
配置跨域名衡量

事件与追踪：

理解事件架构和参数
实施推荐事件（purchase、login、sign_up）
创建针对业务需求的自定义事件
处理事件参数及相关限制

分析与报告：

使用标准报告和探索功能
构建转化漏斗和用户路径分析
创建受众群体和细分
将数据导出至BigQuery

高级主题：

使用Measurement Protocol进行服务器端追踪
用户ID与跨设备追踪
隐私合规与Consent Mode
DebugView测试与验证

Quick Start

快速入门

1. Create GA4 Property

1. 创建GA4媒体资源

Navigate to analytics.google.com
Admin -> Create -> Property
Enter property name, timezone, currency
Create web data stream
Note your Measurement ID (G-XXXXXXXXXX)

访问analytics.google.com
管理 -> 创建 -> 媒体资源
输入媒体资源名称、时区、货币
创建网络数据流
记录你的衡量ID（G-XXXXXXXXXX）

2. Install Tracking (Choose One Method)

2. 安装追踪代码（选择一种方式）

Option A: Google Tag Manager (Recommended)

1. Install GTM container on website
2. Create Google Tag with GA4 Measurement ID
3. Trigger: Initialisation - All Pages
4. Publish container

Option B: gtag.js Direct

html

<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXXXXX');
</script>

选项A：Google Tag Manager（推荐）

1. 在网站上安装GTM容器
2. 创建带有GA4衡量ID的Google标签
3. 触发条件：初始化 - 所有页面
4. 发布容器

选项B：直接使用gtag.js

html

<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXXXXX');
</script>

3. Verify Installation

3. 验证安装

Enable Google Analytics Debugger extension
Admin -> DebugView
Confirm events appearing: session_start, page_view
Check Realtime reports for active users

启用Google Analytics Debugger扩展程序
管理 -> DebugView
确认事件正常显示：session_start、page_view
查看实时报告中的活跃用户数据

4. Send Custom Events

4. 发送自定义事件

javascript

gtag('event', 'button_click', {
  'button_name': 'Subscribe',
  'button_location': 'header'
});

javascript

gtag('event', 'button_click', {
  'button_name': 'Subscribe',
  'button_location': 'header'
});

Decision Tree: Which Reference Do I Need?

决策树：我需要参考哪部分内容？

What are you trying to do?

Setting up GA4 for the first time?
  -> references/setup.md

Understanding how events work?
  -> references/events-fundamentals.md

Implementing standard tracking events?
  -> references/recommended-events.md

Creating business-specific custom events?
  -> references/custom-events.md

Making parameters appear in reports?
  -> references/custom-dimensions.md

Implementing User ID / cross-device tracking?
  -> references/user-tracking.md

Building audiences for remarketing?
  -> references/audiences.md

Analysing data in GA4 reports?
  -> references/reporting.md

Exporting to BigQuery for SQL analysis?
  -> references/bigquery.md

Installing via gtag.js directly?
  -> references/gtag.md

Setting up GA4 in Google Tag Manager?
  -> references/gtm-integration.md

Sending events from server/backend?
  -> references/measurement-protocol.md

Testing and debugging implementation?
  -> references/debugview.md

Implementing GDPR/Consent Mode?
  -> references/privacy.md

Configuring Admin settings?
  -> references/data-management.md

你想要完成什么操作？

首次设置GA4？
  -> references/setup.md

了解事件的工作原理？
  -> references/events-fundamentals.md

实施标准追踪事件？
  -> references/recommended-events.md

创建针对业务需求的自定义事件？
  -> references/custom-events.md

让参数在报告中显示？
  -> references/custom-dimensions.md

实施用户ID/跨设备追踪？
  -> references/user-tracking.md

构建再营销受众群体？
  -> references/audiences.md

在GA4报告中分析数据？
  -> references/reporting.md

导出至BigQuery进行SQL分析？
  -> references/bigquery.md

直接通过gtag.js安装？
  -> references/gtag.md

在Google Tag Manager中设置GA4？
  -> references/gtm-integration.md

从服务器/后端发送事件？
  -> references/measurement-protocol.md

测试和调试实施效果？
  -> references/debugview.md

实施GDPR/Consent Mode？
  -> references/privacy.md

配置管理设置？
  -> references/data-management.md

Core Concepts

核心概念

Event-Based Model

基于事件的模型

GA4 tracks everything as events. Four categories:

Category	Description	Examples
Automatic	Fire without configuration	session_start, first_visit
Enhanced Measurement	Toggle on/off in settings	scroll, click, file_download
Recommended	Google-defined with standard parameters	purchase, login, sign_up
Custom	Business-specific tracking	demo_requested, trial_started

GA4将所有行为都作为事件进行追踪，分为四类：

类别	描述	示例
自动事件	无需配置即可触发	session_start、first_visit
增强型衡量事件	在设置中可开启/关闭	scroll、click、file_download
推荐事件	谷歌定义的标准事件，带有规范参数	purchase、login、sign_up
自定义事件	针对业务需求的追踪事件	demo_requested、trial_started

Key Limits and Constraints

关键限制与约束

Limit	Value
Event names per property	500 distinct
Parameters per event	25
Event name length	40 characters
Parameter name length	40 characters
Parameter value length	100 characters
Custom dimensions (event-scoped)	50
Custom dimensions (user-scoped)	25
Custom dimensions (item-scoped)	10
Audiences per property	100

限制项	数值
每个媒体资源的事件名称数量	500个不同名称
每个事件的参数数量	25个
事件名称长度	40个字符
参数名称长度	40个字符
参数值长度	100个字符
自定义维度（事件范围）	50个
自定义维度（用户范围）	25个
自定义维度（商品范围）	10个
每个媒体资源的受众群体数量	100个

Measurement ID Format

衡量ID格式

Format: G-XXXXXXXXXX (G- prefix + 10 alphanumeric characters)
Location: Admin -> Data Streams -> Web Stream
Used in: gtag.js config, GTM tags, Measurement Protocol

格式：G-XXXXXXXXXX（G-前缀 + 10位字母数字字符）
位置：管理 -> 数据流 -> 网络数据流
用途：gtag.js配置、GTM标签、Measurement Protocol

Topic Overview

主题概述

Setup and Installation

设置与安装

Reference: references/setup.md

Create GA4 accounts, properties, and data streams. Covers account hierarchy, property configuration, data stream setup for web/iOS/Android, and initial configuration settings.

参考文档： references/setup.md

创建GA4账户、媒体资源和数据流。涵盖账户层级、媒体资源配置、网络/iOS/Android数据流设置及初始配置选项。

Events Fundamentals

事件基础

Reference: references/events-fundamentals.md

Understand GA4's event-based architecture. Covers the four event categories, event structure, parameter scopes (event/user/item), naming conventions, and limits.

参考文档： references/events-fundamentals.md

了解GA4的基于事件的架构。涵盖四类事件、事件结构、参数范围（事件/用户/商品）、命名规范及限制。

Custom Events

自定义事件

Reference: references/custom-events.md

Create business-specific events beyond recommended events. Covers naming conventions, parameter design, industry patterns (SaaS, education, media), and implementation examples.

参考文档： references/custom-events.md

创建超出推荐事件范围的业务专属事件。涵盖命名规范、参数设计、行业模式（SaaS、教育、媒体）及实施示例。

Recommended Events

Custom Dimensions

自定义维度

Reference: references/custom-dimensions.md

Transform event parameters into reportable dimensions. Covers registration workflow, scope selection (event/user/item), custom metrics, calculated metrics, and troubleshooting.

参考文档： references/custom-dimensions.md

将事件参数转换为可在报告中展示的维度。涵盖注册流程、范围选择（事件/用户/商品）、自定义指标、计算指标及故障排除。

User Tracking

用户追踪

Reference: references/user-tracking.md

Implement User ID and cross-device tracking. Covers User ID setup, user properties, Reporting Identity options, cross-domain tracking, and data deletion.

参考文档： references/user-tracking.md

实施用户ID与跨设备追踪。涵盖用户ID设置、用户属性、报告身份选项、跨域名追踪及数据删除。

Audiences

受众群体

Reference: references/audiences.md

Create segments for analysis and remarketing. Covers audience conditions, predictive audiences, sequence conditions, membership duration, and Google Ads export.

参考文档： references/audiences.md

创建用于分析和再营销的细分群体。涵盖受众群体条件、预测受众、序列条件、会员期限及谷歌广告导出。

Reporting

报告

Reference: references/reporting.md

Analyse data using standard reports and Explorations. Covers report types, exploration techniques (funnel, path, cohort), segments, comparisons, and attribution models.

参考文档： references/reporting.md

使用标准报告和探索功能分析数据。涵盖报告类型、探索技术（漏斗、路径、同期群）、细分、对比及归因模型。

BigQuery Export

BigQuery导出

Reference: references/bigquery.md

Export raw event data to BigQuery for advanced analysis. Covers linking setup, table schema, SQL query patterns, UNNEST operations, and cost optimisation.

参考文档： references/bigquery.md

将原始事件数据导出至BigQuery进行高级分析。涵盖关联设置、表结构、SQL查询模式、UNNEST操作及成本优化。

gtag.js Implementation

gtag.js实施

Reference: references/gtag.md

Implement GA4 directly using gtag.js without GTM. Covers installation, gtag commands (config, event, set), common patterns, and framework integration.

参考文档： references/gtag.md

无需GTM，直接使用gtag.js实施GA4。涵盖安装、gtag命令（config、event、set）、常见模式及框架集成。

GTM Integration

GTM集成

Reference: references/gtm-integration.md

Implement GA4 using Google Tag Manager. Covers configuration tags, event tags, triggers, variables, data layer integration, and Preview mode testing.

参考文档： references/gtm-integration.md

使用Google Tag Manager实施GA4。涵盖配置标签、事件标签、触发器、变量、数据层集成及预览模式测试。

Measurement Protocol

Reference: references/measurement-protocol.md

Send events server-side using the Measurement Protocol API. Covers authentication, request format, validation, Python/Node.js/PHP examples, and best practices.

参考文档： references/measurement-protocol.md

使用Measurement Protocol API从服务器端发送事件。涵盖身份验证、请求格式、验证、Python/Node.js/PHP示例及最佳实践。

DebugView

Reference: references/debugview.md

Test and validate GA4 implementation. Covers enabling debug mode, reading DebugView interface, validation workflows, and troubleshooting common issues.

参考文档： references/debugview.md

测试和验证GA4实施效果。涵盖启用调试模式、解读DebugView界面、验证流程及常见问题排查。

Privacy Compliance

隐私合规

Reference: references/privacy.md

Implement GDPR/CCPA compliance. Covers Consent Mode v2, consent parameters, regional settings, data deletion, and integration with consent management platforms.

参考文档： references/privacy.md

实施GDPR/CCPA合规措施。涵盖Consent Mode v2、同意参数、区域设置、数据删除及与同意管理平台的集成。

Data Management

数据管理

Reference: references/data-management.md

Configure GA4 Admin settings. Covers data retention, data filters, user permissions, property settings, enhanced measurement, and key events (conversions).

参考文档： references/data-management.md

配置GA4管理设置。涵盖数据保留、数据过滤器、用户权限、媒体资源设置、增强型衡量及关键事件（转化）。

Common Workflows

常见工作流程

Implementing Ecommerce Tracking

实施电商追踪

Review recommended events: references/recommended-events.md
Implement the purchase funnel:
- view_item -> add_to_cart -> begin_checkout -> purchase
Structure items array correctly:
- Required: item_id OR item_name
- Recommended: price, quantity, item_category
Test with DebugView: references/debugview.md
Register custom item parameters: references/custom-dimensions.md

查看推荐事件： references/recommended-events.md
实施购买漏斗：
- view_item -> add_to_cart -> begin_checkout -> purchase
正确构建商品数组：
- 必填项：item_id 或 item_name
- 推荐项：price、quantity、item_category
使用DebugView测试： references/debugview.md
注册自定义商品参数： references/custom-dimensions.md

Setting Up Cross-Device Tracking

设置跨设备追踪

Implement User ID: references/user-tracking.md
Configure Reporting Identity: Admin -> Data Settings -> Reporting Identity
Set user properties: references/custom-dimensions.md
Build cross-device audiences: references/audiences.md

实施用户ID： references/user-tracking.md
配置报告身份： 管理 -> 数据设置 -> 报告身份
设置用户属性： references/custom-dimensions.md
构建跨设备受众群体： references/audiences.md

Implementing GDPR Compliance

实施GDPR合规

Set up Consent Mode: references/privacy.md
Configure default consent state (denied)
Integrate with CMP (OneTrust, Cookiebot, etc.)
Update consent on user acceptance
Test consent implementation: references/debugview.md

设置Consent Mode： references/privacy.md
配置默认同意状态（拒绝）
与CMP集成（OneTrust、Cookiebot等）
用户接受同意时更新状态
测试同意实施效果： references/debugview.md

Building Custom Reports

构建自定义报告

Understand available data: references/reporting.md
Register custom parameters as dimensions: references/custom-dimensions.md
Create Explorations for custom analysis
For unsampled data, export to BigQuery: references/bigquery.md

了解可用数据： references/reporting.md
将自定义参数注册为维度： references/custom-dimensions.md
创建探索进行自定义分析
如需无抽样数据，导出至BigQuery： references/bigquery.md

Best Practices

最佳实践

Naming Conventions

命名规范

Use snake_case for event names:
```
video_tutorial_watched
```
Be descriptive and action-oriented
Keep under 40 characters
Avoid generic names (event1, click, data)

事件名称使用蛇形命名法：
```
video_tutorial_watched
```
描述性强且以行为为导向
长度不超过40个字符
避免使用通用名称（event1、click、data）

Implementation Strategy

实施策略

Start with Enhanced Measurement (automatic events)
Add recommended events for standard tracking
Create custom events only when needed
Register parameters as custom dimensions for reporting
Test thoroughly with DebugView before production

从增强型衡量（自动事件）开始
添加推荐事件进行标准追踪
仅在必要时创建自定义事件
将参数注册为自定义维度以便在报告中展示
上线前使用DebugView进行全面测试

Data Quality

数据质量

Create separate properties for test/production
Set up internal traffic filters from day one
Document all custom events and parameters
Regularly audit implementation with DebugView
Export to BigQuery for data backup

为测试环境和生产环境创建独立的媒体资源
从第一天开始设置内部流量过滤器
记录所有自定义事件和参数
定期使用DebugView审核实施效果
导出至BigQuery进行数据备份

References

参考文档

Topic	File
Property Setup	references/setup.md
Events Fundamentals	references/events-fundamentals.md
Custom Events	references/custom-events.md
Recommended Events	references/recommended-events.md
Custom Dimensions	references/custom-dimensions.md
User Tracking	references/user-tracking.md
Audiences	references/audiences.md
Reporting	references/reporting.md
BigQuery Export	references/bigquery.md
gtag.js Implementation	references/gtag.md
GTM Integration	references/gtm-integration.md
Measurement Protocol	references/measurement-protocol.md
DebugView Testing	references/debugview.md
Privacy Compliance	references/privacy.md
Data Management	references/data-management.md

主题	文件
媒体资源设置	references/setup.md
事件基础	references/events-fundamentals.md
自定义事件	references/custom-events.md
推荐事件	references/recommended-events.md
自定义维度	references/custom-dimensions.md
用户追踪	references/user-tracking.md
受众群体	references/audiences.md
报告	references/reporting.md
BigQuery导出	references/bigquery.md
gtag.js实施	references/gtag.md
GTM集成	references/gtm-integration.md
Measurement Protocol	references/measurement-protocol.md
DebugView测试	references/debugview.md
隐私合规	references/privacy.md
数据管理	references/data-management.md