نمایش اطلاعات گوگل آنالیتیکس در ASP.NET

آیا تا به حال به فکر ساختن یک داشبورد تحلیلی سفارشی در وب‌سایت ASP.NET خود افتاده‌اید؟ نمایش آمار بازدیدکنندگان، محبوب‌ترین صفحات و رفتار کاربران به صورت مستقیم در پنل مدیریت، یک مزیت فوق‌العاده است. دیگر نیازی به بررسی مداوم وب‌سایت گوگل آنالیتیکس ندارید. 📈در گذشته، توسعه‌دهندگان از روش‌های سنتی مانند ذخیره بازدید در دیتابیس استفاده می‌کردند. این روش‌ها به سرعت باعث کندی و افزایش حجم پایگاه داده می‌شدند. خوشبختانه، گوگل با ارائه API قدرتمند خود این مشکل را حل کرده است. این مقاله یک راهنمای جامع و به‌روز برای اتصال ASP.NET به Google Analytics Data API (مخصوص GA4) است. ما روش‌های قدیمی و منسوخ را کنار گذاشته و مستقیماً به سراغ جدیدترین و کارآمدترین راهکار می‌رویم. بیایید شروع کنیم!

چرا باید از API گوگل آنالیتیکس استفاده کنیم؟

شاید بپرسید چرا باید زحمت اتصال به API را بکشیم؟ استفاده مستقیم از API گوگل آنالیتیکس مزایای بی‌نظیری برای کسب‌وکار و وب‌سایت شما به همراه دارد. در ادامه به مهم‌ترین آن‌ها اشاره می‌کنیم.

📊 داشبوردهای سفارشی: شما می‌توانید گزارش‌ها و نمودارهایی کاملاً مطابق با نیاز خود طراحی کنید. دیگر به گزارش‌های پیش‌فرض گوگل محدود نیستید.
🚀 اتوماسیون و صرفه‌جویی در زمان: فرآیند گزارش‌گیری را خودکار کنید. به طور مثال، گزارش‌های هفتگی را به صورت خودکار برای مدیران ایمیل کنید.
🔗 ادغام داده‌ها: اطلاعات گوگل آنالیتیکس را با سایر داده‌های کسب‌وکار خود (مانند فروش یا پشتیبانی) ترکیب کنید. این کار به شما دیدی ۳۶۰ درجه از مشتریان می‌دهد.
💡 تصمیم‌گیری هوشمندانه: با دسترسی لحظه‌ای به داده‌های دقیق، می‌توانید تصمیمات بهتری برای بهبود تجربه کاربری و افزایش فروش بگیرید.
🔒 امنیت و کنترل دسترسی: شما دقیقاً کنترل می‌کنید که چه کسانی و به چه بخشی از اطلاعات آماری دسترسی داشته باشند.

آشنایی با Google Analytics Data API (GA4)

گوگل نسخه قدیمی آنالیتیکس (Universal Analytics) را بازنشسته کرده است. اکنون همه باید از Google Analytics 4 یا به اختصار GA4 استفاده کنند. طبیعتاً API دسترسی به داده‌ها نیز تغییر کرده و بسیار قدرتمندتر شده است.

Data API جدید به شما اجازه می‌دهد گزارش‌های پیچیده‌ای از رویدادها (Events) و معیارهای (Metrics) سفارشی خود بسازید. این API بر خلاف نسخه‌های قدیمی، بسیار انعطاف‌پذیرتر و دقیق‌تر عمل می‌کند. در این راهنما، ما از این API جدید برای اتصال به پروژه ASP.NET Core استفاده خواهیم کرد.

پیش‌نیازها برای شروع کار

قبل از نوشتن کد، باید چند مرحله آماده‌سازی را در پنل گوگل انجام دهید. این مراحل برای احراز هویت و صدور مجوز دسترسی به داده‌ها ضروری هستند.

داشتن یک Property در GA4: مطمئن شوید که وب‌سایت شما به یک حساب GA4 متصل است و داده‌ها به درستی جمع‌آوری می‌شوند.
ایجاد پروژه در Google Cloud Console: به کنسول گوگل کلاود بروید و یک پروژه جدید بسازید.
فعال‌سازی Google Analytics Data API: در پروژه خود، به بخش APIs & Services بروید و این API را جستجو و فعال (Enable) کنید.
ساخت Service Account: برای اینکه اپلیکیشن شما بتواند بدون نیاز به لاگین کاربر به داده‌ها دسترسی پیدا کند، باید یک حساب خدماتی (Service Account) بسازید. پس از ساخت، یک فایل کلید با فرمت JSON دانلود خواهید کرد. این فایل را در جای امنی نگهداری کنید.
دادن دسترسی به Service Account: ایمیل مربوط به Service Account ساخته شده را در بخش مدیریت کاربران (Admin -> Account Access Management) در گوگل آنالیتیکس خود اضافه کرده و حداقل دسترسی “Viewer” را به آن بدهید.

راهنمای قدم به قدم: اتصال ASP.NET Core به GA4

اکنون که پیش‌نیازها آماده است، می‌توانیم پروژه ASP.NET Core خود را بسازیم و داده‌ها را دریافت کنیم. این فرآیند شامل سه مرحله اصلی است.

مرحله ۱: نصب پکیج‌های مورد نیاز

