يشرح هذا الدليل معلومات مهمة حول البيانات التي تظهر في التقارير التي يتم إنشاؤها باستخدام Google Analytics Data API. غالبًا ما يواجه المستخدمون اختلافات بين البيانات التي تعرضها واجهة برمجة التطبيقات (على وجه التحديد طريقة runReport) والبيانات المعروضة في واجهة مستخدم "إحصاءات Google".
جمع العيّنات والتجميع
يمكن أن تعرض طريقة runReport في Google Analytics Data API عيّنات بيانات،
خاصةً لمجموعات البيانات الكبيرة أو طلبات البحث المعقّدة. على الرغم من أنّ واجهة مستخدم "إحصاءات Google" تطبّق أيضًا عملية أخذ العينات، يمكن أن تختلف الحدود الدنيا والخوارزميات المحدّدة، ما يؤدي إلى اختلافات طفيفة في القيم المبلَّغ عنها.
لمعرفة ما إذا كانت نتائج التقرير تستند إلى مجموعة فرعية من البيانات المتاحة، افحص الحقل samplingMetadatas في العنصر ResponseMetaData. إذا تم تحليل عيّنات من نتائج التقرير، يصف هذا الحقل النسبة المئوية للأحداث المستخدَمة في هذا التقرير.
تتيح لك بعض طرق إعداد التقارير في Google Analytics Data API تحديد مستوى تحليل عيّنات البيانات الذي تريده. يمكنك استخدام الحقل
samplingLevel
في طريقة properties.reportTasks.create
للتحكّم في مستوى أخذ العيّنات في التقرير.
تتيح هذه الميزة لمواقع "إحصاءات Google 360" الوصول إلى حدود أعلى لأخذ العينات تبلغ مليار حدث. يمكن أيضًا ضبط حدود أخذ العينات على UNSAMPLED
لاستخدام النتائج غير المستندة إلى عيّنات لأعداد الأحداث الكبيرة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن تحليل عينات البيانات.
تقريب عدد القيم الفريدة
تستخدم Google Analytics Data API خوارزمية HyperLogLog++ (HLL++) لتقدير الأعداد الفريدة لمقاييس مثل "المستخدمون النشطون" و"الجلسات". يتم استخدام هذا النهج في واجهة برمجة التطبيقات وواجهة مستخدم "إحصاءات Google" لتحسين الأداء وإدارة مجموعات البيانات الكبيرة بكفاءة، ما يعني أنّ النتائج هي قيم تقريبية وليست أعدادًا دقيقة.
لمزيد من المعلومات، يُرجى الرجوع إلى المراجع التالية: تقريب الأعداد الفريدة في "إحصاءات Google" والاختلافات في أعداد المستخدمين.
الحد الأدنى للبيانات
قد تطبّق "إحصاءات Google" الحدّ الأدنى للبيانات على التقارير لمنع تحديد هوية المستخدمين الفرديين استنادًا إلى الخصائص الديمغرافية أو الاهتمامات أو الإشارات الأخرى المتوفّرة في البيانات.
إذا كان صف التقرير يحتوي على عدد قليل من المستخدمين، قد يتم استبعاد هذا الصف من النتائج. ويحدث ذلك بشكل أكثر شيوعًا في التقارير التي تتضمّن سمات تتضمّن عددًا كبيرًا من القيم أو سمات مخصّصة.
لمعرفة ما إذا كان هذا التقرير يخضع للحدّ الأدنى، افحص الحقل
subjectToThresholding
في العنصر ResponseMetaData.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحدّ الأدنى للبيانات.
الصف (other)
إذا كانت السمة تتضمّن عددًا كبيرًا من القيم الفريدة، قد تجمع "إحصاءات Google" القيم الأقل شيوعًا في صف يحمل التصنيف (other). ويكون ذلك أكثر شيوعًا في التقارير التي تتضمّن سمات تحتوي على أكثر من 500 قيمة فريدة في اليوم.
عند استخدام الفلاتر مع Data API، يُرجى العِلم أنّ الفلاتر لا تبحث داخل صف (other)، ويتم تطبيقها بعد تجميع البيانات وإنشاء صف (other).
لمعرفة ما إذا كان التقرير يحتوي على بيانات مجمّعة في الصف (other)،
افحص الحقل
dataLossFromOtherRow
للعنصر ResponseMetaData.
لمزيد من المعلومات، اطّلِع على مقالة الصف (غير ذلك) في "إحصاءات Google".
المعلومات التعريفية في التقارير
تحدّد المعلومات التعريفية في التقارير كيفية إزالة تكرار المستخدمين في التقارير. يمكن أن تؤدي إعدادات الهوية المختلفة (مثل "مدمجة" أو "مستندة إلى الجهاز") إلى اختلاف أعداد المستخدمين للنطاق الزمني نفسه.
تستخدم كل من واجهة مستخدم "إحصاءات Google" وData API إعداد المعلومات التعريفية في التقارير نفسه لموقعك. في حال تغيير هذا الإعداد، سيؤثر ذلك في التقارير في كل من واجهة المستخدم وواجهة برمجة التطبيقات. إذا تم تغيير الإعداد بين تنفيذ تقرير في واجهة المستخدم والحصول على بيانات التقرير من خلال واجهة برمجة التطبيقات، قد تختلف أعداد المستخدمين بين التقريرَين للنطاق الزمني نفسه.
خصوصية طلب البحث
لتقليل الاختلافات، تأكَّد من أنّ المَعلمات التالية في طلب بياناتك من واجهة برمجة التطبيقات تتطابق بدقة مع الإعدادات في تقرير واجهة مستخدم "إحصاءات Google":
- النطاقات الزمنية: تأكَّد من أنّ تاريخَي البدء والانتهاء متطابقان.
- السمات والمقاييس: تأكَّد من أنّ السمات والمقاييس في طلب بياناتك من واجهة برمجة التطبيقات هي نفسها السمات والمقاييس في تقرير واجهة مستخدم "إحصاءات Google".
- الفلاتر: تأكَّد من أنّ أي فلاتر للسمات أو المقاييس مطبَّقة في طلب البيانات من واجهة برمجة التطبيقات تتطابق مع تلك المستخدَمة في واجهة المستخدم.
يمكن أن تؤدي إضافة سمات إلى تقرير إلى استخدام عدد أقل من الأحداث في الحسابات. يتم تضمين الأحداث التي تحتوي على بيانات للسمات المطلوبة فقط في التقرير. ونتيجةً لذلك، يمكن أن تؤدي إضافة سمات إلى طلب بحث إلى تغيير القيم المجمّعة للمقاييس في تقرير.
حداثة البيانات
تستغرق "إحصاءات Google" بعض الوقت لمعالجة بيانات الأحداث وتجميعها. عند العمل باستخدام بيانات حديثة جدًا، قد تلاحظ اختلافات طفيفة بين التقارير إذا كان هناك تأخير زمني بين عمليات استرداد البيانات. على سبيل المثال، إذا اطّلعت على تقرير في واجهة المستخدم ثم طلبت من واجهة برمجة التطبيقات الحصول على التقرير نفسه بعد دقائق، قد تكون البيانات قد تغيّرت بسبب عمليات المعالجة والتجميع المستمرة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة سرعة توفُّر البيانات.
بدائل البيانات غير المستندة إلى عينات
إذا كانت حالة الاستخدام تتطلّب بيانات كاملة وغير مستندة إلى عيّنات على مستوى الحدث، ننصحك باستخدام البدائل التالية:
BigQuery Export: BigQuery Export لخدمة "إحصاءات Google"
هي الطريقة المقترَحة للتحليل المتقدّم لبيانات الأحداث الأولية.
إحصاءات 360: تتوفّر للمواقع التي تملك ترخيص "إحصاءات 360" حدود أعلى لأخذ العينات، كما يمكنها الوصول إلى ميزات إعداد تقارير أكثر تفصيلاً.