شما میتوانید از رابط برنامهنویسی کاربردی (API) داده برای دسترسی برنامهنویسیشده به دادههای گزارش گوگل آنالیتیکس (Google Analytics) استفاده کنید. این API با ویژگیهای قدیمی Universal Analytics سازگار نیست.
درباره ویژگیهای گوگل آنالیتیکس بیشتر بدانید .
در اینجا چند نمونه از مواردی که ممکن است در مورد استفاده از Google Analytics Data API نسخه ۱ گزارش دهید، آورده شده است:
- اپلیکیشن اندروید شما در هفته گذشته چند کاربر فعال روزانه داشته است؟
- ده صفحه برتر سایت شما در ۲۸ روز گذشته چند بازدید داشتهاند؟
- تعداد کاربران فعال در هر کشور که اپلیکیشن iOS شما در 30 دقیقه گذشته داشته است.
همچنین میتوانید از Google Analytics Data API نسخه ۱ برای انجام موارد زیر استفاده کنید:
- ساخت داشبوردهای سفارشی برای نمایش دادههای گوگل آنالیتیکس
- خودکارسازی وظایف گزارشدهی پیچیده برای صرفهجویی در زمان.
- دادههای گوگل آنالیتیکس خود را با سایر برنامههای تجاری ادغام کنید.
شروع کنید
برای شروع، به راهنمای سریع کتابخانه کلاینت مراجعه کنید. کتابخانههای کلاینت در جاوا، پایتون، Node.js و زبانهای دیگر وجود دارند تا پیادهسازی شما را ساده کنند.
روشهای موجود
در اینجا لیستی از متدهای Data API آمده است. برای جزئیات بیشتر، به مستندات مرجع مراجعه کنید.
-
runReportاین متد یک گزارش سفارشی از دادههای رویداد گوگل آنالیتیکس شما را برمیگرداند و روش ترجیحی برای کوئریهای گزارش ساده است. -
batchRunReportsاین یک نسخه دستهای از متد runReport است که به شما امکان میدهد چندین گزارش را با استفاده از یک فراخوانی API واحد تولید کنید. -
runPivotReportاین متد یک گزارش محوری سفارشی از دادههای رویداد گوگل آنالیتیکس شما را برمیگرداند. گزارشهای محوری فرمتهای پیشرفتهتر و رساتری نسبت به گزارشهای معمولی دارند. هر محور، ستونها و ردیفهای بُعد قابل مشاهده در پاسخ گزارش را توصیف میکند. -
batchRunPivotReportsاین یک نسخه دستهای از متد runPivotReport است که به شما امکان میدهد چندین گزارش را با استفاده از یک فراخوانی API واحد تولید کنید. -
getMetadataاین متد، متادیتاهای مربوط به ابعاد و معیارهای موجود در متدهای گزارشدهی را برمیگرداند. برای بررسی ابعاد و معیارها استفاده میشود. پاسخ این متد همچنین شامل ابعاد و معیارهای سفارشی موجود برای ویژگی مشخصشدهی گوگل آنالیتیکس است. -
checkCompatibilityاین روش ابعاد و معیارهایی را که میتوانند به یک درخواست گزارش اضافه شوند و سازگاری را حفظ کنند، فهرست میکند. -
runRealtimeReportاین متد یک گزارش سفارشی از دادههای رویداد بلادرنگ برای ملک شما برمیگرداند. رویدادها چند ثانیه پس از ارسال به گوگل آنالیتیکس، در گزارشهای بلادرنگ ظاهر میشوند. گزارشهای بلادرنگ، رویدادها و دادههای استفاده را برای دورههای زمانی از لحظه حال تا 30 دقیقه پیش (تا 60 دقیقه برای ملکهای گوگل آنالیتیکس 360) نشان میدهند. -
properties.audienceExportsگروهی از متدها که به شما امکان میدهند Audience Exports ایجاد کنید ، که شامل یک snapshot از کاربران یک Audience است. -
properties.recurringAudienceLists(پیشنمایش اولیه) گروهی از متدها که به شما امکان مدیریت خروجیهای مخاطبان تکرارشونده را میدهند. خروجی مخاطبان تکرارشونده هر روز فهرستهای جدیدی از مخاطبان تولید میکند. -
runFunnelReport(پیشنمایش اولیه) این روش یک گزارش قیف سفارشی از دادههای رویداد گوگل آنالیتیکس شما را برمیگرداند. کاوش قیف به شما امکان میدهد مراحلی را که کاربران برای انجام یک کار طی میکنند، تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست میخورند.
ابعاد و معیارهای پشتیبانی شده
برای فهرستی از تمام ابعاد و معیارهای پشتیبانی شده توسط Data API، به مستندات طرحواره API مراجعه کنید.