במסמך הזה מוסברות התגובות של אותות הגיל שמוחזרות על ידי Play Age Signals API.
(אופציונלי) קבלת טווחי גילאים בהתאמה אישית
טווחי הגיל שמוחזרים כברירת מחדל על ידי ה-API הם 0-12, 13-15, 16-17 ו-18+.
לחלופין, כדי להתאים אישית את טווחי הגילאים שמוחזרים כברירת המחדל בהתאם לדרישות הגיל המינימלי באפליקציה, אתם יכולים לציין את דרישות הגיל המינימלי באפליקציה בדף אותות הגיל ב-Google Play Console.
- עוברים לדף אותות גיל ב-Play Console.
- בכרטיסייה טווחי גילאים בהתאמה אישית, מזינים עד שלושה גילים מינימליים לאפליקציה. הגילים המינימליים צריכים להיות בהפרש של שנתיים לפחות, ואפשר לשנות אותם פעם בשנה.
- לוחצים על שמירה.
טווחי הגילאים שיוחזרו יחליפו את התגובה שמוגדרת כברירת מחדל מה-API. לדוגמה:
- אם הגדרתם גיל מינימלי אחד (15) ב-Google Play Console:
- אם הגיל הוא בין 0 ל-14, הפונקציה תחזיר את הערכים
ageLower = 0ו-ageUpper = 14. - אם הילד או הילדה בני 15 ומעלה, יוחזר הערך
ageLower = 15.
- אם הגיל הוא בין 0 ל-14, הפונקציה תחזיר את הערכים
- אם מגדירים שני גילים מינימליים (13 ו-17):
- אם הילד או הילדה בגיל 0 עד 12, יוחזרו הערכים
ageLower = 0ו-ageUpper = 12. - אם המשתמש בן 13 עד 16, יוחזרו הערכים
ageLower = 13ו-ageUpper = 16. - אם המשתמש בן 17 ומעלה, יוחזר הערך
ageLower = 17.
- אם הילד או הילדה בגיל 0 עד 12, יוחזרו הערכים
- אם מגדירים שלושה גילים מינימליים (11, 13 ו-15):
- אם הילד או הילדה בגיל 0 עד 10, יוחזרו הערכים
ageLower = 0ו-ageUpper = 10. - אם הילד או הילדה בני 11 או 12, יוחזרו הערכים
ageLower = 11ו-ageUpper = 12. - אם המשתמש בן 13 או 14, יוחזרו הערכים
ageLower = 13ו-ageUpper = 14. - אם הילד או הילדה בני 15 ומעלה, יוחזר הערך
ageLower = 15.
- אם הילד או הילדה בגיל 0 עד 10, יוחזרו הערכים
שדות התשובה של אותות הגיל
התגובה של Play Age Signals API (בטא) כוללת את השדות והערכים הבאים. אתם אחראים לספק חוויות שמתאימות לגיל של המשתמשים על סמך האותות האלה.
| שדה תשובה | סוג | ערכים | תיאור |
|---|---|---|---|
| ageRangeSource | טיפוסים בני מנייה (enum) |
|
|
| ageLower | מספר שלם |
|
הגבול התחתון הכולל של טווח הגילאים של המשתמש. משלבים אותו עם ageUpper כדי לקבוע את הטווח.
הפונקציה מחזירה null אם הערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED. |
| ageUpper | מספר שלם |
|
הגבול העליון הכולל של טווח הגילאים של המשתמש.
הפונקציה מחזירה את הערך null עבור טווח הגילאים הגבוה ביותר (לדוגמה, 18+) או אם הערך של ageSignalsStatus הוא NOT_SHARED או VERIFICATION_REQUIRED. |
| significantChangeStatus | טיפוסים בני מנייה (enum) |
|
הפונקציה הזו מחזירה ערך שאינו null רק בתחומי שיפוט שבהם חלים שינויים משמעותיים.
|
| significantChangeApprovalDate | תאריך |
|
מועד הכניסה לתוקף של השינוי המשמעותי האחרון שאושר. כל השינויים עם מועדי כניסה לתוקף לפני התאריך הזה גם מאושרים. הפונקציה מחזירה את הערך null אם אין שינויים.
אפשר לשלב את זה עם `significantChangeStatus` כדי לקבל את סטטוס האישור של השינוי המשמעותי הזה |
| installId | מחרוזת |
|
מזהה שמוקצה על ידי 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").