שימוש ב-Play Age Signals API (בטא)

השימוש ב-Play Age Signals API (בטא) מהווה את הסכמתך לתנאים ולהגבלות ואת הסכמתך לפעול בהתאם לכל כללי המדיניות למפתחים של Google Play. כדי לבקש את הסטטוס וטווח הגילאים של המשתמש, צריך להפעיל את ה-API מהאפליקציה בזמן הריצה. ‫Play Age Signals API מחזיר נתונים רק לגבי משתמשים שנמצאים באזורים שבהם Play נדרש על פי חוק לספק נתונים של קטגוריות גיל.

מערכת Play מחזירה טווח גילאים על סמך קבוצות הגיל שהוגדרו בתחום השיפוט ובאזורים הרלוונטיים. הגילאים שמוחזרים על ידי ה-API כברירת מחדל בתחומי שיפוט ובאזורים רלוונטיים הם 0-12, ‏ 13-15, ‏ 16-17 ו-18 ומעלה, אבל הם עשויים להשתנות בהתאם לדרישות האזוריות.

שילוב של Play Age Signals API באפליקציה

כדי לשלב את Play Age Signals API באפליקציה, מוסיפים את התלות הבאה לקובץ build.gradle של האפליקציה:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

בקשת אותות גיל

דוגמה לשליחת בקשה לאותות גיל:

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

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

(אופציונלי) קבלת טווחי גילאים בהתאמה אישית

טווח הגילאים שמוחזר על ידי ה-API בתחומי שיפוט ובאזורים רלוונטיים הוא 0-12,‏ 13-15,‏ 16-17 ו-18 ומעלה. יכול להיות שהטווחים האלה ישתנו בעתיד בהתאם לדרישות המקומיות.

לחלופין, כדי להתאים אישית את טווחי הגילאים בהתאם לדרישות הגיל המינימליות באפליקציה, אפשר לציין את דרישות הגיל המינימליות האלה באפליקציה בדף אותות גיל ב-Google Play Console. ‫Age Signals API מחזיר את טווחי הגילאים המותאמים אישית. לדוגמה, אם תציינו גילאים מינימליים של 9, 15 ו-17, משתמש בן 14 ייכלל בטווח הגילאים 10-15. ההפרש בין הגילאים המינימליים חייב להיות לפחות שנתיים, ואפשר לשנות אותם פעם בשנה.

כדי להתאים אישית את טווחי הגילאים ש-Age Signals API מחזיר, אפשר לציין דרישות גיל מינימליות לשימוש באפליקציה:

1. עוברים לדף אותות גיל ב-Play Console.
2. בכרטיסייה הגיל המינימלי לשימוש באפליקציה, מזינים עד שלוש דרישות גיל מינימלי לשימוש באפליקציה.
3. לוחצים על שמירה.

תגובות לאותות גיל

התגובה של Play Age Signals API (בטא) כוללת את השדות והערכים הבאים. הערכים עשויים להשתנות. אם רוצים לקבל את הערכים העדכניים ביותר, צריך לשלוח בקשה לתגובת API כשהאפליקציה נפתחת. באחריותכם לספק חוויות שמתאימות לגיל באמצעות האותות האלה.

טיפול בקודי שגיאה של API

אם האפליקציה שולחת בקשה ל-Play Age Signals API (בטא) והקריאה נכשלת, האפליקציה מקבלת קוד שגיאה. השגיאות האלה יכולות לקרות בגלל מגוון סיבות, למשל אם האפליקציה של חנות Play לא עדכנית.

אסטרטגיה של ניסיון חוזר

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