חריגות

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	דירוג
vitals.crashrate	שיעור הקריסות
vitals.excessivewakeuprate	תעריף מוגזם
vitals.stuckbackgroundwakelockrate	תקועBgWakelockRate