GoogleAnalyticsTracker 项目教程

GoogleAnalyticsTracker 项目教程

GoogleAnalyticsTracker GoogleAnalyticsTracker - A C# library for tracking Google Analytics 项目地址: https://gitcode.com/gh_mirrors/go/GoogleAnalyticsTracker

1. 项目介绍

GoogleAnalyticsTracker 是一个用于从 C# 应用程序中直接跟踪 Google Analytics 的库。它特别适用于需要跟踪 API 使用情况的 ASP.NET MVC 框架。GoogleAnalyticsTracker 允许你通过直接调用 Google Analytics 来跟踪特定 URL 的使用情况。需要注意的是，为了使 GoogleAnalyticsTracker 正常工作，Google Analytics 账户应配置为网站，而不是应用程序。

2. 项目快速启动

安装

你可以通过 NuGet 安装 GoogleAnalyticsTracker。根据你的应用程序类型，选择以下包之一：

• GoogleAnalyticsTracker.Simple: 适用于不需要框架集成的应用程序（如控制台、WPF、WinForms 等）。
• GoogleAnalyticsTracker.AspNetCore: 适用于 ASP.NET Core 应用程序。

# 安装 GoogleAnalyticsTracker.Simple
dotnet add package GoogleAnalyticsTracker.Simple

# 安装 GoogleAnalyticsTracker.AspNetCore
dotnet add package GoogleAnalyticsTracker.AspNetCore

示例代码

使用 GoogleAnalyticsTracker.Simple

using (var tracker = new SimpleTracker("UA-XXXXXX-XX", simpleTrackerEnvironment))
{
    await tracker.TrackPageViewAsync("My API - Create", "api/create");
    await tracker.TrackPageViewAsync("MY API - List", "api/list");
}

使用 GoogleAnalyticsTracker.AspNetCore

在你的 Startup 类中注册 GoogleAnalyticsTracker：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddGoogleAnalyticsTracker(options =>
        {
            options.TrackerId = "UA-XXXXXX-XX";
            options.ShouldTrackRequestInMiddleware = TrackRequests.Yes;
        });
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        app.UseGoogleAnalyticsTracker();
    }
}

3. 应用案例和最佳实践

应用案例

• API 使用情况跟踪: 通过 GoogleAnalyticsTracker，你可以轻松跟踪 API 的使用情况，了解哪些 API 端点最受欢迎。
• 自定义事件跟踪: 除了页面视图，你还可以使用 GoogleAnalyticsTracker 跟踪自定义事件，如用户操作、错误日志等。

最佳实践

• 配置 Google Analytics 账户: 确保你的 Google Analytics 账户配置为网站，而不是应用程序。
• 使用异步方法: 在跟踪页面视图或事件时，使用异步方法以提高应用程序的性能。
• 自定义跟踪参数: 如果需要为所有跟踪命中设置公共数据，可以子类化 Tracker 或 TrackerBase 并重写 AmendParameters 方法。

4. 典型生态项目

• ASP.NET Core: GoogleAnalyticsTracker.AspNetCore 是专门为 ASP.NET Core 应用程序设计的扩展包，提供了与 ASP.NET Core 框架的集成。
• Google Analytics API: 虽然 GoogleAnalyticsTracker 直接与 Google Analytics 通信，但你也可以使用 Google Analytics API 进行更复杂的分析和报告。
• NuGet: GoogleAnalyticsTracker 通过 NuGet 分发，方便开发者快速集成到项目中。

通过以上步骤，你可以轻松地将 GoogleAnalyticsTracker 集成到你的 C# 应用程序中，并开始跟踪 Google Analytics 数据。

GoogleAnalyticsTracker GoogleAnalyticsTracker - A C# library for tracking Google Analytics 项目地址: https://gitcode.com/gh_mirrors/go/GoogleAnalyticsTracker