דיווח דרך API: שלמות, מכסות וגיל הנתונים

בקצרה

קבלת תשובה וסיום סקריפט אינם מוכיחים שכל השורות נאספו. מגבלות ועיכובים תלויים ב־API.

דוגמה בדיונית: תצפית 08:00, זמינות 08:10, חילוץ 08:15 והצגה 08:20; נתונים בני 20 דקות וחילוץ מלפני 5 דקות תרשים שיטה · השלבים מוסברים בטקסט
במאמר זה

קבלת תשובה וסיום סקריפט אינם מוכיחים שכל השורות נאספו. מגבלות ועיכובים תלויים ב־API.

בדיקת תוצאת החילוץ

בדקו תקופה, אזור זמן, מסננים, שדות, עימוד ומטא־נתונים. ב־GA4 Data API, rowCount מתאר את כלל שורות תוצאת השאילתה ולא רק עמוד אחד. אין בכך הוכחה לכיסוי כל הפעילות בפועל; כבדו מכסות וסמנו חילוץ חלקי.

הפרדת ארבעה מועדים

דוגמה בדיונית באותו יום ובאותו אזור זמן: תצפית 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. שיטה קשורה: קריאת המדריך המעשי.