שאלות נפוצות בנושא ההוצאה משימוש של קישורים דינמיים

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

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

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

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

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

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

מה חשוב לדעת?

ב-25 באוגוסט 2025, נסגור את קישורים דינמיים ב-Firebase. כל הקישורים שמוצגים על ידי קישורים דינמיים ב-Firebase (גם אלה שמתארחים בדומיינים מותאמים אישית וגם אלה שמתארחים בתת-דומיינים של page.link) יפסיקו לפעול, ולא תהיה לכם יותר אפשרות ליצור קישורים חדשים.

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

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

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

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

ב-25 באוגוסט 2025, נסגור את קישורים דינמיים ב-Firebase. כל הקישורים שמוצגים על ידי קישורים דינמיים ב-Firebase (גם אלה שמארחים בדומיינים מותאמים אישית וגם אלה שמארחים בתת-דומיינים של page.link) יפסיקו לפעול.

כמה זמן יהיה לי להעביר את החשבון?

עליך להשלים את ההעברה עד 25 באוגוסט 2025.

כן, הקישורים החדשים והקיימים ימשיכו לפעול עד להשבתת שירות Dynamic Links ב-25 באוגוסט 2025.

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

כשקישורים דינמיים ב-Firebase יצאו משימוש, אפשר לצפות לדברים הבאים:

  • כל הקישורים שהמשתמשים ילחצו עליהם יחזירו תשובת סטטוס HTTP 404 למשתמשי הקצה.
  • כל בקשות ה-HTTP אל:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (Link Stats API)

    תחזיר תגובה עם סטטוס HTTP 400 או 403.

  • החל מ-25 באוגוסט 2025, שיעור התשובות עם השגיאות שצוינו למעלה יגדל בהדרגה, עד שבתום תקופת ההוצאה משימוש, שיעור התשובות עם השגיאות יגיע ל-100%.

  • ההתנהגות הבאה תלויה בגרסת פלטפורמת ה-SDK ובקריאה ל-API שבוצעה באפליקציה:

    iOS

    תרחיש שימוש קריאה ל-API קוד סטטוס התנהגות האם האפליקציה תקרוס?
    יצירת קישור קצר

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    403 השגיאה מופיעה עם הסיבה לכשל לא*
    ייחוס של פתיחה ראשונה

    הפונקציה הזו מופעלת אוטומטית ב-FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 לא מופיעות שגיאות, אבל אובייקט FDL נשלח בחזרה עם נתונים ריקים לא*
    פתיחה מחדש של שיוך (Attribution)

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 השגיאה מופיעה עם הסיבה לכשל לא*

    Android

    תרחיש שימוש קריאה ל-API קוד סטטוס התנהגות האם האפליקציה תקרוס?
    יצירת קישור קצר

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    403 השגיאה מופיעה עם הסיבה לכשל לא*
    ייחוס של פתיחה ראשונה

    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, סביר שאחד מהתרחישים הבאים יתאים לצרכים שלכם.

במקרה כזה, מומלץ להשתמש בספקי שירותים או ספקים אחרים של קישורים עמוקים, כמו Adjust,‏ Airbridge,‏ AppsFlyer,‏ Bitly,‏ Branch,‏ Kochava,‏ Singular וספקים דומים אחרים בשוק. (הערה: Google לא בדקה את הספקים האלה, אבל הם מספקים פונקציונליות דומה לקישורים דינמיים ב-Firebase).

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

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

תכונות של קישורים דינמיים ב-Firebase:

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

מה קורה אם חשוב לי רק קישור עומק לאפליקציה אחרי שהיא כבר הותקנה?

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

במדריך הזה מפורטות הוראות להעברה לשימוש בקישורי עומק לאפליקציה ובקישורים אוניברסליים.

במדריך הזה מוסבר גם איך להשתמש ב-אירוח ב-Firebase כדי לארח את הקבצים הדרושים לאימות הדומיין וה-Asset Link בדומיין שבו אתם מתכננים להשתמש לקישורים החדשים (למשל, הקובץ assetlinks.json לקישורי אפליקציה, הקובץ apple-app-site-association לקישורים אוניברסליים).

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

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

  • מחיקת קידומות ה-URL של הקישורים הדינמיים ב-Firebase ב מסוף Firebase. הערה: דומיינים עם קידומת URL יימחקו באופן אוטומטי אחרי 25 באוגוסט 2025.

  • הסרת SDK להטמעת קישורים דינמיים ב-Firebase מהאפליקציות.

אם אתם רואים תרחיש העברה שלא מתאים לצרכים שלכם, אתם מוזמנים ליצור איתנו קשר.

