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

השקנו את הקישורים הדינמיים ב-Firebase לפני יותר מ-7 שנים כדי לשפר את היכולות של כתובות 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 כדי להשלים את ההעברה.

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

כשהתמיכה בקישורים הדינמיים ב-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.

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

    iOS

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

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    		 400 שגיאה עם הסיבה לכשל לא*
    שיוך (Attribution) לפתיחה ראשונה

    הקריאה מתבצעת באופן אוטומטי ב-FirebaseApp.configure (Swift) או ב-FIRApp.configure (Objective-C)

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

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

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

    Android

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

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    		 400 שגיאה עם הסיבה לכשל לא*
    שיוך (Attribution) לפתיחה ראשונה

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    		 400 המשימה מחזירה תשובה של הצלחה, אבל נתוני ה-FDL יהיו ריקים לא*
    קבל את ההזמנה מודול AppInvite ב-Google Play Services שנקרא במהלך טיפול בהפניה אוטומטית של כוונה (מ-*.page.link או מדומיין מותאם אישית) 400 מוצגת ספינר כשמפעילים את Google Play Services, והוא נעלם כשמתקבלת תגובה מסוג 400 לא*

איך עוברים מהשירות?

גילינו שלמפתחים שונים יש צרכים שונים כשמדובר בשימוש בקישורים הדינמיים של Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ממשקי ה-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 ימשיכו לפעול, אבל תצטרכו לשדרג לערכות ה-SDK העדכניות ביותר של Firebase Authentication ולעבור לפתרון החדש כדי להמשיך להשתמש בפעולות האלה אחרי שהשירות של Firebase Dynamic Links ייסגר ב-25 באוגוסט 2025.

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

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

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

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

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

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

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

כן, ה-SDK של Firebase JS משתמש ב-Firebase Dynamic Links כדי להטמיע את תהליך האימות של OAuth. כדי להשלים את תהליך האימות, תצטרכו לשנות את ההטמעה של התהליך כך שתבצעו את תהליך OAuth באופן ידני ותעבירו את פרטי הכניסה של OAuth ל-Firebase.

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

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