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