Google Analytics Data API v1 به شما امکان دسترسی برنامه‌ریزی به داده‌های گزارش Google Analytics 4 (GA4) را می‌دهد. Google Analytics 4 به شما کمک می‌کند بفهمید که مردم چگونه از برنامه وب، iOS یا Android شما استفاده می‌کنند. درباره ویژگی های Google Analytics 4 بیشتر بدانید .
با Google Analytics Data API v1، می‌توانید گزارش‌هایی برای پاسخ به سؤالاتی مانند:
- اپلیکیشن اندروید من در هفته گذشته روزانه چند کاربر فعال داشته است؟
- هر یک از 10 نشانی وب سایت من در 28 روز گذشته چند بازدید از صفحه داشته است؟
- اپلیکیشن iOS من در 30 دقیقه گذشته چند کاربر فعال در هر کشور داشته است؟
Google Analytics Data API v1 همچنین می تواند برای موارد زیر استفاده شود:
- داشبوردهای سفارشی برای نمایش داده های Google Analytics بسازید.
- وظایف گزارش گیری پیچیده را به صورت خودکار انجام دهید تا در زمان صرفه جویی کنید.
- داده های Google Analytics خود را با سایر برنامه های تجاری ادغام کنید.
راهنمای شروع سریع
فراخوانی API برای ایجاد اولین گزارش شما تنها چند خط کد با شما فاصله دارد. شروع سریع استفاده از کتابخانه های سرویس گیرنده را برای شروع ببینید. کتابخانه های کلاینت در جاوا، پایتون، Node.js و سایر زبان ها برای ساده سازی پیاده سازی شما وجود دارد.
روش های موجود
- 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 شما را برمی‌گرداند. کاوش قیف به شما این امکان را می‌دهد تا مراحلی را که کاربران برای تکمیل یک کار برمی‌دارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست می‌خورند.
ابعاد و معیارهای پشتیبانی شده
اسناد طرحواره API ابعاد و معیارهایی را فهرست می‌کند که در حال حاضر توسط Analytics Data API پشتیبانی می‌شوند.