می‌توانید از Data API برای دسترسی برنامه‌ریزی‌شده به داده‌های گزارش Google Analytics (Google Analytics) استفاده کنید.
درباره دارایی‌های Google Analytics بیشتر بدانید.
داده‌های برگشتی ازسوی API با داده‌های نشان‌داده‌شده در میانای کاربر Google Analytics سازگار است و به‌طور کامل از تنظیمات هویت گزارش‌دهی-- مثل ترکیبی، مشاهده‌شده، یا مبتنی بر دستگاه-- که برای دارایی Google Analytics شما پیکربندی شده است پیروی می‌کند.
در اینجا چند نمونه از مواردی که می‌توانید بااستفاده از Google Analytics Data API v1 گزارش کنید آورده شده است:
- برنامه Android شما در هفته گذشته چند کاربر فعال روزانه داشته است.
- تعداد بازدیدهای صفحه ۱۰ صفحه برتر سایت شما در ۲۸ روز گذشته.
- تعداد کاربران فعال برنامه iOS شما در هر کشور در ۳۰ دقیقه گذشته.
همچنین می‌توانید از «میانای برنامه‌سازی کاربردی داده Google Analytics نسخه ۱» برای انجام کارهای زیر استفاده کنید:
- داشبوردهای سفارشی برای نمایش داده‌های Google Analytics بسازید.
- برای صرفه‌جویی در زمان، تکالیف گزارش‌دهی پیچیده را خودکارسازی کنید.
- داده‌های Google Analytics خود را با سایر برنامه‌های کسب‌وکار ادغام کنید.
ثبات داده‌ها و هویت گزارش‌دهنده
Google Analytics Data API v1 به همان داده‌های گزارش رابط Google Analytics دسترسی دارد. داده‌های برگشتی از API کاملاً از تنظیمات هویت گزارش‌دهی پیکربندی‌شده برای دارایی Google Analytics شما پیروی می‌کند، بنابراین تعداد کاربران، حذف تکراری‌ها، و مدل‌سازی داده‌ها با فضای هویت انتخابی—مثل ترکیبی، مشاهده‌شده، یا مبتنی بر دستگاه—در تنظیمات دارایی شما هماهنگ است.
برای کسب اطلاعات بیشتر درباره اینکه فضاهای هویت مختلف چگونه می‌توانند بر گزارش‌های شما تأثیر بگذارند، به گزارش هویت مراجعه کنید.
شروع کنید
برای شروع، شروع سریع کتابخانه مشتری را ببینید. کتابخانه‌های مشتری در Java، Python، Node.js، و زبان‌های دیگر برای ساده کردن پیاده‌سازی شما وجود دارد.
روش‌های دردسترس
در اینجا فهرستی از روش‌های «میانای برنامه‌سازی کاربردی داده» ارائه شده است. برای جزئیات بیشتر، مستندات مرجع را ببینید.
runReportاین روش گزارش سفارشی‌شده‌ای از داده‌های رویداد Google Analytics شما برمی‌گرداند و روش ترجیحی برای پُرسمان‌های گزارش ساده است.batchRunReportsاین نسخه دسته‌ای از روش runReport است که به شما امکان می‌دهد بااستفاده از یک فراخوانی API واحد، گزارش‌های متعددی تولید کنید.runPivotReportاین روش یک گزارش محوری سفارشی از داده‌های رویداد Google Analytics شما برمی‌گرداند. گزارش‌های محوری نسبت به گزارش‌های معمولی قالب‌های پیشرفته‌تر و گویاتری هستند. هر محور، ستون‌ها و ردیف‌های بُعد نمایان را در پاسخ گزارش توصیف می‌کند.batchRunPivotReportsاین نسخه دسته‌ای از روش runPivotReport است که به شما امکان می‌دهد بااستفاده از یک فراخوانی API، گزارش‌های متعددی تولید کنید.getMetadataاین روش فراداده‌های ابعاد و سنجه‌های دردسترس در روش‌های گزارش‌دهی را برمی‌گرداند. برای کاوش ابعاد و سنجه‌ها استفاده می‌شود. پاسخ این روش همچنین شامل ابعاد و سنجه‌های سفارشی دردسترس برای دارایی Google Analytics مشخص‌شده است.checkCompatibilityاین روش ابعاد و سنجه‌هایی را فهرست می‌کند که می‌توانند به درخواست گزارش اضافه شوند و سازگاری را حفظ کنند.runRealtimeReportاین روش گزارشی سفارشی‌سازی‌شده از داده‌های رویداد هم‌زمان برای دارایی‌تان برمی‌گرداند. رویدادها چند ثانیه پس‌از ارسال به Google Analytics در گزارش‌های هم‌زمان نشان داده می‌شوند. گزارش‌های هم‌زمان رویدادها و داده‌های استفاده را برای دوره‌های زمانی از لحظه کنونی تا ۳۰ دقیقه قبل (تا ۶۰ دقیقه برای دارایی‌های Google Analytics 360) نشان می‌دهد.properties.audienceExportsگروهی از روش‌ها که به شما امکان می‌دهند صادر کردن «مخاطب» را تولید کنید، که شامل نماگرفتی از کاربران در مخاطب است.properties.recurringAudienceLists(پیش‌نمایش اولیه) گروهی از روش‌ها که به شما امکان می‌دهد برون‌بردهای مخاطب تکرارشونده را مدیریت کنید. صادر کردن مخاطب تکرارشونده هر روز فهرست‌های مخاطب جدیدی تولید می‌کند.runFunnelReport(پیش‌نمایش اولیه) این روش گزارش قیف سفارشی‌سازی‌شده‌ای از داده‌های رویداد Google Analytics شما برمی‌گرداند. کاوش قیف به شما امکان می‌دهد مراحلی را که کاربران برای تکمیل یک تکلیف طی می‌کنند به‌تصویر بکشید و به‌سرعت ببینید در هر مرحله چقدر موفق یا ناموفق هستند.properties.chat(نسخه پیش‌نمای اولیه) این روش دسترسی مکالمه‌ای برنامه‌ریزی‌شده به پرسیدن از مشاور در Google Analytics را فراهم می‌کند. می‌توانید درباره داده‌های رویدادتان به زبان طبیعی سؤال بپرسید، تغییرات عملکرد را تشخیص دهید، و اطلاعات آماری ساختاریافته روایی و جدولی دریافت کنید.
ابعاد و سنجه‌های پشتیبانی‌شده
برای فهرست همه ابعاد و سنجه‌های پشتیبانی‌شده توسط «میانای برنامه‌سازی کاربردی داده»، مستندات طرحواره میانای برنامه‌سازی کاربردی را ببینید.