Check out what’s new from Firebase at Google I/O 2022. Learn more

נהל נתוני מזהה מופע

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

מספר שירותי Firebase משתמשים במזהי מופע כדי להפעיל את התכונות שלהם:

  • ניתוח
  • Crashlytics
  • העברת הודעות בענן
  • תצורה מרחוק

נהל נתוני אפליקציה המשויכים למזהי מופע

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

נתונים המשויכים למזהי מופע אינם מזהים באופן אישי, אך עדיין יכול להיות שימושי לתת למשתמשים אפשרות לנהל אותם. לשם כך, Firebase מציעה שתי דרכים לנהל איסוף נתונים הקשורים למופע מזהה:

  • מחק מזהי מופע. אתה יכול למחוק מזהה מופע באמצעות קריאת API בצד השרת או הלקוח. מחיקת מזהה מופע מוחקת את המזהה עצמו ואת כל הנתונים המשויכים אליו.
  • השבת שירותים שמייצרים מזהים. רוב שירותי Firebase המשתמשים במזהי מופע יוצרים באופן אוטומטי מזהה חדש אם אין אחד כזה במכשיר כשהם מופעלים. כדי להבטיח שהאפליקציה שלך לא יוצרת מזהי מופע לא רצויים, השבת את האתחול האוטומטי עבור שירותים אלה.

מחק מזהה מופע

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

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

מחק מזהה עם קריאת לקוח API

כדי למחוק מזהים שנוצרו על ידי שירותי Firebase, התקשר לשיטה המתאימה מממשק ה-API של Firebase Instance ID:

מָהִיר

InstanceID.instanceID().deleteID { error in
  if let error = error {
    print("Error deleting instance ID: \(error)")
  }
}

Objective-C

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
  if error != nil {
    NSLog(@"Error deleting instance ID: %@", error);
  }
}];

דְמוּי אָדָם

FirebaseInstanceId.deleteInstanceId();

מחק מזהה עם קריאת API לשרת

כדי למחוק מזהה מופע עם קריאות לשרת API, הוסף את Firebase Admin SDK לשרת שלך , אם עדיין לא עשית זאת.

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

Node.js

// An Instance ID sent from a client service SDK
const idToDelete = 'INSTANCE_ID';

admin.instanceId().deleteInstanceId(idToDelete);

Java

// An Instance ID sent from a client service SDK
String idToDelete = "INSTANCE_ID";

FirebaseInstanceId.getInstance().deleteInstanceIdAsync(idToDelete).get();

פִּיתוֹן

  from firebase_admin import instance_id

  # An Instance ID sent from a client service SDK
  id_to_delete = 'INSTANCE_ID'

  instance_id.delete_instance_id(id_to_delete)

ללכת

client, err := app.InstanceId(ctx)
if err != nil {
  log.Fatalln("error initializing client", err)
}

iidToDelete := "INSTANCE_ID"
if err := client.DeleteInstanceId(ctx, iidToDelete); err != nil {
  log.Fatalln("error deleting iid", err)
}

כאשר אתה מוחק מזהה מופע עם קריאת API לשרת, שירותי Firebase מוחקים את הנתונים המשויכים, מפסיקים לקבל נתונים חדשים עבור מזהה זה, ותוך מספר ימים, מודיעים לאפליקציית הלקוח שהמזהה נמחק. עד ש-Firebase תודיע לאפליקציית הלקוח, חלק משירותי האפליקציה עשויים לחוות פונקציונליות מופחתת.

אם ברצונך למחוק את מזהה המופע הנוכחי ולהשתמש מיד בשירותי Firebase עם מזהה חדש ועצמאי, השתמש באחד מממשקי ה-API של הלקוח שלמעלה כדי לטפל במחיקה.

השבת יצירת מזהה מופע

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

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

קרא את המדריכים שלהלן כדי לגלות כיצד להשבית אתחול האוטומטי עבור שירותים המשתמשים ב-Instance-ID ובמקום זאת לאתחל אותם באופן ידני: