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

ما پیوندهای دینامیک 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 Authentication به کار خود ادامه خواهد داد.

Firebase Authentication در حال حاضر از Firebase Dynamic Links برای سفارشی کردن پیوندهای Authentication استفاده می‌کند، اما ما به‌روزرسانی‌ای ارائه می‌کنیم که به یک به‌روزرسانی در سمت سرویس گیرنده نیاز دارد تا اطمینان حاصل شود که تأیید اعتبار پیوند ایمیل پس از بسته شدن سرویس Firebase Dynamic Links همچنان به کار خود ادامه می‌دهد.

توجه داشته باشید که احراز هویت Firebase فقط به سرویس Firebase Dynamic Links به صورت داخلی بستگی دارد، اما به Firebase Dynamic Links SDK بستگی ندارد.

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

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

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

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