מה צריך לעשות אחרי השלמת ההעברה?

אחרי השלמת ההעברה מקישורים דינמיים ב-Firebase, חשוב למחוק את כל התחיליות של דומיינים של כתובות URL (דומיינים של FDL) שמשויכות לקישורים הדינמיים הקודמים ב-Firebase בפרויקט.

כדי לעשות את זה:

  1. איך עוברים לקטע 'קישורים דינמיים ב-Firebase' במסוף Firebase
  2. בוחרים את התחילית של כתובת ה-URL שרוצים למחוק מהבורר שבצד ימין. צילום מסך של מסוף FDL עם בורר של תחילית נתיב כתובת ה-URL

  3. לוחצים על סמל האפשרויות הנוספות (3 נקודות) לצד הלחצן 'קישור דינמי חדש'. צילום מסך של מסוף FDL עם אפשרויות של קידומת נתיב כתובת ה-URL

  4. בחירה באפשרות 'מחיקת התחילית של כתובת ה-URL'

  5. מזינים את קידומת כתובת ה-URL כדי לאשר שרוצים למחוק אותה, ולוחצים על 'מחיקת קידומת כתובת ה-URL'.

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

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

ממשקי ה-API של קישורים דינמיים ב-Firebase ל קישורים מקוצרים ולAnalytics יישארו זמינים עד לתאריך היציאה משימוש, 25 באוגוסט 2025.

אחרי התאריך הזה, לא תהיה יותר אפשרות להשתמש בממשקי ה-API האלה, והשירות יושבת.

הוראות לייצוא המטא-נתונים של הקישורים מופיעות במדריך לייצוא המטא-נתונים של הקישורים.

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

אתם יכולים להשתמש ב-Firebase Dynamic Links Analytics API כדי לאחזר נתונים סטטיסטיים של קישורים לכל אחד מהקישורים הדינמיים ב-Firebase. ממשק ה-API הזה של Analytics מוגבל ל-5 שאילתות לשנייה (QPS). כדי לראות דוגמה לאופן הפעולה במסגרת מגבלת הבקשות הזו כשמשתמשים ב-API, אפשר לעיין בדוגמה הזו של Cloud Task.

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

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

הדומיין והמטא-נתונים של הקישור יסומנו למחיקה ב-25 באוגוסט 2025, ויימחקו בהתאם למדיניות שלנו בנושא שמירת נתונים.

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

כאן אפשר לראות את הרשימה המלאה של הפעולות שיושפעו מהשינוי הזה.

אימות באמצעות קישור באימייל ופעולות באימייל מחוץ לפס עם Firebase ימשיכו לפעול, אבל תצטרכו לשדרג לגרסאות האחרונות של Firebase Authentication ה-SDK ולעבור לפתרון החדש כדי להמשיך להשתמש בפעולות האלה אחרי ששירות Firebase Dynamic Links ייסגר ב-25 באוגוסט 2025.

כדי להשלים את ההעברה, פועלים לפי ההוראות במדריכים שמפורטים בקישורים הבאים:

כאן אפשר לעיין ברשימה המלאה של הפעולות שיושפעו מהשינוי הזה.

איך מושפעות הטמעות של תהליך OAuth עם אימות ב-Firebase Android SDK בגרסאות מתחת לגרסה v20.0.0 או גרסאות BoM מתחת לגרסה 26.0.0?

כדי להמשיך להשתמש בהטמעה של תהליך OAuth באפליקציות ל-Android, צריך לעדכן לגרסה העדכנית ביותר של Android SDK של אימות ב-Firebase (לפחות גרסה 20.0.0).

האם פעולות אימייל של אימות ב-Firebase מושפעות באפליקציות אינטרנט?

לא. הוצאת הקישורים הדינמיים ב-Firebase משימוש משפיעה רק על הטיפול בכתובות URL נכנסות במכשירים ניידים.

איך מושפעים יישומים שמשתמשים בספריות Firebase JS SDK כדי לאמת ספקי OAuth באפליקציית Cordova?

‫Firebase JS SDK משתמש בקישורים דינמיים ב-Firebase כדי להטמיע תהליכי אימות של OAuth באפליקציות Cordova. תצטרכו לשנות את ההטמעה של התהליך על ידי ביצוע תהליך OAuth באופן ידני והעברת אישורי ה-OAuth שמתקבלים אל Firebase כדי להשלים את תהליך האימות.

פרטים נוספים זמינים במדריך ל-Cordova.

ב שאלות הנפוצות בנושא 'איך מעבירים נתונים מהשירות' מפורטים תרחישי העברה שונים ומדריכים להעברת נתונים עבור חלופות שונות.