הסבר על התשובות שמתקבלות מאותות גיל

במסמך הזה מוסברות התגובות של אותות הגיל שמוחזרות על ידי Play Age Signals API.

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

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

לחלופין, כדי להתאים אישית את טווחי הגילאים שמוחזרים כברירת המחדל בהתאם לדרישות הגיל המינימלי באפליקציה, אתם יכולים לציין את דרישות הגיל המינימלי באפליקציה בדף אותות הגיל ב-Google Play Console.

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

טווחי הגילאים שיוחזרו יחליפו את התגובה שמוגדרת כברירת מחדל מה-API. לדוגמה:

  • אם הגדרתם גיל מינימלי אחד (15) ב-Google Play Console:
    • אם הגיל הוא בין 0 ל-14, הפונקציה תחזיר את הערכים ageLower = 0 ו-ageUpper = 14.
    • אם הילד או הילדה בני 15 ומעלה, יוחזר הערך ageLower = 15.
  • אם מגדירים שני גילים מינימליים (13 ו-17):
    • אם הילד או הילדה בגיל 0 עד 12, יוחזרו הערכים ageLower = 0 ו-ageUpper = 12.
    • אם המשתמש בן 13 עד 16, יוחזרו הערכים ageLower = 13 ו-ageUpper = 16.
    • אם המשתמש בן 17 ומעלה, יוחזר הערך ageLower = 17.
  • אם מגדירים שלושה גילים מינימליים (11, 13 ו-15):
    • אם הילד או הילדה בגיל 0 עד 10, יוחזרו הערכים ageLower = 0 ו-ageUpper = 10.
    • אם הילד או הילדה בני 11 או 12, יוחזרו הערכים ageLower = 11 ו-ageUpper = 12.
    • אם המשתמש בן 13 או 14, יוחזרו הערכים ageLower = 13 ו-ageUpper = 14.
    • אם הילד או הילדה בני 15 ומעלה, יוחזר הערך ageLower = 15.

שדות התשובה של אותות הגיל

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

שדה תשובה סוג ערכים תיאור
ageRangeSource טיפוסים בני מנייה (enum)
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • ‫TIER_A: המשתמש סיפק ל-Google את פרטי הגיל שלו. יכול להיות ש-Google אימתה את המידע הזה, ויכול להיות שלא.
  • ‫TIER_B: הגיל של המשתמש מנוהל על ידי הורה או אפוטרופוס.
  • ‫TIER_C*: גיל המשתמש מוערך על סמך כרטיס אשראי, כתובת אימייל, הערכת תמונת סלפי, תעודה מזהה רשמית או מזהה מס.
  • ‫TIER_D*: גיל המשתמש נבדק באמצעות שילוב של תעודה מזהה רשמית והערכת תמונת סלפי, או תעודה מזהה דיגיטלית.
  • ‫null: מוחזר כשהערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED.
* מוחזר רק באזורים בפיקוח שבהם חובה לאמת את הגיל (לדוגמה, US-TX).
ageLower מספר שלם
  • 0 עד 18
  • null
הגבול התחתון הכולל של טווח הגילאים של המשתמש. משלבים אותו עם ageUpper כדי לקבוע את הטווח.

הפונקציה מחזירה null אם הערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED.

ageUpper מספר שלם
  • ‫2 עד 18
  • null
הגבול העליון הכולל של טווח הגילאים של המשתמש.

הפונקציה מחזירה את הערך null עבור טווח הגילאים הגבוה ביותר (לדוגמה, ‎18+‎) או אם הערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED.

significantChangeStatus טיפוסים בני מנייה (enum)
  • אושר
  • בהמתנה
  • נדחה
  • null
הפונקציה הזו מחזירה ערך שאינו null רק בתחומי שיפוט שבהם חלים שינויים משמעותיים.
  • אושר: השינוי המשמעותי האחרון (וכל השינויים הקודמים) אושר.
  • בהמתנה: ההורה עדיין לא אישר שינוי משמעותי אחד או יותר שנמצא בהמתנה.
  • נדחה: ההורים דחו את הבקשה לאישור של שינוי משמעותי אחד או יותר.
  • ‫null: מוחזר במקרים הבאים:
    • כל החשבונות הלא מפוקחים
    • חשבונות בפיקוח שעדיין לא תועדו בהם שינויים משמעותיים.
