השקנו את הקישורים הדינמיים ב-Firebase לפני יותר מ-7 שנים כדי להפוך את כתובות ה-URL ליעילות יותר – לדוגמה, שינוי דינמי של יעד הקישור על סמך תנאי זמן הריצה.
במהלך השנים, הסביבות של האינטרנט והנייד התפתחו עם טכנולוגיות כמו קישורים לאפליקציות, Google Play ללא התקנה, קישורים אוניברסליים וApp Clips, והפכו את התהליכים שעוברים המשתמשים באפליקציות ובאינטרנט לחלקים וצפויים יותר עבור משתמשי האפליקציה שלכם. אנחנו מאמינים שאתם והמשתמשים שלכם תפיקו תועלת רבה יותר אם תאמצו את הטכנולוגיות האלה באופן ישיר ותמשיכו לקדם את הסביבה העסקית. עם זאת, לצד השינויים החדשים האלה, גם ממשקי ה-API המקוריים שעליהם נבנו הקישורים הדינמיים ב-Firebase התפתחו והציבו אתגרים חדשים.
לדוגמה, שינויים במערכת האקולוגית השפיעו על היכולת שלנו לספק חוויה יציבה ועקבית באחת מהתכונות העיקריות של קישורים דינמיים ב-Firebase – מעבר חלק של משתמשי האפליקציה לאפליקציה אחרי ההתקנה, בלי קשר לפלטפורמה.
במקום להמשיך לתמוך בחוויית שימוש לא אידיאלית, החלטנו להוציא משימוש את קישורים דינמיים ב-Firebase ולמקד מחדש את המשאבים שלנו בפתרון בעיות אחרות של מפתחים.
אנחנו מבינים שהשינוי הזה ידרוש ממך זמן כדי לבחון ולאמץ פתרונות חלופיים או ספקי פלטפורמות בשוק.
אנחנו ממשיכים לפתח את Firebase כדי לענות על הצרכים שלכם, ככל שהסביבה העסקית ממשיכה להתפתח ולהשתנות. נמשיך להשיק תכונות חדשות ועדכונים במוצרי Firebase, ואנחנו מחויבים לעזור לכם להצליח בתהליך הפיתוח של האפליקציות.
מה חשוב לדעת?
ב-25 באוגוסט 2025, הקישורים הדינמיים ב-Firebase יושבתו. כל הקישורים שמוצגים על ידי קישורים דינמיים ב-Firebase (גם אלה שמתארחים בדומיינים מותאמים אישית וגם אלה שמתארחים בתת-דומיינים של page.link) יפסיקו לפעול, ולא תוכלו יותר ליצור קישורים חדשים.
כדי לעזור לכם להחליט איך להעביר את הנתונים מקישורים דינמיים ב-Firebase, נמשיך לעדכן את מסמך השאלות הנפוצות הזה במידע נוסף שכדאי להביא בחשבון, וגם נספק מדריכים להעברת נתונים בתרחישים שונים שעשויים להתאים לאופן שבו אתם משתמשים בקישורים דינמיים ב-Firebase כיום.
אנחנו גם נמשיך לעדכן את המדריך הזה עם עוד שאלות נפוצות ככל שנתקרב לתאריך היעד של הוצאת ה-API משימוש ב-25 באוגוסט 2025, וככל שנגלה בעיות נוספות בזמן שנעזור לכם במאמצי ההעברה.
ריכזנו כאן תשובות לכמה מהשאלות הנפוצות ביותר.
כדי להתחיל את ההעברה, כדאי לעיין בקטע "איך מעבירים את הנתונים מהשירות" בשאלות הנפוצות שבהמשך.
מתי הקישורים הדינמיים ב-Firebase יפסיקו לפעול?
ב-25 באוגוסט 2025, הקישורים הדינמיים ב-Firebase יושבתו. כל הקישורים שמוצגים על ידי קישורים דינמיים ב-Firebase (גם אלה שמתארחים בדומיינים מותאמים אישית וגם אלה שמתארחים בתת-דומיינים של page.link) יפסיקו לפעול.
כמה זמן יהיה לי כדי לבצע את ההעברה?
צריך להשלים את ההעברה עד 25 באוגוסט 2025.
האם קישורים חדשים וקיימים ימשיכו לפעול?
כן, הקישורים החדשים והקיימים ימשיכו לפעול עד ששירות Dynamic Links יושבת ב-25 באוגוסט 2025.
האם אוכל לשמור או להעביר את הדומיינים מסוג .page.link שהוקצו באופן אוטומטי ומשמשים לקישורים?
לא, אחרי ששירות הקישורים הדינמיים ב-Firebase יושבת, כל הדומיינים מסוג .page.link לא יהיו זמינים יותר. מומלץ לעיין ברשימת השאלות הזו כדי להבין איך הכי כדאי להעביר את הנתונים מהשירות. אם אתם צריכים שוויון מלא בתכונות, פעלו לפי ההנחיות האלה כדי לייצא את המטא-נתונים ולעבור לספק שירות אחר של קישורי עומק באמצעות דומיין חדש.
מה יקרה לקישורים ולאפליקציות שלי כשהתמיכה בקישורים דינמיים ב-Firebase תופסק (ב-25 באוגוסט 2025)?
כשהתמיכה בקישורים דינמיים ב-Firebase תופסק:
- כל הקישורים שמשתמשי הקצה ילחצו עליהם יחזירו תגובת סטטוס HTTP 404.
כל בקשות ה-HTTP אל:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (ממשק API של סטטיסטיקות קישורים)
תחזיר תגובה עם סטטוס HTTP 400/403.
תגובות השגיאה שלמעלה יתחילו להופיע בהדרגה ב-25 באוגוסט 2025, עד שבסופו של דבר שיעור תגובות השגיאה יגיע ל-100% אחרי תאריך ההוצאה משימוש.
ההתנהגות הבאה מבוססת על גרסת פלטפורמת ה-SDK והקריאה ל-API שבוצעה באפליקציה:
iOS
תרחיש שימוש קריאה ל-API קוד סטטוס התנהגות האם האפליקציה תקרוס? יצירת קישור קצר shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 השגיאה מופיעה עם סיבת הכשל לא* שיוך (Attribution) של אירועי first_open הפונקציה נקראת באופן אוטומטי ב-FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)
400 לא מופיעות שגיאות, אבל נשלח בחזרה אובייקט FDL עם נתונים ריקים. לא* פתיחה מחדש של השיוך (Attribution) handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 השגיאה מופיעה עם סיבת הכשל לא* Android
תרחיש שימוש קריאה ל-API קוד סטטוס התנהגות האם האפליקציה תקרוס? יצירת קישור קצר buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
403 השגיאה מופיעה עם סיבת הכשל לא* שיוך (Attribution) של אירועי first_open getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 המשימה מחזירה תגובת הצלחה, אבל נתוני ה-FDL יהיו ריקים לא* פתיחה מחדש של השיוך (Attribution) getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 המשימה מחזירה תגובת הצלחה, אבל נתוני ה-FDL יהיו ריקים לא* קבל את ההזמנה מודול AppInvite ב-Google Play Services מופעל כשמטפלים בהפניה ל-Intent (מ- *.page.link או מדומיין מותאם אישית) 400 מוצג סמל של סימן גרפי שפעולה מתבצעת כשמופעלים Google Play Services, והוא נעלם כשמוחזרת תגובה 400 לא*
איך אפשר להעביר את הנתונים מהשירות?
גילינו שלמפתחים שונים יש צרכים שונים בכל מה שקשור לשימוש בקישורים דינמיים ב-Firebase.
בהתאם לתרחישי השימוש שלכם ולהערכת השימוש בקישורים הדינמיים ב-Firebase, סביר להניח שאחד מהתרחישים הבאים יתאים לצרכים שלכם.
מה צריך לעשות אם רוצים להשתמש בכל התכונות של "קישורים דינמיים ב-Firebase"?
במקרה כזה, מומלץ להשתמש בספקי שירות אחרים של קישורי עומק, כמו Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular וספקים דומים אחרים בשוק. (הערה: הספקים האלה לא נבדקו על ידי Google, אבל הם מספקים פונקציונליות דומה לזו של Firebase Dynamic Links).
אתם יכולים גם לייצא את המטא-נתונים של קישורי העומק, וכך להעביר את הקישורים בקלות רבה יותר לספק שתבחרו.
כדי למצוא ספק עם תכונות שדומות לקישורים דינמיים ב-Firebase, אפשר להיעזר ברשימת התכונות הבאה.
התכונות של קישורים דינמיים ב-Firebase:
- מפנה את המשתמשים לחנות המתאימה למכשיר שלהם בלחיצה אחת (ומחזירה לדף אינטרנט במקרה הצורך)
- המשתמשים יכולים להמשיך את התהליך אחרי שהם מורידים ומתקינים את האפליקציה דרך קישור עומק מוגדר מראש.
- מספקת למשתמשים חוויה תלוית-הקשר באמצעות תוכן עם קישורי עומק באפליקציה (אם היא כבר מותקנת)
- מספק נתוני ניתוח שקשורים לאירועים מסוג קליק על קישור דינמי
- מאפשר ליצור כתובות URL של קישורים מקוצרים
- מאפשרת להוסיף מטא-נתונים לקישורים לשיתוף במדיה חברתית
מה לעשות אם חשוב לי רק להפנות משתמשים בקישורי עומק לאפליקציה שלי אחרי שהיא כבר הותקנה?
בתרחיש הזה, מומלץ להשתמש בקישורים לאפליקציה ובקישורים אוניברסליים, שהם דרכים שנתמכות בפלטפורמה ומאפשרות למפתחים לספק למשתמשים חוויות של קישורי עומק.
במדריך הזה מוסבר איך לעבור לשימוש בקישורי עומק לאפליקציה ובקישורים אוניברסליים.
במדריך הזה מוסבר גם איך להשתמש באירוח ב-Firebase כדי לארח את קובצי האימות הנדרשים של הדומיין ושל קישורי הנכסים בדומיין שבו אתם מתכננים להשתמש לקישורים החדשים (למשל, קובץ assetlinks.json לקישורים לאפליקציה, קובץ apple-app-site-association לקישורים אוניברסליים).
מה קורה אם האפליקציה שלי כבר לא צריכה תכונות של קישורים דינמיים ב-Firebase ואין צורך להחליף אותם?
בתרחיש הזה, יכול להיות שלא תצטרכו לבצע שום פעולה באפליקציה כדי להתכונן להוצאה משימוש, אבל אנחנו ממליצים:
לבדוק את הקישורים הדינמיים הקיימים ב-Firebase לפי המדריך לייצוא המטא-נתונים של הקישורים, כדי לוודא שהמשתמשים והאפליקציה לא יושפעו כשהקישורים לא יוצגו יותר.
מחיקת הקידומות של כתובות ה-URL של הקישורים הדינמיים ב-Firebase במסוף Firebase. הערה: דומיינים עם קידומת URL יימחקו באופן אוטומטי אחרי 25 באוגוסט 2025.
הסרת ה-SDK להטמעת קישורים דינמיים ב-Firebase מהאפליקציות.
אם אתם רואים תרחיש העברה שלא עונה על הצרכים שלכם, פנו אלינו כדי ליידע אותנו.
מה צריך לעשות אחרי שמסיימים את ההעברה?
אחרי שמסיימים את ההעברה מ-Firebase Dynamic Links, חשוב למחוק את כל הקידומות של דומייני ה-URL (דומיינים של FDL) שמשויכות לקישורים הדינמיים ב-Firebase הקודמים בפרויקט.
כדי לעשות את זה:
- מעבר לקטע "קישורים דינמיים ב-Firebase" במסוף Firebase
בוחרים את הקידומת של כתובת ה-URL שרוצים למחוק מהבורר שבצד ימין
לוחצים על סמל האפשרויות הנוספות (3 נקודות) לצד הלחצן "קישור דינמי חדש"
בחירה באפשרות "מחיקת קידומת של כתובת URL"
מזינים את הקידומת של כתובת ה-URL כדי לאשר שרוצים למחוק אותה, ולוחצים על "מחיקת הקידומת של כתובת ה-URL".
אחרי שתסיימו למחוק את כל הקידומות של הדומיינים של כתובות ה-URL, הפרויקט ב-Firebase יסומן כפרויקט שההעברה שלו מקישורים דינמיים ב-Firebase הושלמה. הפעולה הזו תסיר גם את התזכורת הקופצת שאולי ראיתם במסוף Firebase של הפרויקט.
חשוב לזכור שהפעולה הזו תמחק את כל הקישורים הדינמיים ב-Firebase, אז לפני שמוחקים את הקידומות של הדומיינים של כתובות ה-URL, צריך לוודא שההעברה מהשירות הושלמה.
האם עדיין אוכל להשתמש בממשקי ה-API של קישורים דינמיים ב-Firebase?
ממשקי ה-API של הקישורים הדינמיים ב-Firebase לקישורים מקוצרים ול-Analytics יישארו זמינים עד לתאריך ההוצאה משימוש ב-25 באוגוסט 2025.
אחרי התאריך הזה, ממשקי ה-API האלה לא יהיו זמינים יותר לשימוש, והשירות יושבת.
איך מייצאים את המטא-נתונים של הקישורים?
במדריך לייצוא המטא-נתונים של הקישורים מוסבר איך לייצא את המטא-נתונים של הקישורים.
איך אפשר לקבל את נתוני הניתוח של הקישורים הדינמיים ב-Firebase?
אתם יכולים להשתמש במדריך הייצוא כדי לאחזר את המטא-נתונים של הקישורים הדינמיים ב-Firebase, כולל הקישור עצמו.
אתם יכולים להשתמש ב-Firebase Dynamic Links Analytics API כדי לאחזר נתונים סטטיסטיים של קישורים לכל אחד מהקישורים הדינמיים ב-Firebase. ה-API הזה של Analytics מוגבל לכ-5 שאילתות לשנייה. בדוגמה הזו של Cloud Task מוסבר איך לפעול במסגרת מגבלת הבקשות כשמשתמשים ב-API.
אתם יכולים גם להשתמש ב-Google Analytics ולייצא את הנתונים שלכם עבור קבוצת משנה של נתוני ניתוח קישורים, כולל אירועים של עדכוני אפליקציות שהם ייחודיים ל-Google Analytics.
אם אתם צריכים קצב בקשות גבוה יותר כדי להעביר את הנתונים, פנו אלינו דרך התמיכה של Firebase.
מה יקרה למטא-נתונים של קישורים קיימים אחרי תאריך הסגירה (25 באוגוסט 2025)?
המטא-נתונים של הדומיין והקישורים יסומנו למחיקה ב-25 באוגוסט 2025, ויוסרו בהתאם למדיניות שמירת הנתונים שלנו.
ההשפעה של קישורים דינמיים ב-Firebase על תהליכי האימות ב-Firebase
אני רוצה להפעיל אימות באמצעות קישור באימייל ב-Firebase Authentication בפרויקט שלי. האם אצטרך להגדיר קישורים דינמיים ב-Firebase?
לא, אתם לא צריכים להגדיר קישורים דינמיים ב-Firebase כי כבר אי אפשר להגדיר אותם. במקום זאת, אתם יכולים לפעול לפי המדריכים המעודכנים לתחילת העבודה עם אימות באמצעות קישור באימייל כדי להפעיל ולהטמיע אותו בפרויקט:
כאן מופיעה הרשימה המלאה של הפעולות שיושפעו מהשינוי הזה.
איך השינוי משפיע על תכונות האימות הבאות: אימות באמצעות קישור באימייל, איפוס סיסמה ואימות אימייל?
אימות באמצעות קישור באימייל ופעולות באימייל מחוץ לרשת (OOB) באמצעות Firebase ימשיכו לפעול, אבל תצטרכו לשדרג לגרסאות העדכניות ביותר של ערכות ה-SDK של Firebase Authentication ולעבור לפתרון החדש כדי להמשיך להשתמש בפעולות האלה אחרי שהשירות של Firebase Dynamic Links יושבת ב-25 באוגוסט 2025.
כדי להשלים את ההעברה, אתם יכולים לפעול לפי ההוראות במדריכים שבקישורים הבאים:
כאן אפשר לראות את הרשימה המלאה של הפעולות שמושפעות מההגדרה הזו.
איך מושפעות הטמעות של תהליך OAuth עם גרסאות של אימות ב-Firebase Android SDK שמתחת לגרסה 20.0.0 או גרסאות BoM שמתחת לגרסה 26.0.0?
כדי להמשיך להשתמש בהטמעה של תהליך OAuth באפליקציות ל-Android, צריך לעדכן לגרסה האחרונה של Firebase Authentication Android SDK (גרסה 20.0.0 לפחות).
האם יש השפעה על פעולות אימייל של אימות ב-Firebase באפליקציות אינטרנט?
לא. הוצאת הקישורים הדינמיים ב-Firebase משימוש משפיעה רק על הטיפול בכתובות URL נכנסות במכשירים ניידים.
איך מושפעות הטמעות שמשתמשות בספריות Firebase JS SDK כדי לאמת ספקי OAuth באפליקציית Cordova?
Firebase JS SDK משתמש בקישורים דינמיים ב-Firebase כדי להטמיע תהליכי אימות OAuth באפליקציות Cordova. כדי להשלים את תהליך האימות, תצטרכו לשנות את ההטמעה של התהליך על ידי ביצוע תהליך OAuth באופן ידני והעברת פרטי הכניסה של OAuth שנוצרו אל Firebase.
פרטים נוספים זמינים במדריך של Cordova.
מהן האפשרויות החלופיות לקישורים דינמיים ב-Firebase?
בשאלות הנפוצות בנושא "איך מעבירים נתונים מהשירות" מפורטים תרחישים שונים של העברת נתונים, ויש מדריכים להעברת נתונים לחלופות שונות.