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

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

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

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

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

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

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

מה חשוב לדעת?

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

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

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

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

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

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

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

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

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

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

    Android

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

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 המשימה מחזירה תגובת הצלחה, אבל נתוני FDL יהיו ריקים לא*
    קבל את ההזמנה מודול AppInvite בשירותי Google Play מופעל כשמטפלים בהפניה אוטומטית של 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.

  • הסרת Firebase Dynamic Links SDK מהאפליקציות.

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

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

אחרי השלמת ההעברה מקישורים דינמיים ב-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 Dynamic Links ל קישורים מקוצרים ולניתוח נתונים יישארו זמינים עד לתאריך היציאה משימוש, 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 Authentication Android SDK בגרסאות מתחת לגרסה v20.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.

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