أطلقنا "روابط Firebase الديناميكية" قبل أكثر من 7 سنوات لتعزيز فعالية عناوين URL، على سبيل المثال، من خلال تغيير وجهة الرابط ديناميكيًا استنادًا إلى شروط وقت التشغيل.
على مرّ السنين، تطوّرت منظومات الويب والأجهزة الجوّالة المتكاملة باستخدام تكنولوجيات مثل روابط التطبيقات وتطبيقات Google Play الفورية والروابط العامة ومقتطفات التطبيقات، ما جعل تجارب المستخدمين على مستوى التطبيقات والويب أكثر سلاسة وقابلية للتوقّع لمستخدمي تطبيقك. نعتقد أنّك أنت والمستخدمين ستستفيدون أكثر من اعتماد هذه التكنولوجيات مباشرةً ومواصلة تطوير المنظومة المتكاملة للأمام. ومع ذلك، إلى جانب هذه التغييرات الجديدة، تطوّرت أيضًا واجهات برمجة التطبيقات الأصلية التي تم إنشاء "روابط Firebase الديناميكية" عليها، ما أدى إلى ظهور تحديات جديدة.
على سبيل المثال، أثّرت التغييرات في المنظومة المتكاملة على قدرتنا على توفير تجربة مستقرة باستمرار لإحدى الميزات الأساسية في روابط Firebase الديناميكية، وهي منح مستخدمي التطبيق انتقالاً سلسًا إلى التطبيق بعد التثبيت، بغض النظر عن المنصة.
بدلاً من مواصلة تقديم تجربة غير مثالية، قرّرنا إيقاف "روابط Firebase الديناميكية" نهائيًا وإعادة تركيز مواردنا على حلّ المشاكل الأخرى التي يواجهها المطوّرون.
ندرك أنّ هذا التغيير سيتطلّب منك تخصيص بعض الوقت لتقييم واعتماد حلول بديلة أو مقدّمي خدمات آخرين في السوق.
نواصل تطوير Firebase لتلبية احتياجاتك مع استمرار تطوّر المنظومة المتكاملة وتغيّرها. سنواصل إطلاق ميزات وتحديثات جديدة في جميع منتجات Firebase، ونحن ملتزمون بمساعدتك في تحقيق التميّز في مسيرتك لتطوير التطبيقات.
ما هي المعلومات التي يجب معرفتها؟
في 25 أغسطس 2025، سيتم إيقاف خدمة "روابط Firebase الديناميكية". ستتوقف جميع الروابط التي يتم عرضها من خلال "روابط Firebase الديناميكية" (سواء كانت مستضافة على نطاقات خاصة أو نطاقات فرعية على page.link) عن العمل ولن يكون بإمكانك إنشاء روابط جديدة.
لمساعدتك في تحديد كيفية نقل البيانات من "روابط Firebase الديناميكية"، سنواصل تعديل مستند الأسئلة الشائعة هذا بمعلومات إضافية يجب أخذها في الاعتبار، بالإضافة إلى تقديم أدلة نقل البيانات لسيناريوهات نقل البيانات المختلفة التي قد تتطابق مع طريقة استخدامك لـ "روابط Firebase الديناميكية" اليوم.
سنواصل أيضًا تعديل هذا الدليل بإضافة المزيد من الأسئلة الشائعة مع اقتراب موعد الإيقاف النهائي في 25 أغسطس 2025، وسنضيف أي مشاكل أخرى نكتشفها أثناء مساعدتك في جهود نقل البيانات.
يمكنك الاطّلاع على الأسئلة الشائعة أدناه للحصول على إجابات عن بعض أهم أسئلتك.
لبدء عملية نقل البيانات، يُرجى الاطّلاع على الأسئلة الشائعة حول كيفية نقل البيانات من الخدمة أدناه.
متى ستتوقف "روابط Firebase الديناميكية" عن العمل؟
في 25 أغسطس 2025، سيتم إيقاف خدمة "روابط Firebase الديناميكية". ستتوقف جميع الروابط التي يتم عرضها من خلال "روابط Firebase الديناميكية" (سواء تلك المستضافة على نطاقات خاصة أو على نطاقات فرعية من page.link).
ما هي المدة المتاحة لي لإجراء عملية نقل البيانات؟
لديك مهلة حتى 25 أغسطس 2025 لإكمال عملية النقل.
هل ستبقى الروابط الجديدة والحالية صالحة؟
نعم، ستظل الروابط الجديدة والحالية تعمل إلى أن يتم إيقاف خدمة الروابط الديناميكية في 25 أغسطس 2025.
هل سأتمكّن من الاحتفاظ بنطاقات .page.link التي تم توفيرها تلقائيًا والمستخدَمة للروابط أو نقلها؟
لا، بعد إيقاف خدمة "روابط Firebase الديناميكية"، لن تكون أي نطاقات .page.link متاحة. ننصحك بالاطّلاع على قائمة الأسئلة هذه لتقييم أفضل طريقة لنقل البيانات من الخدمة، وإذا كنت بحاجة إلى تكافؤ كامل في الميزات، يمكنك اتّباع هذه الإرشادات بشأن تصدير البيانات الوصفية ونقل البيانات إلى مقدّم خدمة آخر للربط العميق باستخدام نطاق جديد.
ماذا سيحدث للروابط وفي تطبيقاتي عند إيقاف خدمة "روابط Firebase الديناميكية" نهائيًا (في 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.
ستبدأ ردود الخطأ أعلاه تدريجيًا في 25 أغسطس 2025 إلى أن تصل في النهاية إلى معدّل %100 بعد مرور تاريخ الإيقاف النهائي.
السلوك التالي استنادًا إلى إصدار نظام SDK الأساسي وطلب بيانات من واجهة برمجة التطبيقات في تطبيقك:
iOS
حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟ إنشاء رابط قصير shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 يتم عرض رسالة خطأ مع سبب تعذُّر التنفيذ لا* تحديد مصدر first_open يتم استدعاؤها تلقائيًا في FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)
400 لا يتم عرض أي أخطاء، ولكن يتم إرسال عنصر FDL مع بيانات فارغة لا* إعادة فتح Attribution handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 يتم عرض رسالة خطأ مع سبب تعذُّر التنفيذ لا* Android
حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟ إنشاء رابط قصير buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
403 يتم عرض رسالة خطأ مع سبب تعذُّر التنفيذ لا* تحديد مصدر first_open getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 تعرض المهمة استجابة ناجحة، ولكن بيانات FDL ستكون فارغة لا* إعادة فتح Attribution getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 تعرض المهمة استجابة ناجحة، ولكن بيانات FDL ستكون فارغة لا* قبول الدعوة يتم استدعاء وحدة AppInvite في "خدمات Google Play" عند معالجة إعادة توجيه الطلب (من *.page.link أو نطاق خاص) 400 يعرض هذا الخيار مؤشر تحميل عند استدعاء "خدمات Google Play" ويختفي عند عرض استجابة 400 لا*
كيف يمكنني نقل البيانات من الخدمة؟
لقد وجدنا أنّ المطوّرين لديهم احتياجات مختلفة عندما يتعلّق الأمر باستخدام "روابط Firebase الديناميكية".
استنادًا إلى حالات الاستخدام وتقييمك لاستخدام "روابط Firebase الديناميكية"، من المرجّح أن يتطابق أحد السيناريوهات أدناه مع احتياجاتك.
ماذا أفعل إذا كنتُ بحاجة إلى ميزات مماثلة بالكامل لميزات "روابط Firebase الديناميكية"؟
في هذه الحالة، ننصحك باستخدام مقدّمي خدمات أو بائعين آخرين للربط بصفحة معيّنة، مثل Adjust وAirbridge وAppsFlyer وBitly وBranch وKochava وSingular وغيرهم من مقدّمي الخدمات المماثلين في السوق. (يُرجى العِلم أنّ Google لم تتحقّق من هؤلاء المزوّدين، ولكنّهم يوفّرون وظائف مشابهة لوظائف "روابط Firebase الديناميكية").
يمكنك أيضًا تصدير البيانات الوصفية للروابط لصفحات معيّنة، ما يسهّل نقل الروابط إلى أي مقدّم خدمة تختاره.
للعثور على مقدّم خدمة يوفّر ميزات مطابقة لميزات "روابط Firebase الديناميكية"، يُرجى الرجوع إلى قائمة الميزات أدناه.
ميزات "روابط Firebase الديناميكية":
- توجيه المستخدمين إلى المتجر المناسب لأجهزتهم بنقرة واحدة (والرجوع إلى صفحة ويب إذا لزم الأمر)
- توفير تجربة متواصلة للمستخدمين بعد تنزيل تطبيقك وتثبيته من خلال رابط عميق مؤجَّل
- توفير تجربة سياقية للمستخدمين من خلال المحتوى المرتبط برابط لصفحة في تطبيقك (عندما يكون مثبّتًا)
- توفير بيانات إحصاءات ذات صلة بالأحداث الناتجة عن النقر على الروابط الديناميكية
- تتيح إمكانية إنشاء عناوين URL قصيرة
- توفّر إمكانية إضافة بيانات وصفية إلى الروابط لمشاركتها على شبكات التواصل الاجتماعي
ماذا لو كنت مهتمًا فقط بالربط العميق بتطبيقي بعد تثبيته؟
في هذا السيناريو، ننصح باستخدام روابط التطبيقات والروابط العامة، وهي طرق تتيحها المنصات للمطوّرين من أجل توفير تجارب الربط لصفحات معيّنة للمستخدمين.
يوضّح هذا الدليل أيضًا كيفية استخدام ميزة "استضافة Firebase" اختياريًا لاستضافة ملفات التحقّق من النطاق وروابط مواد العرض اللازمة على النطاق الذي تخطّط لاستخدامه لروابطك الجديدة (مثل ملف assetlinks.json لروابط التطبيقات، وملف apple-app-site-association للروابط العامة).
ماذا لو لم يعُد تطبيقي بحاجة إلى ميزات من "روابط Firebase الديناميكية" ولا يحتاج إلى بديل لها؟
في هذا السيناريو، قد لا تحتاج إلى اتّخاذ أي إجراء في تطبيقك للتعامل مع عملية الإيقاف النهائي القادمة، ولكننا ننصحك بما يلي:
مراجعة روابط Firebase الديناميكية الحالية باتّباع دليل تصدير البيانات الوصفية للروابط لضمان عدم تأثّر المستخدمين والتطبيق بعد توقُّف عرض الروابط
حذف بادئات عناوين URL لروابط Firebase الديناميكية في وحدة تحكّم Firebase ملاحظة: سيتم حذف النطاقات التي تستخدم بادئة عنوان URL تلقائيًا بعد 25 أغسطس 2025.
إزالة حزمة تطوير البرامج (SDK) لخدمة "روابط Firebase الديناميكية" من تطبيقاتك
إذا لم تكن سيناريوهات نقل البيانات الموضّحة تلبي احتياجاتك، يُرجى التواصل معنا لإعلامنا بذلك.
ماذا عليّ أن أفعل بعد إكمال عملية نقل البيانات؟
بعد الانتهاء من نقل البيانات من "روابط Firebase الديناميكية"، تأكَّد من حذف جميع بادئات نطاقات عناوين URL (نطاقات FDL) المرتبطة بروابط Firebase الديناميكية السابقة في مشروعك.
ويمكنك إجراء ذلك من خلال:
- الانتقال إلى قسم "روابط Firebase الديناميكية" في وحدة تحكُّم Firebase
اختيار بادئة عنوان URL المطلوب حذفها من أداة الاختيار على يمين الصفحة
النقر على قائمة الخيارات الإضافية بجانب الزر "رابط ديناميكي جديد"
اختيار "حذف بادئة عنوان URL"
إدخال بادئة عنوان URL لتأكيد رغبتك في حذفها، والنقر على "حذف بادئة عنوان URL"
بعد الانتهاء من حذف جميع بادئات نطاقات عناوين URL، سيتم وضع علامة على مشروعك على Firebase بأنّه أكمل عملية نقل البيانات من "روابط Firebase الديناميكية". سيؤدي هذا الإجراء أيضًا إلى إزالة التذكير المنبثق الذي قد يكون ظهر لك في وحدة تحكّم Firebase لمشروعك.
يُرجى العِلم أنّ هذا الإجراء سيؤدي إلى حذف جميع "روابط Firebase الديناميكية" بعد اكتماله، لذا يُرجى التأكّد من نقل البيانات بالكامل من الخدمة قبل حذف بادئات نطاقات عناوين URL.
هل سيظلّ بإمكاني استخدام واجهات برمجة التطبيقات لخدمة "روابط Firebase الديناميكية"؟
ستبقى واجهات برمجة التطبيقات لخدمة "روابط Firebase الديناميكية" الخاصة بالروابط القصيرة وإحصاءات Google متاحة حتى تاريخ الإيقاف النهائي في 25 أغسطس 2025.
وبعد هذا التاريخ، لن تكون واجهات برمجة التطبيقات هذه متاحة للاستخدام، وسيتم إيقاف الخدمة.
كيف يمكنني تصدير البيانات الوصفية للروابط؟
يُرجى الرجوع إلى دليل تصدير البيانات الوصفية للروابط للحصول على تعليمات حول كيفية تصدير البيانات الوصفية للروابط.
كيف يمكنني الحصول على بيانات إحصاءات الروابط في "روابط Firebase الديناميكية"؟
يمكنك استخدام دليل التصدير لاسترداد البيانات الوصفية لروابط Firebase الديناميكية، والتي تتضمّن الرابط نفسه.
يمكنك استخدام واجهة برمجة التطبيقات Firebase Dynamic Links Analytics API لاسترداد بيانات إحصاءات الروابط لكلّ من روابط Firebase الديناميكية. يقتصر استخدام واجهة Analytics API هذه على 5 طلبات في الثانية تقريبًا. للاطّلاع على مثال حول كيفية العمل ضمن هذا الحدّ الأقصى للطلبات عند استخدام واجهة برمجة التطبيقات، يُرجى الرجوع إلى نموذج Cloud Task هذا.
يمكنك أيضًا استخدام إحصاءات Google وتصدير بياناتك لمجموعة فرعية من بيانات إحصاءات الروابط، بما في ذلك أحداث "تحديثات التطبيق" الفريدة في "إحصاءات Google".
إذا كنت بحاجة إلى معدّل طلبات أعلى للمساعدة في عملية نقل البيانات، يُرجى التواصل معنا من خلال فريق دعم Firebase.
ماذا سيحدث للبيانات الوصفية للروابط الحالية بعد تاريخ الإيقاف النهائي (25 أغسطس 2025)؟
سيتم وضع علامة على نطاقك والبيانات الوصفية للروابط لحذفها في 25 أغسطس 2025 وإزالتها نهائيًا وفقًا لسياسة الاحتفاظ بالبيانات.
تأثيرات "روابط Firebase الديناميكية" في مسارات "مصادقة Firebase"
أريد تفعيل ميزة المصادقة عبر رابط في رسالة إلكترونية في ميزة "مصادقة Firebase" لمشروعي. هل سأحتاج إلى إعداد "روابط Firebase الديناميكية"؟
لا، ليس عليك إعداد "روابط Firebase الديناميكية" لأنّ ذلك لم يعُد ممكنًا. بدلاً من ذلك، يمكنك اتّباع الأدلة المعدَّلة حول بدء استخدام المصادقة عبر رابط البريد الإلكتروني لتفعيلها وتنفيذها في مشروعك:
يمكنك الاطّلاع على القائمة الكاملة للإجراءات المتأثرة بهذا التغيير.
كيف تتأثر ميزات المصادقة التالية: المصادقة عبر رابط البريد الإلكتروني وإعادة ضبط كلمة المرور وتأكيد عنوان البريد الإلكتروني؟
ستبقى المصادقة عبر رابط البريد الإلكتروني وإجراءات البريد الإلكتروني خارج النطاق مع Firebase متاحة، ولكن عليك الترقية إلى أحدث إصدارات حِزم تطوير البرامج (SDK) لـ Firebase Authentication والانتقال إلى الحلّ الجديد لمواصلة استخدام هذه الإجراءات بعد إيقاف خدمة Firebase Dynamic Links في 25 أغسطس 2025.
يمكنك اتّباع الأدلّة الواردة في الروابط أدناه للحصول على تعليمات حول كيفية إكمال عملية نقل البيانات:
يمكنك الاطّلاع على قائمة كاملة بالإجراءات المتأثرة بهذا التغيير.
كيف تتأثر عمليات تنفيذ مسار OAuth باستخدام إصدارات حزمة تطوير البرامج (SDK) لـ "مصادقة Firebase" على Android الأقدم من الإصدار 20.0.0 أو إصدارات BoM الأقدم من الإصدار 26.0.0؟
يجب تحديث حزمة تطوير البرامج (SDK) لمصادقة Firebase على Android إلى أحدث إصدار (الإصدار 20.0.0 على الأقل) لمواصلة استخدام عملية OAuth في تطبيقات Android.
هل تتأثر إجراءات البريد الإلكتروني في "مصادقة Firebase" على تطبيقات الويب؟
لا، لا يؤثّر إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا إلا في معالجة عناوين URL الواردة على الأجهزة الجوّالة.
كيف تتأثر عمليات التنفيذ التي تستخدم مكتبات Firebase JS SDK لمصادقة موفّري OAuth في تطبيق Cordova؟
تستخدم حزمة تطوير البرامج (SDK) لمنصة Firebase JS روابط Firebase الديناميكية لتنفيذ مسارات مصادقة OAuth في تطبيقات Cordova. سيكون عليك تعديل طريقة تنفيذ العملية من خلال تنفيذ عملية OAuth يدويًا وتمرير بيانات اعتماد OAuth الناتجة إلى Firebase لإكمال عملية المصادقة.
اطّلِع على دليل Cordova لمزيد من التفاصيل.
ما هي بعض الخيارات البديلة لـ "روابط Firebase الديناميكية"؟
يُرجى الاطّلاع على الأسئلة الشائعة حول "كيف يمكنني نقل البيانات من الخدمة" التي توضّح بالتفصيل سيناريوهات مختلفة لنقل البيانات وتقدّم أدلة نقل البيانات للبدائل المختلفة المتاحة.