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

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

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

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

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

חשוב לזכור ש-Firebase Authentication תלוי בשירות הקישורים הדינמיים ב-Firebase רק באופן פנימי, אבל לא תלוי ב-Firebase Dynamic Links SDK.

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

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

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

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