استفاده Google Analytics API در دات نت

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

در این مطلب یاد می‌گیرید چگونه:

به Google Analytics API متصل شوید
روش احراز هویت ایمن را پیاده‌سازی کنید
داده‌های GA4 را در .NET واکشی کنید
مزیت‌ها و کاربردهای استفاده از API را بشناسید

مزایای استفاده Google Analytics API در دات نت

مزیت‌های کلیدی

⭐ افزایش سرعت گزارش‌گیری: دریافت خودکار داده‌ها بدون ورود به پنل آنالیتیکس.
🔒 امنیت بالا: استفاده از OAuth 2.0 استاندارد و ایمن.
📊 گزارش‌های سفارشی: امکان دریافت متریک‌ها و دیمنشن‌های دلخواه.
⚡ یکپارچگی آسان با Web API و اپلیکیشن‌های سازمانی: مخصوصاً در کاربردهای BI.
🤖 خودکارسازی تحلیل‌ها: اجرای کرون‌جاب برای استخراج داده روزانه/ساعتی.

راه‌اندازی Google Analytics API در NET. (به‌روز ۲۰۲۵)

در نسخه‌های جدید گوگل آنالیتیکس (GA4)، دیگر خبری از ClientLogin نیست و روش‌های قدیمی منسوخ شده‌اند.

در حال حاضر تنها روش رسمی و معتبر برای احراز هویت:

OAuth 2.0 با Service Account

مراحل اتصال به Google Analytics API در دات‌نت

برای استفاده از API باید یک Service Account بسازید. مراحل:

🌐 ورود به Google Cloud Console
🔧 ایجاد پروژه جدید
🧩 فعال‌سازی API
🔐 ایجاد Service Account و دریافت کلید JSON
➕ افزودن Service Account به Google Analytics با نقش Viewer

کد اتصال به Google Analytics API در دات‌نت

نصب پکیج NuGet

text

Install-Package Google.Apis.AnalyticsData.v1beta

نمونه کد کامل دریافت PageViews از GA4

csharp

using Google.Apis.Auth.OAuth2;
using Google.Apis.AnalyticsData.v1beta;
using Google.Apis.AnalyticsData.v1beta.Data;
using Google.Apis.Services;

public class AnalyticsService
{
    public static async Task RunSample()
    {
        GoogleCredential credential = GoogleCredential
            .FromFile("service-account.json")
            .CreateScoped("https://www.googleapis.com/auth/analytics.readonly");

        var analytics = new BetaAnalyticsDataService(new BaseClientService.Initializer()
        {
            HttpClientInitializer = credential
        });

        RunReportRequest request = new RunReportRequest
        {
            Dimensions = new List<Dimension> { new Dimension { Name = "pagePath" } },
            Metrics = new List<Metric> { new Metric { Name = "screenPageViews" } },
            DateRanges = new List<DateRange> {
                new DateRange { StartDate = "2024-01-01", EndDate = "today" }
            }
        };

        var response = analytics.Properties.RunReport(request, 
            "properties/YOUR_PROPERTY_ID").Execute();

        foreach (var row in response.Rows)
        {
            Console.WriteLine($"{row.DimensionValues[0].Value}: {row.MetricValues[0].Value}");
        }
    }
}

نحوه ثبت‌نام سریع برای استفاده از API

برای استفاده از Google Analytics API به Service Account نیاز دارید. مراحل ثبت‌نام بسیار ساده است:

🎯 ورود به لینک:https://p.api.ir
🧾 تکمیل اطلاعات پایه
📩 دریافت تایید
🔐 انتخاب تنظیمات امنیتی

این لینک به شما امکان اتصال سریع و یکپارچه با API را می‌دهد.

استفاده Google Analytics API در دات نت

کاربردهای حرفه‌ای Google Analytics API در دات‌نت

کاربردهای پرطرفدار

📈 ساخت داشبوردهای BI داخلی برای شرکت‌ها
🧠 تحلیل رفتار کاربران بدون نیاز به ورود به پنل GA
🔄 یکپارچه‌سازی با سیستم‌های CRM، CMS و ERP
🚀 اجرای اتوماسیون بازاریابی بر پایه داده
🎯 تولید گزارش‌های روزانه، هفتگی و ماهیانه

مقایسه روش قدیمی (ClientLogin) و روش جدید

ویژگی	روش قدیمی	روش جدید
امنیت	❌ ضعیف	✅ بسیار بالا
پشتیبانی گوگل	❌ قطع شده	✅ رسمی
مناسب دات‌نت	محدود	ایده‌آل
سازگاری با GA4	❌ ندارد	✅ کامل

بخش مهم: ساختار داده‌ها در GA4

در GA4 شما با موارد زیر کار می‌کنید:

Metrics (مثل pageViews، activeUsers)
Dimensions (مثل city، browser، pagePath)
DateRanges
Pagination

این ساختار امکان گزارش‌گیری بسیار گسترده‌تری نسبت به Universal Analytics دارد.

خطایابی و نکات مهم (Troubleshooting)

خطاهای رایج

❗ خطای 403: دسترسی Service Account به Property داده نشده.
❗ خطای 400: متریک/دیمنشن اشتباه انتخاب شده است.
❗ مشکل OAuth: JSON درست بارگذاری نشده.

پیشنهادات مهم برای بهینه‌سازی پروژه

استفاده از Caching برای جلوگیری از محدودیت‌های API
ذخیره‌سازی داده‌ها در SQL برای تحلیل طولانی مدت
استفاده از Task Scheduler برای اتوماتیک‌سازی گزارش‌ها
اتصال خروجی API به Power BI

استفاده Google Analytics API در دات نت در دات‌نت یک مزیت بزرگ برای تیم‌های توسعه، مارکتینگ و محصول است. با این API می‌توانید گزارش‌های دقیق‌تری بگیرید، تحلیل‌های خود را اتوماتیک کنید و تجربه کاربری بهتری ارائه دهید.

اگر سوالی دارید، همین حالا در بخش نظرات بپرسید یا مقاله‌های پیشرفته‌تر ما را بخوانید. 🚀