חריגות

ה-Google Play Developer Reporting API מאפשר לאחזר אנומליות שזוהו בקבוצות של מדדים. אנומליה נוצרת בכל פעם שערך המדד חורג מהטווח הצפוי של המדד, על סמך הערכים של אותו מדד ב-28 הימים הקודמים. חריגות שמתרחשות בימים עוקבים מוצגות כחריגה אחת.

אם העלייה החריגה בערך של מדד מסוים נמשכת מספיק זמן, מודל הזיהוי מסתגל ומרחיב את הערכים הצפויים עד שנקודות הנתונים הבאות לא נחשבות יותר חריגות.

אחזור אנומליות

אפשר לראות את האנומליות באמצעות המתודה anomalies.list.

בקשה פשוטה:

בקשת ה-HTTP GET הזו מציינת את הפרמטר של שם האפליקציה ומחזירה את הרשימה המלאה של האנומליות שזוהו באפליקציה.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies

תגובה לאנומליה:

התשובה כוללת מספיק מידע כדי לשאול בדיוק איפה התרחשה האנומליה:

{
  "anomalies": [
    {
      "name": "apps/com.example.app/anomalies/12345"
      "metric_set": "apps/com.example.app/anrRateMetricSet"
      "timeline_spec": {
        "aggregation_period": "DAILY"
        "start_time": {
          "year": 2022
          "month": 1
          "day": 23
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
        "end_time": {
          "year": 2022
          "month": 1
          "day": 23
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
      }
      "metric": {
        "metric": "anrRate",
        "decimal_value": {
          "value": "3.1415926535"
        }
      }
    },
    {
      "name": "apps/com.example.app/anomalies/12345"
      "metric_set": "apps/com.example.app/crashRateMetricSet"
      "timeline_spec": {
        "aggregation_period": "DAILY"
        "start_time": {
          "year": 2021
          "month": 12
          "day": 10
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
        "end_time": {
          "year": 2021
          "month": 12
          "day": 10
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
      }
      "metric": {
        "metric": "crashRate",
        "decimal_value": {
          "value": "2.7182818284"
        }
      }
    },
  ]
}

בקשה מסוננת:

אפשר להחיל מסנן כדי להציג רק אנומליות שהיו פעילות בתקופה מסוימת. כדי לעשות את זה, מציינים את הפונקציה activeBetween(start, end) בשדה הסינון בבקשה. אפשר לציין גבולות לא מוגבלים בכל צד של הטווח באמצעות מילת המפתח המיוחדת UNBOUNDED. אם מציינים גבול התחלה או סיום, צריך להשתמש בפורמט RFC 3339, לדוגמה: 2022-02-22T04:00Z.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies?filter=activeBetween("2022-01-01T00:00:00Z", UNBOUNDED)

תשובה מסוננת:

התשובה כוללת רק אנומליות שהיו פעילות בטווח הזמן שצוין:

{
  "anomalies": [
    {
      "name": "apps/com.example.app/anomalies/12345"
      "metric_set": "apps/com.example.app/anrRateMetricSet"
      "timeline_spec": {
        "aggregation_period": "DAILY"
        "start_time": {
          "year": 2022
          "month": 1
          "day": 23
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
        "end_time": {
          "year": 2022
          "month": 1
          "day": 23
          "time_zone": {
            "id": "America/Los_Angeles"
          }
        }
      }
      "metric": {
        "metric": "anrRate",
        "decimal_value": {
          "value": "3.1415926535"
        }
      }
    },
  ]
}

מדדים זמינים

לא כל המדדים וקבוצות המדדים תומכים כרגע בזיהוי אנומליות. זו רשימת המדדים הנתמכים כרגע:

קבוצת מדדים	מדדים נתמכים
vitals.anrrate	anrRate
vitals.crashrate	crashRate
vitals.excessivewakeuprate	excessiveWakeupRate
vitals.stuckbackgroundwakelockrate	stuckBgWakelockRate