ابتدا یک پروژه جدید ASP.NET Core (مثلاً از نوع MVC) ایجاد کنید. سپس از طریق NuGet Package Manager، کتابخانه رسمی گوگل برای این کار را نصب کنید. دستور زیر را در کنسول اجرا نمایید:

powershell

Install-Package Google.Analytics.Data.V1Beta

این پکیج تمام ابزارهای لازم برای احراز هویت و ارسال درخواست به API را فراهم می‌کند.

مرحله ۲: احراز هویت با فایل JSON

فایل JSON که در مرحله پیش‌نیازها دانلود کردید را به پروژه خود اضافه کنید. بسیار مهم است که این فایل به صورت عمومی در دسترس نباشد. بهترین کار، تنظیم متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS به مسیر این فایل است.

سپس می‌توانید به سادگی یک کلاینت برای API بسازید.

csharp

using Google.Analytics.Data.V1Beta;
using System;

public class AnalyticsService
{
    public BetaAnalyticsDataClient CreateAnalyticsClient()
    {
        // کتابخانه به صورت خودکار متغیر محیطی را برای احراز هویت می‌خواند
        var client = BetaAnalyticsDataClient.Create();
        return client;
    }
}

مرحله ۳: ارسال درخواست و دریافت داده‌ها

حالا می‌توانید اولین درخواست خود را برای دریافت آمار ارسال کنید. در این مثال، تعداد کاربران فعال (Active Users) در ۷ روز گذشته را دریافت می‌کنیم.

csharp

public async Task<string> GetActiveUsers(string propertyId)
{
    var client = CreateAnalyticsClient();

    var request = new RunReportRequest
    {
        Property = "properties/" + propertyId,
        DateRanges = { new DateRange { StartDate = "7daysAgo", EndDate = "today" } },
        Metrics = { new Metric { Name = "activeUsers" } }
    };

    var response = await client.RunReportAsync(request);

    string activeUsers = "0";
    if (response.Rows.Any())
    {
        activeUsers = response.Rows[0].MetricValues[0].Value;
    }

    return $"تعداد کاربران فعال در ۷ روز گذشته: {activeUsers} نفر";
}

نکته: propertyId همان شناسه منحصر به فرد حساب GA4 شماست که می‌توانید آن را از تنظیمات پنل آنالیتیکس پیدا کنید.

کاربردهای عملی این اتصال چیست؟

شما می‌توانید با ترکیب ابعاد (Dimensions) و معیارها (Metrics) مختلف، گزارش‌های بسیار متنوعی بسازید. در اینجا چند ایده کاربردی وجود دارد:

📄 نمایش محبوب‌ترین مقالات: لیستی از ۱۰ صفحه برتر سایت بر اساس تعداد بازدید (pageviews) در ماه گذشته.
🌍 گزارش موقعیت جغرافیایی کاربران: نمایش کاربران بر اساس کشور یا شهر روی یک نقشه.
📱 آمار دستگاه‌های کاربران: نمایش درصد کاربرانی که از موبایل، تبلت یا دسکتاپ استفاده می‌کنند.
🛒 تحلیل رفتار خرید: در سایت‌های فروشگاهی، می‌توانید مسیر خرید کاربران را تحلیل کرده و نرخ تبدیل را بهینه کنید.

دسترسی سریع به وب‌سرویس‌های ایرانی با api.ir

علاوه بر سرویس‌های بین‌المللی مانند گوگل، کسب‌وکارهای ایرانی نیز به APIهای داخلی متعددی نیاز دارند. وب‌سرویس‌هایی مانند احراز هویت، استعلام‌های بانکی، خدمات ثبت احوال و… برای بسیاری از اپلیکیشن‌ها حیاتی هستند.

سامانه api.ir به عنوان یک ارائه‌دهنده پیشرو، مجموعه‌ای کامل از وب‌سرویس‌های کاربردی ایرانی را به صورت یکپارچه ارائه می‌دهد. شما می‌توانید با یک بار ثبت‌نام، به ده‌ها سرویس مختلف دسترسی پیدا کنید.

مراحل ثبت‌نام بسیار ساده است:

به وب‌سایت p.api.ir مراجعه کنید.
بر روی دکمه ثبت‌نام کلیک کرده و اطلاعات خود را وارد نمایید.
پس از تکمیل ثبت‌نام، وارد پنل کاربری خود شده و مستندات سرویس مورد نظر را مطالعه کنید.

جمع‌بندی

ادغام داده‌های گوگل آنالیتیکس با اپلیکیشن ASP.NET Core، یک گام بزرگ به سوی مدیریت هوشمند و مبتنی بر داده است. با استفاده از Google Analytics Data API (GA4) و کتابخانه‌های رسمی گوگل، این فرآیند بسیار ساده و کارآمد شده است. شما می‌توانید داشبوردهای سفارشی بسازید، گزارش‌ها را خودکار کنید و در نهایت، تجربه بهتری برای کاربران خود خلق نمایید. 🎯

امیدواریم این راهنمای جامع برای شما مفید بوده باشد. آیا شما تجربه مشابهی در استفاده از APIهای گوگل داشته‌اید؟ نظرات و سوالات خود را در بخش دیدگاه‌ها با ما در میان بگذارید.