如何用C#通过GA4属性ID获取实时用户数据（UA迁移）

一、前置准备 #

• 安装NuGet包：Google.Analytics.Data（GA4 Data API v1官方SDK）
• 准备服务账号密钥文件（JSON格式）：在Google Cloud控制台创建服务账号，授予GA4属性查看者权限后下载密钥文件
• 确认GA4属性ID：格式为纯数字，后续请求需拼接为properties/{propertyId}

二、初始化GA4数据客户端 #

替换UA的AnalyticsService，GA4使用BetaAnalyticsDataClient发起请求：

using Google.Analytics.Data.V1Beta;
using Google.Apis.Auth.OAuth2;

// 加载服务账号密钥文件
var credential = GoogleCredential.FromFile("path/to/your/service-account-key.json")
    .CreateScoped(BetaAnalyticsDataService.Scope.AnalyticsReadonly);

// 初始化GA4数据客户端
var client = new BetaAnalyticsDataClientBuilder
{
    Credential = credential
}.Build();

三、构建实时数据请求 #

GA4实时报告默认返回最近30分钟数据，无需指定日期范围；对应UA的sessions，实时场景常用activeUsers指标，维度保留browser：

string propertyId = "123456789"; // 替换为你的GA4属性ID
var request = new RunRealtimeReportRequest
{
    Property = $"properties/{propertyId}",
    Dimensions = { new Dimension { Name = "browser" } },
    Metrics = { new Metric { Name = "activeUsers" } }
};

四、执行请求并解析响应 #

替代UA的Reports.BatchGet.Execute()，GA4使用RunRealtimeReport方法：

// 执行请求
var response = client.RunRealtimeReport(request);

// 解析响应数据
foreach (var row in response.Rows)
{
    string browser = row.DimensionValues[0].Value;
    string activeUsers = row.MetricValues[0].Value;
    
    Console.WriteLine($"浏览器：{browser}，实时活跃用户数：{activeUsers}");
}

关键差异说明 #

1. 身份验证：GA4直接通过服务账号密钥初始化客户端，无需构建UA的AnalyticsService
2. 核心标识：移除UA的ViewId，改用GA4属性ID作为请求核心标识
3. 请求结构：用RunRealtimeReportRequest替代UA的GetReportsRequest，且实时报告仅支持GA4专属的实时指标/维度体系

内容的提问来源于stack exchange，提问作者Shahnila Fahmi