این راهنما اطلاعات مهمی را درباره داده‌هایی که در گزارش‌های تولیدشده بااستفاده از Google Analytics Data API می‌بینید توضیح می‌دهد. کاربران اغلب با
اختلافاتی بین داده‌های برگردانده‌شده توسط میانای برنامه‌سازی کاربردی (به‌ویژه
روش runReport) و داده‌های نشان‌داده‌شده در میانای کاربر Google Analytics مواجه می‌شوند.
نمونه‌گیری و انبوهش
روش Google Analytics Data API runReport می‌تواند داده‌های نمونه‌گیری‌شده را برگرداند،
به‌ویژه برای مجموعه داده‌های بزرگ یا پُرسمان‌های پیچیده. درحالی‌که
میانای کاربر Google Analytics نیز نمونه‌گیری را اعمال می‌کند، آستانه‌ها و
الگوریتم‌های خاص می‌توانند متفاوت باشند و منجر به تفاوت‌های جزئی در مقادیر گزارش‌شده شوند.
برای اینکه متوجه شوید نتایج گزارش براساس زیرمجموعه‌ای از داده‌های دردسترس است یا نه، فیلد
samplingMetadatas
شیء ResponseMetaData را بررسی کنید. اگر نتایج گزارش نمونه‌برداری شده باشد،
این فیلد درصد رویدادهای استفاده‌شده در این گزارش را شرح می‌دهد.
برخی‌از روش‌های گزارش‌دهی Google Analytics Data API به شما امکان می‌دهند
سطح نمونه‌گیری موردنظرتان را مشخص کنید. می‌توانید از فیلد
samplingLevel
در روش properties.reportTasks.create
برای کنترل سطح نمونه‌گیری گزارش استفاده کنید.
این ویژگی به دارایی‌های Google Analytics 360 امکان می‌دهد به حد نمونه‌گیری بالاتر ۱ میلیارد رویداد دسترسی داشته باشند. همچنین، محدودیت‌های نمونه‌برداری را می‌توان روی UNSAMPLED تنظیم کرد تا از نتایج نمونه‌برداری‌نشده برای تعداد رویدادهای بزرگ استفاده شود.
برای اطلاعات بیشتر، درباره نمونه‌گیری داده‌ها را ببینید.
تخمین تعداد غیرتکراری
Google Analytics Data API از الگوریتم HyperLogLog++ (HLL++) برای تخمین شمارش‌های منحصربه‌فرد برای سنجه‌هایی مانند «کاربران فعال» و «جلسه‌ها» استفاده می‌کند. این رویکرد در میانای برنامه‌سازی کاربردی و میانای کاربر Google Analytics برای بهبود عملکرد و مدیریت کارآمد مجموعه‌داده‌های بزرگ استفاده می‌شود، یعنی نتایج به‌جای شمارش دقیق، تقریبی هستند.
برای اطلاعات بیشتر، به منابع زیر مراجعه کنید: تخمین تعداد یکتا در Google Analytics و تفاوت در تعداد کاربران.
آستانه داده
Google Analytics ممکن است آستانه داده را برای گزارش‌ها اعمال کند تا از شناسایی هریک از کاربران براساس جمعیت‌شناسی، علایق، یا سایر سیگنال‌های موجود در داده‌ها جلوگیری کند.
اگر ردیف گزارش حاوی تعداد کمی کاربر باشد، ممکن است آن ردیف از نتایج حذف شود. این مورد در گزارش‌هایی که شامل ابعاد کاردینالیته بالا یا ابعاد سفارشی هستند رایج‌تر است.
برای اینکه متوجه شوید آیا این گزارش مشمول آستانه‌گذاری است یا نه، فیلد
subjectToThresholding
شیء ResponseMetaData را بررسی کنید.
برای اطلاعات بیشتر، آستانه‌های داده را ببینید.
ردیف (other)
اگر بُعدی دارای تعداد مقادیر متمایز بالا باشد، Google Analytics ممکن است مقادیر کمتر رایج را در ردیفی با برچسب (other) گروه‌بندی کند. این امر در گزارش‌هایی که شامل ابعادی با بیش‌از ۵۰۰ مقدار یکتا در روز هستند رایج‌تر است.
هنگام استفاده از فیلترها با Data API، توجه داشته باشید که فیلترها داخل ردیف (other) را بررسی نمی‌کنند و پس‌از تجمیع داده‌ها و تولید ردیف (other) اعمال می‌شوند.
برای اینکه بفهمید آیا گزارشی حاوی داده‌های جمع‌شده در ردیف (other) است یا نه،
فیلد
dataLossFromOtherRow
شیء ResponseMetaData را بررسی کنید.
برای اطلاعات بیشتر، به ردیف (دیگر) در Google Analytics مراجعه کنید.
هویت گزارش‌کننده
هویت گزارش‌کننده تعیین می‌کند که کاربران چگونه در گزارش‌ها تکرارزدایی شوند. تنظیمات هویت متفاوت (مانند «ترکیبی» یا «مبتنی بر دستگاه») می‌تواند منجر به تعداد کاربران متفاوت برای همان محدوده تاریخ شود.
هم میانای کاربر Google Analytics و هم Data API از تنظیم هویت گزارش‌کننده یکسانی برای دارایی شما استفاده می‌کنند. اگر این تنظیم تغییر کند، بر گزارش‌ها در رابط کاربری و API تأثیر می‌گذارد. اگر تنظیمات بین اجرای گزارش در میانای کاربر و دریافت داده‌های گزارش ازطریق میانای برنامه‌سازی کاربردی تغییر کند، ممکن است تعداد کاربران بین دو گزارش برای همان محدوده تاریخ متفاوت باشد.
ویژگی پُرسمان
برای به‌حداقل رساندن مغایرت‌ها، مطمئن شوید که پارامترهای زیر در درخواست میانای برنامه‌سازی کاربردی شما دقیقاً با تنظیمات گزارش میانای کاربر Google Analytics مطابقت داشته باشد:
- محدوده تاریخ: بررسی کنید که تاریخ شروع و پایان یکسان باشد.
- ابعاد و سنجه‌ها: مطمئن شوید که ابعاد و سنجه‌ها در درخواست API شما با ابعاد و سنجه‌ها در گزارش میانای کاربر Google Analytics یکسان باشد.
- فیلترها: مطمئن شوید که هر فیلتر بُعد یا سنجه‌ای که در درخواست API اعمال شده است با فیلترهای استفاده‌شده در میانای کاربر مطابقت داشته باشد.
افزودن ابعاد به گزارش می‌تواند منجر به استفاده از رویدادهای کمتری در محاسبات شود. فقط رویدادهایی که حاوی داده برای ابعاد درخواستی هستند در گزارش گنجانده می‌شوند. درنتیجه، افزودن ابعاد به پُرسمان می‌تواند مقادیر انبوهشی سنجه‌ها را در گزارش تغییر دهد.
تازگی داده‌ها
Google Analytics برای پردازش و تجمیع داده‌های رویداد به زمان نیاز دارد. هنگام کار با داده‌های بسیار جدید، اگر تأخیر زمانی بین بازیابی داده‌ها وجود داشته باشد، ممکن است تفاوت‌های جزئی بین گزارش‌ها مشاهده کنید. برای مثال، اگر گزارشی را در میانای کاربر مشاهده کنید و سپس چند دقیقه بعد همان گزارش را ازطریق API پُرسمان کنید، ممکن است داده‌ها به‌دلیل پردازش و انبوهش مداوم تغییر کرده باشند.
برای اطلاعات بیشتر، تازگی داده‌ها را ببینید.
جایگزین‌های داده‌های نمونه‌گیری‌نشده
اگر مورد استفاده شما به داده‌های کامل، نمونه‌برداری‌نشده، و در سطح رویداد نیاز دارد، استفاده از گزینه‌های جایگزین زیر را درنظر بگیرید:
BigQuery Export: BigQuery Export برای Google Analytics
روش توصیه‌شده برای تجزیه‌وتحلیل پیشرفته داده‌های رویداد خام است.
Analytics 360: دارایی‌های دارای پروانه Analytics 360 حد نمونه‌گیری بالاتری دارند و به ویژگی‌های گزارش‌دهی دقیق‌تری دسترسی دارند.