ما پیوندهای دینامیک Firebase را بیش از 7 سال پیش راه اندازی کردیم تا URL ها را قدرتمندتر کنیم - به عنوان مثال، تغییر پویا مقصد پیوند بر اساس شرایط زمان اجرا.
در طول سالها، اکوسیستمهای وب و موبایل با فناوریهایی مانند App Links ، Google Play Instant ، Universal Links ، و App Clips تکامل یافتهاند و سفرهای کاربر را در بین برنامهها و وب برای کاربران برنامهتان یکپارچهتر و قابل پیشبینیتر کردهاند. ما معتقدیم که شما و کاربرانتان از پذیرش مستقیم این فناوریها و ادامه حرکت اکوسیستم به جلو سود بیشتری خواهید برد. با این حال، در کنار این تغییرات جدید، API های بومی اصلی که Firebase Dynamic Links بر روی آنها ساخته شده بودند نیز تکامل یافته و چالش های جدیدی را ارائه کردند.
به عنوان مثال، تغییرات اکوسیستم بر توانایی ما برای ارائه یک تجربه ثابت پایدار برای یکی از ویژگیهای اصلی Firebase Dynamic Links تأثیر گذاشت - به کاربران برنامه بدون در نظر گرفتن پلتفرم، انتقال نرمی به برنامه پس از نصب پس از نصب ایجاد کرد.
بهجای ادامه پشتیبانی از تجربهای نه چندان ایدهآل، تصمیم گرفتهایم لینکهای دینامیک Firebase را غروب کنیم و منابع خود را دوباره بر حل سایر نقاط درد توسعهدهنده متمرکز کنیم.
ما درک می کنیم که این تغییر به زمان شما برای ارزیابی و اتخاذ راه حل های جایگزین یا ارائه دهندگان پلت فرم در بازار نیاز دارد.
ما همچنان به تکامل Firebase ادامه می دهیم تا نیازهای شما را برآورده کنیم زیرا اکوسیستم همچنان در حال تکامل و تغییر است. ما به راهاندازی ویژگیها و بهروزرسانیهای جدید در محصولات Firebase ادامه میدهیم و متعهد هستیم که به شما کمک کنیم در سفرهای توسعه برنامهتان برتر باشید.
چه چیزی باید بدانم؟
در 25 آگوست 2025، Firebase Dynamic Links خاموش خواهد شد. همه پیوندهای ارائه شده توسط Firebase Dynamic Links (هم در دامنه های سفارشی و هم در زیر دامنه های page.link میزبانی می شوند) از کار می افتند و دیگر نمی توانید پیوندهای جدیدی ایجاد کنید.
برای کمک به تصمیم گیری در مورد نحوه مهاجرت از Firebase Dynamic Links، ما همچنان به به روز رسانی این سند سؤالات متداول همراه با اطلاعات اضافی که باید در نظر بگیرید، و همچنین راهنماهای انتقال را برای سناریوهای مختلف مهاجرت ارائه می کنیم که ممکن است با روشی که امروزه از Firebase Dynamic Links استفاده می کنید مطابقت داشته باشد.
ما همچنین به بهروزرسانی این راهنما با سؤالات متداول بیشتر ادامه میدهیم، زیرا منسوخ شدن به سمت تاریخ غروب آفتاب در 25 آگوست 2025 پیش میرود و هر گونه مشکل اضافی را کشف میکنیم زیرا به حمایت از شما در تلاشهای مهاجرت کمک میکنیم.
به سوالات متداول زیر مراجعه کنید تا به برخی از مهم ترین سوالات خود پاسخ دهید.
برای شروع مهاجرت، لطفاً به سؤالات متداول "چگونه باید از سرویس مهاجرت کنم" در زیر نگاهی بیندازید.
Firebase Dynamic Links چه زمانی از کار می افتد؟
در 25 آگوست 2025، Firebase Dynamic Links خاموش خواهد شد. همه پیوندهایی که توسط Firebase Dynamic Links ارائه میشوند (هم آنهایی که در دامنههای سفارشی و هم در زیر دامنههای page.link میزبانی میشوند) دیگر کار نمیکنند.
چقدر زمان برای مهاجرت دارم؟
شما تا 25 آگوست 2025 فرصت دارید تا مهاجرت خود را تکمیل کنید.
آیا پیوندهای جدید و موجود به کار خود ادامه خواهند داد؟
بله، پیوندهای جدید و موجود شما تا زمانی که سرویس پیوندهای پویا در 25 آگوست 2025 بسته نشود، به کار خود ادامه خواهند داد.
وقتی Firebase Dynamic Links غروب میکند (در 25 آگوست 2025) برای پیوندها و در برنامه(های) من چه اتفاقی میافتد؟
هنگامی که Firebase Dynamic Links غروب می کند، می توانید انتظار داشته باشید که:
- همه پیوندهایی که کلیک میشوند، پاسخ وضعیت HTTP 404 را به کاربران نهایی برمیگردانند.
تمام درخواست های HTTP به:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (API پیوندهای کوتاه)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (API آمار پیوند)
پاسخ وضعیت HTTP 400/403 را برمیگرداند.
رفتار زیر بر اساس نسخه پلتفرم SDK و تماس API در برنامه شما انجام شده است:
iOS
مورد استفاده تماس API کد وضعیت رفتار آیا برنامه شما خراب می شود؟ لینک کوتاه ایجاد کنید کوتاه کردن (سوئیفت)
shortenUrl (Swift)
shortenWithCompletion (هدف-C)
400 خطا با دلیل شکست صادر می شود نه* اولین منبع باز به طور خودکار در FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C) فراخوانی می شود
400 هیچ خطایی منتشر نمی شود، اما یک شی FDL با داده های خالی بازگردانده می شود نه* دوباره باز کردن Attribution handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 خطا با دلیل شکست صادر می شود نه* اندروید
مورد استفاده تماس API کد وضعیت رفتار آیا برنامه شما خراب می شود؟ لینک کوتاه ایجاد کنید buildShortDynamicLink (Kotlin)
buildShortDynamicLink (جاوا)
400 خطا با دلیل شکست صادر می شود نه* اولین منبع باز getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (جاوا)
400 Task یک پاسخ موفقیت آمیز برمی گرداند، اما داده های FDL خالی خواهند بود نه* دوباره باز کردن Attribution getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (جاوا)
400 Task یک پاسخ موفقیت آمیز برمی گرداند، اما داده های FDL خالی خواهند بود نه* پذیرش دعوت نامه ماژول AppInvite در سرویسهای Google Play هنگام مدیریت تغییر مسیر (از *.page.link یا دامنه سفارشی) فراخوانی میشود. 400 هنگامی که سرویسهای Google Play فراخوانی میشود، اسپینر را نشان میدهد و با بازگشت پاسخ 400 ناپدید میشود. نه*
چگونه باید از سرویس مهاجرت کنم؟
ما متوجه شدیم که توسعه دهندگان مختلف در مورد استفاده از Firebase Dynamic Links نیازهای متفاوتی دارند.
بسته به موارد استفاده خودتان و ارزیابی استفاده از Firebase Dynamic Links، احتمالاً یکی از سناریوهای زیر با نیازهای شما مطابقت دارد.
در صورت نیاز به برابری کامل ویژگی ها با Firebase Dynamic Links چه باید بکنم؟
برای این سناریو، توصیه می کنیم از سایر ارائه دهندگان / فروشندگان خدمات پیوند عمیق مانند Adjust، Airbridge، AppsFlyer، Bitly، Branch، Kochava و سایر ارائه دهندگان مشابه در بازار استفاده کنید. (توجه داشته باشید، این ارائه دهندگان توسط Google بررسی نشده اند، اما عملکردی مشابه با Firebase Dynamic Links ارائه می دهند).
همچنین میتوانید ابرداده پیوند عمیق خود را صادر کنید ، که میتواند انتقال پیوندهای خود را به هر ارائهدهندهای که انتخاب میکنید آسانتر کند.
برای کمک به یافتن ارائهدهندهای با ویژگیهای منطبق با Firebase Dynamic Links، به فهرست ویژگیهای زیر در زیر مراجعه کنید.
ویژگی های Firebase Dynamic Links:
- کاربران را با یک کلیک به فروشگاه صحیح دستگاه خود هدایت می کند (و در صورت نیاز به صفحه وب بازمی گردد)
- ادامه سفر را پس از دانلود و نصب برنامه به کاربران ارائه می دهد تا یک پیوند عمیق به تعویق افتاده را مشاهده کنند
- از طریق محتوای پیوند عمیق در برنامه شما (زمانی که قبلاً نصب شده باشد) یک تجربه متنی را در اختیار کاربران قرار می دهد.
- داده های تحلیلی مربوط به رویدادهای کلیک پیوند پویا را ارائه می دهد
- امکان ایجاد URL های لینک کوتاه را فراهم می کند
- امکان افزودن ابرداده به پیوندها برای اشتراک گذاری اجتماعی را فراهم می کند
اگر فقط پس از نصب برنامه خود به پیوند عمیق به آن اهمیت بدهم، چه؟
برای این سناریو، توصیه میکنیم از App Links و Universal Links استفاده کنید که راههایی با پشتیبانی پلتفرم برای توسعهدهندگان هستند تا تجربیات پیوند عمیق را برای کاربران خود فراهم کنند.
برای جزئیات بیشتر در مورد نحوه انتقال به پیوندهای برنامه و پیوندهای جهانی، این راهنما را بررسی کنید.
این راهنما همچنین نحوه استفاده اختیاری از میزبانی Firebase را برای میزبانی فایلهای تأیید دامنه لازم و پیوند دارایی در دامنهای که قصد دارید برای پیوندهای جدید خود استفاده کنید (مثلاً فایل assetlinks.json برای پیوندهای برنامه، فایل apple-app-site-association برای پیوندهای جهانی).
اگر برنامه من دیگر به ویژگی های Firebase Dynamic Links نیاز نداشته باشد و نیازی به جایگزینی برای آن نداشته باشد، چه؟
برای این سناریو، ممکن است نیازی به انجام هیچ اقدامی در برنامه خود برای مدیریت غروب آینده نداشته باشید، با این حال توصیه می کنیم:
پیوندهای دینامیک Firebase موجود خود را با پیروی از راهنمای صادر کردن ابرداده پیوند خود مرور کنید تا مطمئن شوید که کاربران و برنامه شما پس از اینکه پیوندها دیگر ارائه نمی شوند تحت تأثیر قرار نخواهند گرفت.
حذف پیشوندهای URL Firebase Dynamic Links در کنسول Firebase . توجه: دامنه های پیشوند URL به طور خودکار پس از 25 آگوست 2025 حذف خواهند شد.
حذف Firebase Dynamic Links SDK از برنامههایتان.
اگر سناریوی مهاجرتی میبینید که نیازهای شما را پوشش نمیدهد، لطفاً با ما تماس بگیرید
آیا همچنان میتوانم از APIهای Firebase Dynamic Links استفاده کنم؟
APIهای Firebase Dynamic Links برای Short Links و Analytics تا غروب آفتاب در 25 آگوست 2025 در دسترس خواهند بود.
پس از آن تاریخ، این APIها دیگر برای استفاده در دسترس نخواهند بود و سرویس بسته خواهد شد .
چگونه می توانم ابرداده پیوند خود را صادر کنم؟
لطفاً برای دستورالعملهایی در مورد نحوه صادرات ابرداده پیوند خود به راهنمای صادرات ابرداده پیوند خود مراجعه کنید.
چگونه می توانم داده های تجزیه و تحلیل پیوندهای Firebase Dynamic Links خود را دریافت کنم؟
میتوانید از راهنمای صادرات برای بازیابی فراداده Firebase Dynamic Links خود که شامل خود پیوند است استفاده کنید.
می توانید از Firebase Dynamic Links Analytics API برای بازیابی داده های آمار پیوند برای هر یک از پیوندهای دینامیک Firebase خود استفاده کنید. این Analytics API به ~5 QPS محدود شده است. برای مثالی در مورد نحوه عملکرد در آن محدودیت درخواست هنگام استفاده از API، لطفاً به این نمونه کار ابری مراجعه کنید.
همچنین میتوانید از Google Analytics استفاده کنید و دادههای خود را برای زیرمجموعهای از دادههای تجزیه و تحلیل پیوند، از جمله رویدادهای App Updates که منحصر به Google Analytics هستند، صادر کنید.
اگر برای کمک به مهاجرت خود به نرخ درخواست بالاتری نیاز دارید، لطفاً با پشتیبانی Firebase با ما تماس بگیرید.
پس از غروب آفتاب (25 اوت 2025) چه اتفاقی برای ابرداده پیوندهای موجود خواهد افتاد؟
فراداده دامنه و پیوند شما برای حذف در 25 آگوست 2025 علامتگذاری میشود و مطابق با خطمشی حفظ دادههای ما پاکسازی میشود.
من در حال حاضر از پیوندهای پویا برای احراز هویت پیوند ایمیل در Firebase Authentication استفاده می کنم یا باید از آن استفاده کنم. آیا این ویژگی پس از غروب آفتاب به کار خود ادامه می دهد؟
بله، احراز هویت پیوند ایمیل شما با استفاده از Firebase Authentication به کار خود ادامه خواهد داد.
Firebase Authentication در حال حاضر از Firebase Dynamic Links برای سفارشی کردن پیوندهای Authentication استفاده میکند، اما ما بهروزرسانیای ارائه میکنیم که به یک بهروزرسانی در سمت سرویس گیرنده نیاز دارد تا اطمینان حاصل شود که تأیید اعتبار پیوند ایمیل پس از بسته شدن سرویس Firebase Dynamic Links همچنان به کار خود ادامه میدهد.
توجه داشته باشید که احراز هویت Firebase فقط به سرویس Firebase Dynamic Links به صورت داخلی بستگی دارد، اما به Firebase Dynamic Links SDK بستگی ندارد.
برای فعال کردن تأیید اعتبار پیوند ایمیل در Firebase Authentication باید وارد Firebase Dynamic Links شوم. چه کار کنم؟
اگر پروژه Firebase شما از تاریخ اعلام غروب آفتاب در 25 آگوست 2023 FDL را فعال نکرده باشد، در حال حاضر نمیتوانید به تازگی وارد Firebase Dynamic Links شوید.
اگر برای فعال کردن احراز هویت پیوند ایمیل نیاز به فعال کردن Firebase Dynamic Links دارید، لطفاً با پشتیبانی Firebase تماس بگیرید و ما برای کمک به پیکربندی شما با شما تماس خواهیم گرفت.
توجه داشته باشید که این ادامه عملکرد جدا از استفاده از Firebase Dynamic Links برای موارد استفاده اولیه فروشگاه و مسیریابی وب، به تعویق افتاده و پیوند عمیق معمولی است که طبق جدول زمانی مهاجرت به اشتراک گذاشته شده در بالا منسوخ خواهد شد.
چند گزینه جایگزین برای Firebase Dynamic Links چیست؟
لطفاً سؤالات متداول "چگونه باید از سرویس مهاجرت کنم" را ببینید که سناریوهای مختلف مهاجرت را شرح می دهد و راهنماهای مهاجرت را برای گزینه های مختلف موجود ارائه می دهد.