significantChangeApprovalDate תאריך
  • DateStamp
  • null
מועד הכניסה לתוקף של השינוי המשמעותי האחרון שאושר. כל השינויים עם מועדי כניסה לתוקף לפני התאריך הזה גם מאושרים. הפונקציה מחזירה את הערך null אם אין שינויים.

אפשר לשלב את זה עם `significantChangeStatus` כדי לקבל את סטטוס האישור של השינוי המשמעותי הזה

installId מחרוזת
  • אלפאנומרי
  • null
מזהה שמוקצה על ידי Google Play להתקנות של משתמשים בפיקוח, ומשמש כדי להודיע לכם על ביטול האישור של האפליקציה. עיינו במסמכי התיעוד בנושא ביטול אישורים של אפליקציות.

דוגמה 1

אם משתמש מבוגר אימת את הגיל שלו באמצעות תעודה מזהה דיגיטלית, אתם מקבלים את הפרטים הבאים:

  • באזור מפוקח שבו חובה לאמת את הגיל:

    • ageRangeSource היא AgeRangeSource.TIER_D.
    • ‫ageLower הוא מספר (לדוגמה, 18).
    • ageUpper היא null.
    • שדות התגובה האחרים הם null.
  • בכל מקום אחר:

    • ageRangeSource היא AgeRangeSource.TIER_A.
    • ‫ageLower הוא מספר (לדוגמה, 18).
    • ageUpper היא null.
    • שדות התגובה האחרים הם null.

דוגמה 2

אם המשתמש הוא מבוגר שאימת את הגיל שלו באמצעות שיטות להערכת גיל (כמו הערכת תמונת סלפי, כרטיס אשראי או מזהה מס), תקבלו את הפרטים הבאים:

  • באזור מפוקח שבו חובה לאמת את הגיל:

    • ageRangeSource היא AgeRangeSource.TIER_C.
    • ‫ageLower הוא מספר (לדוגמה, 18).
    • ageUpper היא null.
    • שדות התגובה האחרים הם null
  • בכל מקום אחר:

    • ageRangeSource היא AgeRangeSource.TIER_A.
    • ‫ageLower הוא מספר (לדוגמה, 18).
    • ageUpper היא null.
    • שדות התגובה האחרים הם null.

דוגמה 3

אם המשתמש נמצא באזור שבו לא חובה לאמת את הגיל, והוא משתף את הגיל עם אפליקציות, תקבלו את הפרטים הבאים:

  • ageRangeSource היא AgeRangeSource.TIER_A.
  • ‫ageLower הוא מספר (לדוגמה, 18).
  • ageUpper היא null.
  • שדות התגובה האחרים הם null.

דוגמה 4

אם מדובר במשתמש קטין בפיקוח שהגיל שלו מנוהל על ידי אפוטרופוס ששיתף אותו עם אפליקציות, תקבלו את הפרטים הבאים:

  • ageRangeSource היא AgeRangeSource.TIER_B.
  • ‫ageLower הוא מספר (לדוגמה, 13).
  • ‫ageUpper הוא מספר (לדוגמה, 15).
  • שדות התגובה האחרים הם null.

דוגמה 5

אם המשתמש לא הסכים (או שההורה שלו לא הסכים) לשתף את הגיל באזור שבו לא חובה לאמת את הגיל, תקבלו את התגובה הבאה:

  • ageRangeSource היא null.
  • ageLower היא null.
  • ageUpper היא null.
  • שדות התגובה האחרים הם null.

דוגמה 6

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

  • ageRangeSource היא AgeRangeSource.TIER_B.
  • ‫ageLower הוא מספר (לדוגמה, 13).
  • ‫ageUpper הוא מספר (לדוגמה, 15).
  • significantChangeStatus היא SignificantChangeStatus.APPROVED.
  • ‫significantChangeApprovalDate הוא תאריך (לדוגמה, "2026-01-15").
  • ‫installId הוא מזהה מחרוזת (לדוגמה, "abc123xyz789").