التقارير عبر API: الاكتمال والحصص وعمر البيانات

الخلاصة

لا يثبت وصول استجابة واكتمال برنامج استرجاع كل الصفوف. تعتمد الحدود والتأخيرات على الواجهة.

مثال تخيلي: ملاحظة 08:00، إتاحة 08:10، استخراج 08:15، عرض 08:20؛ عمر البيانات 20 دقيقة وعمر الاستخراج 5 دقائق مخطط المنهج · الخطوات موضحة في النص
في هذا المقال

لا يثبت وصول استجابة واكتمال برنامج استرجاع كل الصفوف. تعتمد الحدود والتأخيرات على الواجهة.

فحص نتيجة الاستخراج

افحص الفترة والمنطقة الزمنية والمرشحات والحقول والصفحات والبيانات الوصفية. يصف rowCount في Data API الخاصة بـGA4 كل صفوف نتيجة الاستعلام لا صفحة واحدة فقط. لا يثبت ذلك تغطية كل النشاط الفعلي؛ احترم الحصص وبين الاستخراج الجزئي.

فصل أربعة أوقات

مثال تخيلي، اليوم والمنطقة الزمنية نفسيهما: الملاحظة 08:00، الإتاحة 08:10، الاستخراج 08:15، العرض 08:20. عمر البيانات 20 دقيقة من الملاحظة رغم أن الاستخراج عمره 5 دقائق. تبقى تأخيرات المصادر والتخزين المؤقت في Data Studio وغيره.

مثال تخيلي: أربعة أوقات مختلفة
النقطةالوقت
الملاحظة08:00
الإتاحة08:10
الاستخراج08:15
العرض08:20

المصادر والتحقق

أتمتة الاستخراج مع دليل اكتمال البيانات.

قد يفتقد التقرير المُنشأ بدون أخطاء تقنية صفحات نتائج أو يستخدم مُرشِّحًا مختلفًا. احتفظ بالنطاق الزمني، والمخطط، وقواعد الترقيم، ثم تحقق من الإجماليات والتكرارات. جهِّز إعادة تشغيل الفترة دون فقدان سجل التغييرات.

  • مُرشِّحات الإصدار، والأبعاد، والوحدات، والمنطقة الزمنية، والترقيم.
  • قارن عينة مُستخرجة مع المصدر في نفس الفترة.
  • أعد تشغيل الاستخراج المُقاطع وتحقق من الفقد والتكرارات.

المصدر الأساسي: Google SRE — Data Processing Pipelines. المنهج المرتبط: اقرأ الدليل العملي.

المناطق الزمنية والأحداث المتأخرة

تعتمد فترة التقرير على وقت الحدث وقواعد الإغلاق.

  • سجّل وقت الحدث ووقت الاستلام والمنطقة الزمنية للعمل بشكل منفصل. في مثال افتراضي، تصبح 23:30 UTC الساعة 01:30 من اليوم التالي عند إزاحة ثابتة UTC+02:00. نوع الطابع الزمني مع المنطقة في PostgreSQL لا يحتفظ باسم المنطقة الأصلي.
  • اجعل البداية مشمولة والنهاية غير مشمولة. احسب الحدود في منطقة العمل قبل تحويلها إلى UTC. اختبر تغيير التوقيت الموسمي ونهاية الشهر والتاريخ دون ساعة؛ اليوم المحلي لا يساوي دائماً 24 ساعة.
  • حدّد التأخر المسموح وموعد إغلاق التقرير. كرّر المعرّف نفسه لتمييز الحدث الجديد من النسخة المكررة. احتفظ بالنسخة المنشورة وأثر التصحيح؛ العلامة المائية تقدير للوصول وليست ضماناً لاكتمال البيانات.

حالة قبول قابلة للتكرار

مثال افتراضي: البيانات لا تصف عميلاً أو نتيجة مرصودة.

عرض بيانات الحالة
{
    "event_time": "2026-10-08T23:30:00Z",
    "report_zone": "UTC+02:00",
    "local_time": "2026-10-09T01:30:00+02:00"
}

القرار المتوقع

الحدث يقع في 9 أكتوبر بالمنطقة المحددة. احتفظ أيضاً بلحظة UTC.

إجراء التحقق

  1. حدد منطقة التقرير ولحظة المرجع.
  2. أعد حدثاً قريباً من منتصف الليل.
  3. احتفظ بـ UTC والتاريخ المحلي وقاعدة الإغلاق. أضف وقتاً محلياً ملتبساً أثناء تغيير الساعة؛ واحتفظ بالإزاحة والمنطقة بدلاً من استنتاج لحظة محددة.

PostgreSQL — Date/time types

هل يمكن اعتبار يوم الاستلام يوم الحدث؟

فقط إذا كان تعريف التقرير ينص على ذلك. احتفظ بالوقتين واشرح معالجة الأحداث المتأخرة.

المصدر الأساسي: PostgreSQL — Date/time types. المنهج المرتبط: اقرأ الدليل العملي.