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

במסמך הזה מוסבר על התגובות של אותות הגיל שמוחזרות על ידי 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: המשתמש הצהיר על הגיל שלו.
  • ‫TIER_B: הגיל של המשתמש מנוהל על ידי הורה או אפוטרופוס.
  • TIER_C: הגיל של המשתמש מוערך באמצעות כרטיס אשראי, כתובת אימייל, הערכת תמונת סלפי, תעודה מזהה רשמית או מזהה מס.
  • ‫TIER_D: הגיל של המשתמש נבדק באמצעות שילוב של תעודה מזהה רשמית והערכה של תמונת סלפי, או באמצעות תעודה מזהה דיגיטלית.
  • ‫null: מוחזר כשהערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED.
ageLower מספר שלם
  • ‫0 עד 18
  • null
 הגבול התחתון של טווח הגילאים של המשתמש, כולל. אפשר לשלב אותו עם ageUpper כדי לקבוע את הטווח.

הפונקציה מחזירה null אם הערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED.
ageUpper מספר שלם
  • ‫2 עד 18
  • null
 הגבול העליון של טווח הגילאים של המשתמש, כולל.

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

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

דוגמה 1

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

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

דוגמה 2

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

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

דוגמה 3

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

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

דוגמה 4

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

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

דוגמה 5

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

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

דוגמה 6

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

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