نمای کلی API داده Google Analytics 4

می توانید از Data API برای دسترسی برنامه ریزی شده به داده های گزارش Google Analytics 4 (GA4) استفاده کنید. این API با ویژگی های قدیمی Universal Analytics سازگار نیست.

درباره ویژگی های Google Analytics 4 بیشتر بدانید .

در اینجا چند نمونه وجود دارد که ممکن است در مورد استفاده از Google Analytics Data API v1 گزارش دهید:

  • اپلیکیشن اندروید شما در هفته گذشته چند کاربر فعال روزانه داشته است.
  • 10 صفحه برتر سایت شما در 28 روز گذشته چند بازدید از صفحه داشته اند.
  • برنامه iOS شما در 30 دقیقه گذشته چند کاربر فعال در هر کشور داشته است.

همچنین می توانید از Google Analytics Data API v1 برای انجام کارهای زیر استفاده کنید:

  • داشبوردهای سفارشی برای نمایش داده های Google Analytics بسازید.
  • وظایف گزارش گیری پیچیده را به صورت خودکار انجام دهید تا در زمان صرفه جویی کنید.
  • داده های Google Analytics خود را با سایر برنامه های تجاری ادغام کنید.

شروع کنید

برای شروع، به شروع سریع کتابخانه مشتری مراجعه کنید. کتابخانه های کلاینت در جاوا، پایتون، Node.js و سایر زبان ها برای ساده سازی پیاده سازی شما وجود دارد.

روش های موجود

در اینجا لیستی از روش های Data API آمده است. برای جزئیات بیشتر، به مستندات مرجع مراجعه کنید.

  • runReport این روش یک گزارش سفارشی از داده‌های رویداد Google Analytics شما را برمی‌گرداند و روش ترجیحی برای درخواست‌های گزارش ساده است.
  • batchRunReports این یک نسخه دسته ای از روش runReport است که به شما امکان می دهد چندین گزارش را با استفاده از یک فراخوانی API ایجاد کنید.
  • runPivotReport این روش یک گزارش محوری سفارشی از داده‌های رویداد Google Analytics شما را برمی‌گرداند. گزارش‌های محوری، فرمت‌های پیشرفته‌تر و گویاتر از گزارش‌های معمولی هستند. هر محور، ستون‌ها و ردیف‌های بعد قابل مشاهده را در پاسخ گزارش توصیف می‌کند.
  • batchRunPivotReports این نسخه دسته ای از روش runPivotReport است که به شما امکان می دهد چندین گزارش را با استفاده از یک فراخوانی API ایجاد کنید.
  • getMetadata این روش متادیتا را برای ابعاد و معیارهای موجود در روش های گزارش برمی گرداند. برای بررسی ابعاد و معیارها استفاده می شود. پاسخ این روش همچنین شامل ابعاد و معیارهای سفارشی موجود برای ویژگی GA4 مشخص شده است.
  • checkCompatibility این روش ابعاد و معیارهایی را فهرست می کند که می توانند به درخواست گزارش اضافه شوند و سازگاری را حفظ کنند.
  • runRealtimeReport این روش یک گزارش سفارشی از داده های رویداد بیدرنگ را برای دارایی شما برمی گرداند. رویدادها چند ثانیه پس از ارسال به Google Analytics در گزارش‌های بلادرنگ ظاهر می‌شوند. گزارش‌های بلادرنگ رویدادها و داده‌های استفاده را برای دوره‌های زمانی از لحظه حال تا 30 دقیقه قبل نشان می‌دهند (تا 60 دقیقه برای خواص Google Analytics 360).
  • properties.audienceExports گروهی از روش‌ها که به شما امکان تولید Audience Exports را می‌دهد که شامل یک عکس فوری از کاربران در یک مخاطب است.
  • properties.recurringAudienceLists (پیش نمایش اولیه) گروهی از روش ها که به شما امکان می دهد صادرات تکراری مخاطب را مدیریت کنید. صادرات مکرر مخاطب، هر روز فهرست مخاطبان جدیدی تولید می کند.
  • runFunnelReport (پیش‌نمایش اولیه) این روش یک گزارش قیف سفارشی از داده‌های رویداد Google Analytics شما را برمی‌گرداند. کاوش قیف به شما این امکان را می‌دهد تا مراحلی را که کاربران برای تکمیل یک کار برمی‌دارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست می‌خورند.

ابعاد و معیارهای پشتیبانی شده

برای فهرستی از همه ابعاد و معیارهای پشتیبانی شده توسط Data API، به مستندات طرحواره API مراجعه کنید.