سوالات متداول از بین رفتن پیوندهای پویا

ما پیوندهای دینامیک 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 پیش می‌رود و هر گونه مشکل اضافی را کشف می‌کنیم زیرا به حمایت از شما در تلاش‌های مهاجرت کمک می‌کنیم.

به سوالات متداول زیر مراجعه کنید تا به برخی از مهم ترین سوالات خود پاسخ دهید.

برای شروع مهاجرت، لطفاً به سؤالات متداول "چگونه باید از سرویس مهاجرت کنم" در زیر نگاهی بیندازید.

در 25 آگوست 2025، Firebase Dynamic Links خاموش خواهد شد. همه پیوندهایی که توسط Firebase Dynamic Links ارائه می‌شوند (هم آنهایی که در دامنه‌های سفارشی و هم در زیر دامنه‌های page.link میزبانی می‌شوند) دیگر کار نمی‌کنند.

چقدر زمان برای مهاجرت دارم؟

شما تا 25 آگوست 2025 فرصت دارید تا مهاجرت خود را تکمیل کنید.

بله، پیوندهای جدید و موجود شما تا زمانی که سرویس پیوندهای پویا در 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، احتمالاً یکی از سناریوهای زیر با نیازهای شما مطابقت دارد.

برای این سناریو، توصیه می کنیم از سایر ارائه دهندگان / فروشندگان خدمات پیوند عمیق مانند 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 موجود خود را با پیروی از راهنمای صادر کردن ابرداده پیوند خود مرور کنید تا مطمئن شوید که کاربران و برنامه شما پس از اینکه پیوندها دیگر ارائه نمی شوند تحت تأثیر قرار نخواهند گرفت.

  • حذف پیشوندهای URL Firebase Dynamic Links در کنسول Firebase . توجه: دامنه های پیشوند URL به طور خودکار پس از 25 آگوست 2025 حذف خواهند شد.

  • حذف Firebase Dynamic Links SDK از برنامه‌هایتان.

اگر سناریوی مهاجرتی می بینید که نیازهای شما را پوشش نمی دهد، لطفاً با ما تماس بگیرید

APIهای Firebase Dynamic Links برای Short Links و Analytics تا غروب آفتاب در 25 آگوست 2025 در دسترس خواهند بود.

پس از آن تاریخ، این APIها دیگر برای استفاده در دسترس نخواهند بود و سرویس بسته خواهد شد .

لطفاً برای دستورالعمل‌هایی در مورد نحوه صادرات ابرداده پیوند خود به راهنمای صادرات ابرداده پیوند خود مراجعه کنید.

می‌توانید از راهنمای صادرات برای بازیابی فراداده Firebase Dynamic Links خود که شامل خود پیوند است استفاده کنید.

می توانید از Firebase Dynamic Links Analytics API برای بازیابی داده های آمار پیوند برای هر یک از پیوندهای دینامیک Firebase خود استفاده کنید. این Analytics API به ~5 QPS محدود شده است. برای مثال در مورد نحوه عملکرد در آن محدودیت درخواست هنگام استفاده از API، لطفاً به این نمونه کار ابری مراجعه کنید.

همچنین می‌توانید از Google Analytics استفاده کنید و داده‌های خود را برای زیرمجموعه‌ای از داده‌های تجزیه و تحلیل پیوند، از جمله رویدادهای App Updates که منحصر به Google Analytics هستند، صادر کنید.

اگر برای کمک به مهاجرت خود به نرخ درخواست بالاتری نیاز دارید، لطفاً با پشتیبانی Firebase با ما تماس بگیرید.

فراداده دامنه و پیوند شما برای حذف در 25 آگوست 2025 علامت‌گذاری می‌شود و مطابق با خط‌مشی حفظ داده‌های ما پاکسازی می‌شود.

خیر، نیازی به نصب Firebase Dynamic Links ندارید، زیرا دیگر امکان نصب وجود ندارد. درعوض، می‌توانید از راهنماهای به‌روزرسانی شده برای شروع احراز هویت پیوند ایمیل برای فعال کردن و پیاده‌سازی آن برای پروژه خود پیروی کنید:

فهرست کامل اقداماتی را که تحت تأثیر این تغییر قرار می‌گیرند، ببینید.

احراز هویت پیوند ایمیل و اقدامات ایمیل خارج از باند شما با Firebase به کار خود ادامه خواهند داد، اما برای ادامه استفاده از این اقدامات پس از بسته شدن سرویس Firebase Dynamic Links در 25 آگوست 2025، باید به آخرین SDKهای Firebase Authentication ارتقا دهید و به راه حل جدید مهاجرت کنید.

برای دستورالعمل‌های نحوه تکمیل مهاجرت، می‌توانید از راهنماهای لینک زیر پیروی کنید:

فهرست کاملی از اقداماتی را که تحت تأثیر این امر قرار می گیرند، مشاهده کنید.

پیاده‌سازی جریان OAuth با نسخه‌های Firebase Authentication Android SDK زیر نسخه 20.0.0 یا نسخه‌های BoM زیر 26.0.0 چه تأثیری دارد؟

برای ادامه استفاده از اجرای جریان OAuth در برنامه‌های Android خود، باید به جدیدترین Firebase Authentication Android SDK (حداقل نسخه 20.0.0) به‌روزرسانی کنید.

آیا اقدامات ایمیل Firebase Authentication در برنامه های وب تحت تأثیر قرار می گیرد؟

خیر. منسوخ شدن پیوند دینامیک Firebase فقط بر مدیریت URL های ورودی در دستگاه های تلفن همراه تأثیر می گذارد.

پیاده سازی هایی که از کتابخانه های Firebase JS SDK برای احراز هویت ارائه دهندگان OAuth در برنامه Cordova استفاده می کنند، چگونه تحت تأثیر قرار می گیرند؟

بله، Firebase JS SDK از Firebase Dynamic Links برای اجرای جریان احراز هویت OAuth استفاده می کند. برای تکمیل جریان احراز هویت، باید اجرای جریان خود را با انجام دستی جریان OAuth و ارسال اعتبار OAuth به Firebase تغییر دهید.

برای جزئیات بیشتر به راهنمای کوردووا مراجعه کنید.

لطفاً سؤالات متداول "چگونه باید از سرویس مهاجرت کنم" را ببینید که سناریوهای مختلف مهاجرت را شرح می دهد و راهنماهای مهاجرت را برای گزینه های مختلف موجود ارائه می دهد.