בדף הזה מוסבר איך להשתמש בתכונה "שחזור ערכים לפי מכשיר" כדי לאחסן ולאחזר נתונים בהתאמה אישית במכשירים ספציפיים. אפשר לאחזר את הנתונים המותאמים אישית באופן מהימן גם אם האפליקציה מותקנת באותו מכשיר אחרי שהמכשיר אופס. התכונה הזו מאפשרת לכם לזהות מכשיר ולמנוע שימוש חוזר בו על סמך פעולה או התנהגות שציינתם, תוך שמירה על פרטיות המשתמשים.
איך פועל שחזור הערכים לפי מכשיר?
התכונה "שחזור ערכים לפי מכשיר" מאפשרת לאפליקציות לאחסן ולשחזר נתונים בהתאמה אישית שמשויכים למכשיר ספציפי, תוך שמירה על פרטיות המשתמשים. הנתונים מאוחסנים בשרתים של Google, כך שהאפליקציה יכולה לשחזר באופן מהימן את הנתונים המותאמים אישית גם אחרי שמתקינים אותה מחדש או מאפסים את המכשיר. לדוגמה, אתם יכולים להשתמש בתכונה הזו כדי לאחזר נתונים שמשויכים למכשירים שבהם מצאתם ראיות לניצול חמור לרעה, למכשירים שכבר מימשו פריטים בעלי ערך גבוה (כמו תקופת ניסיון בחינם) או למכשירים שמשמשים שוב ושוב ליצירת חשבונות חדשים למטרות פוגעניות. התכונה "שחזור ערכים לפי מכשיר" שומרת על פרטיות המשתמשים כי האפליקציה ששולחת את הבקשה יכולה לשחזר רק את הנתונים המוגבלים שהיא שייכה למכשירים, בלי לגשת למזהי מכשירים או למזהי משתמשים. אחרי שמפעילים את התכונה "שחזור ערכים לפי מכשיר", אפשר לבצע את הפעולות הבאות:
- קריאת נתונים לכל מכשיר: אתם יכולים לקרוא שלושה ערכים מותאמים אישית או ביטים לכל מכשיר כשאתם מקבלים החלטה לגבי תקינות. אתם יכולים להגדיר משמעות משלכם לערכים האלה. לדוגמה, אתם יכולים להתייחס לערכים כאל שלושה דגלים נפרדים, או לשלב אותם כדי לייצג שמונה תוויות בהתאמה אישית.
- שינוי הנתונים לכל מכשיר: אחרי שמקבלים אסימון תקינות, אפשר להשתמש בו כדי לבצע קריאה מצד השרת לשרת של Google Play כדי לשנות ערך אחד או יותר. יש לכם עד 14 ימים להשתמש בטוקן. כך תוכלו לשנות ערך אם, לדוגמה, ניצול לרעה מתגלה רק בתקופה של שבועיים אחרי שאתם מבצעים בדיקת תקינות בפעם הראשונה. כשמשנים ערך, החודש והשנה שבהם בוצע השינוי נשמרים גם הם.
דרישות מוקדמות ושיקולים לגבי שחזור ערכים לפי מכשיר
אפשר להשתמש בתכונה "שחזור ערכים לפי מכשיר" רק כדי לאחסן ולאחזר מידע לצורך הגנה על אבטחת האפליקציה וצמצום ניצול לרעה, הונאה וגישה לא מורשית. אסור להשתמש בתכונה "שחזור ערכים לפי מכשיר" כדי ליצור טביעת אצבע דיגיטלית או לעקוב אחרי משתמשים או מכשירים ספציפיים, ואסור להשתמש בה כדי לעקוב אחרי מאפיינים רגישים של משתמשים או מכשירים, כמו מגדר, גיל או נתוני מיקום.
כדי להשתמש בתכונה "שחזור ערכים לפי מכשיר", צריך לעמוד בדרישות הבאות:
- אפשר להשתמש בתכונה "שחזור ערכים לפי מכשיר" בטלפונים, בטאבלטים, במכשירים מתקפלים, בטלוויזיות, ברכבים ובמכשירי Wear OS. ב-Wear, התכונה "שחזור ערכים לפי מכשיר" זמינה רק במכשירים עם Wear OS מגרסה 5 ואילך. אין תמיכה בשחזור ערכים לפי מכשיר באמולטורים.
- כדי להשתמש בתכונה "שחזור ערכים לפי מכשיר", צריך להתקין ולהפעיל במכשיר את הגרסאות העדכניות של חנות Google Play ושל Google Play Services.
- כדי להשתמש בתכונה "שחזור ערכים לפי מכשיר", לחשבון המשתמש צריך להיות רישיון Play, אחרת לא תתקבל הערכה.
כשמשתמשים בתכונה "שחזור ערכים לפי מכשיר", צריך להביא בחשבון את השיקולים הבאים שקשורים לתזמון:
- אחרי שמאמתים אסימון תקינות, יש עד 14 ימים להשתמש בו כדי לאחסן נתונים מותאמים אישית של שחזור ערכים לפי מכשיר.
- התכונה "שחזור ערכים לפי מכשיר" כוללת חותמות זמן, כדי שתוכלו לתת עדיפות גבוהה יותר לנתונים ששונו לאחרונה, בהשוואה לנתונים ששונו לפני זמן רב. כדאי להתעלם מהנתונים או לאפס אותם אחרי פרק זמן ארוך מספיק, כדי להביא בחשבון שמכשירים יכולים לעבור ידיים או לעבור חידוש ולהימכר מחדש.
- סיביות ה-Recall של מכשיר יישמרו למשך 3 שנים אחרי הגישה האחרונה לקריאה או לכתיבה.
- אם אתם צריכים למחוק את כל הנתונים שמשויכים למכשיר, האפליקציה יכולה לאפס את כל שלושת הערכים במכשיר הזה ל-false. הפעולה הזו תאפס באופן אוטומטי את חותמות הזמן.
למפתחים עם כמה אפליקציות ולמפתחים שמעבירים אפליקציות, התכונה "שחזור ערכים לפי מכשיר" פועלת באופן הבא:
- לכל האפליקציות בחשבון הפיתוח שלכם ב-Google Play יש גישה לאותם שלושה ערכים בכל מכשיר. במילים אחרות, אם אחת מהאפליקציות משנה את אחד מהערכים, כל האפליקציות יקראו את הערך ששונה כשהן מותקנות באותו מכשיר.
- אם אפליקציה מועברת מחשבון פיתוח אחד לחשבון פיתוח אחר, התכונה "שחזור ערכים לפי מכשיר" תשקף את הנתונים לפי מכשיר של חשבון הפיתוח החדש, ולא את הנתונים לפי מכשיר של חשבון הפיתוח הישן.
הפעלת שחזור ערכים לפי מכשיר
כשהכול מוכן, מפעילים את התכונה "שחזור ערכים לפי מכשיר" ב-Play Console:
- נכנסים ל-Play Console.
- בוחרים את האפליקציה שתשתמש בתכונה "שחזור ערכים לפי מכשיר".
- בתפריט הימני, לוחצים על מוגן על ידי Play.
- לצד Play Integrity API, לוחצים על ניהול.
- בקטע "תשובות" בדף, לוחצים על שינוי התשובות.
- מפעילים את התכונה "שחזור ערכים לפי מכשיר".
- לוחצים על 'שמירת שינויים'.
כשמפעילים או משביתים את התכונה "שחזור ערכים לפי מכשיר", כל תגובות הבדיקה של Play Integrity API שהגדרתם ב-Play Console יימחקו ותצטרכו ליצור אותן מחדש.
קריאת ערכים של שחזור ערכים לפי מכשיר
התכונה "שחזור ערכים לפי מכשיר" פועלת גם בבקשות קלאסיות וגם בבקשות רגילות ב-Play Integrity API. בבקשות רגילות, שחזור הערכים לפי מכשיר מתרענן בקריאת ההפעלה. במילים אחרות, אחרי שמשנים את הנתונים לכל מכשיר, צריך לבצע עוד חימום כדי לראות את הערך המעודכן. אחרי שתפעילו את התכונה "שחזור ערכים לפי מכשיר", תוכלו לקרוא את הערכים של שחזור הערכים לפי מכשיר בהחלטות לגבי תקינות.
שינוי הערכים של "שחזור ערכים לפי מכשיר"
כדי לשנות את הערכים של שחזור ערכים לפי מכשיר, אפשר לבצע קריאה ל-API משרת לשרת, בדומה לפענוח של החלטת התקינות. הגדרה של סיבית לערך true תעדכן גם את תאריך הכתיבה שלה (גם אם הערך שלה כבר היה true). הגדרה של סיבית לערך false תאפס את תאריך הכתיבה שלה לערך ריק. כל הביטים שלא צוינו בבקשה יישארו ללא שינוי. יש עיכוב קל בהפצה בין כתיבת הביטים לבין היכולת לקרוא אותם בחזרה בפסיקה. העיכוב יכול להימשך עד 30 שניות, אבל בדרך כלל הוא קצר בהרבה. בקשות כתיבה של שחזור ערכים לפי מכשיר צריכות להיות פחות תכופות מבקשות של אסימוני תקינות. הן לא נכללות במכסת הבקשות של אסימוני התקינות, אבל כפופות להגבלת קצב של יצירת בקשות נפרדות.
playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
"integrityToken": "INTEGRITY_TOKEN",
"newValues": {
"bitFirst": true,
"bitThird": false
}
}'newValues.BitFirst = true // ForceSendFields optional for value true newValues.BitSecond = false // ForceSendFields required for value false newValues.BitThird = nil // do not set ForceSendFields for unspecified bits newValues.ForceSendFields = []string{"BitSecond"}