الأسئلة الشائعة حول إيقاف الروابط الديناميكية

لقد أطلقنا Firebase Dynamic Links منذ أكثر من 7 سنوات لجعل عناوين URL أكثر قوة - على سبيل المثال، تغيير وجهة الرابط ديناميكيًا بناءً على ظروف وقت التشغيل.

على مر السنين، تطورت الأنظمة البيئية للويب والجوال باستخدام تقنيات مثل App Links و Google Play Instant و Universal Links و App Clips ، مما جعل رحلات المستخدم عبر التطبيقات والويب أكثر سلاسة وقابلية للتنبؤ لمستخدمي تطبيقك. نعتقد أنك والمستخدمين لديك ستستفيدون بشكل أكبر من اعتماد هذه التقنيات بشكل مباشر والاستمرار في دفع النظام البيئي إلى الأمام. ومع ذلك، إلى جانب هذه التغييرات الجديدة، تطورت أيضًا واجهات برمجة التطبيقات الأصلية الأصلية التي تم بناء الروابط الديناميكية لـ Firebase عليها وطرحت تحديات جديدة.

على سبيل المثال، أثرت تغييرات النظام البيئي على قدرتنا على توفير تجربة مستقرة باستمرار لإحدى الميزات الأساسية لـ Firebase Dynamic Links - مما يمنح مستخدمي التطبيق انتقالًا سلسًا إلى التطبيق بعد التثبيت، بغض النظر عن النظام الأساسي.

بدلاً من الاستمرار في دعم تجربة أقل من مثالية، قررنا إيقاف Firebase Dynamic Links، وإعادة تركيز مواردنا على حل نقاط الضعف الأخرى للمطورين.

نحن ندرك أن هذا التغيير سيتطلب وقتك لتقييم واعتماد الحلول البديلة أو موفري المنصات في السوق.

نحن مستمرون في تطوير Firebase لتلبية احتياجاتك مع استمرار النظام البيئي في التطور والتغيير. سنستمر في إطلاق ميزات وتحديثات جديدة عبر منتجات Firebase، ونلتزم بمساعدتك على التفوق في رحلات تطوير تطبيقاتك.

ما الذي أحتاج إلى معرفته؟

في 25 أغسطس 2025، سيتم إيقاف Firebase Dynamic Links. ستتوقف جميع الروابط التي تقدمها روابط Firebase الديناميكية (المستضافة على النطاقات المخصصة والنطاقات الفرعية page.link) عن العمل ولن تتمكن بعد ذلك من إنشاء روابط جديدة.

لمساعدتك في تحديد كيفية الترحيل من روابط Firebase الديناميكية، سنستمر في تحديث مستند الأسئلة الشائعة هذا بمعلومات إضافية لتأخذها في الاعتبار، بالإضافة إلى توفير أدلة الترحيل لسيناريوهات الترحيل المختلفة التي قد تتطابق مع الطريقة التي تستخدم بها روابط Firebase الديناميكية اليوم.

سنستمر أيضًا في تحديث هذا الدليل بمزيد من الأسئلة الشائعة مع تقدم الإيقاف نحو تاريخ الانتهاء في 25 أغسطس 2025 ونكتشف أي مشكلات إضافية بينما نساعدك في دعمك في جهود الترحيل.

راجع الأسئلة الشائعة أدناه للمساعدة في الإجابة على بعض أهم أسئلتك.

لبدء الترحيل، يرجى إلقاء نظرة على الأسئلة الشائعة "كيف يمكنني الترحيل من الخدمة" أدناه.

في 25 أغسطس 2025، سيتم إيقاف Firebase Dynamic Links. ستتوقف جميع الروابط التي تقدمها روابط Firebase الديناميكية (سواء تلك المستضافة على النطاقات المخصصة أو على نطاقات page.link الفرعية) عن العمل.

كم من الوقت سأضطر للهجرة؟

لديك حتى 25 أغسطس 2025 لإكمال عملية الترحيل.

نعم، ستستمر روابطك الجديدة والحالية في العمل حتى يتم إيقاف خدمة الارتباطات الديناميكية في 25 أغسطس 2025.

عند إيقاف تشغيل الروابط الديناميكية لـ Firebase، يمكنك توقع ما يلي:

  • ستعرض جميع الروابط التي تم النقر عليها استجابة حالة HTTP 404 للمستخدمين النهائيين.
  • جميع طلبات HTTP إلى:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (واجهة برمجة تطبيقات الروابط القصيرة)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (واجهة برمجة تطبيقات إحصائيات الرابط)

    سيُرجع استجابة حالة HTTP 400/403.

  • يعتمد السلوك التالي على إصدار النظام الأساسي لـ SDK واستدعاء واجهة برمجة التطبيقات (API) الذي تم إجراؤه في تطبيقك:

    دائرة الرقابة الداخلية

    حالة الاستخدام استدعاء واجهة برمجة التطبيقات رمز الحالة سلوك هل سيتعطل تطبيقك؟
    إنشاء رابط قصير

    تقصير (سويفت)

    تقصيرUrl (سويفت)

    تقصير مع الإكمال (الهدف-C)

    400 ينبعث الخطأ مع سبب الفشل لا*
    الإسناد المفتوح الأول

    يتم الاتصال به تلقائيًا على FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 لا يتم إصدار أي أخطاء، ولكن يتم إرسال كائن FDL مرة أخرى ببيانات فارغة لا*
    إعادة فتح الإسناد

    مقبض UniversalLink (سويفت)

    مقبض UniversalLink (الهدف-C)

    400 ينبعث الخطأ مع سبب الفشل لا*

    ذكري المظهر

    حالة الاستخدام استدعاء واجهة برمجة التطبيقات رمز الحالة سلوك هل سيتعطل تطبيقك؟
    إنشاء رابط قصير

    بيلدشورتديناميكلينك (كوتلين)

    بيلدشورتديناميكلينك (جافا)

    400 ينبعث الخطأ مع سبب الفشل لا*
    الإسناد المفتوح الأول

    getDynamicLink(getIntent()) (كوتلين)

    getDynamicLink(getIntent()) (جافا)

    400 تقوم المهمة بإرجاع استجابة ناجحة، ولكن بيانات FDL ستكون فارغة لا*
    إعادة فتح الإسناد

    getDynamicLink(getIntent()) (كوتلين)

    getDynamicLink(getIntent()) (جافا)

    400 تقوم المهمة بإرجاع استجابة ناجحة، ولكن بيانات FDL ستكون فارغة لا*
    قبول دعوة يتم استدعاء وحدة AppInvite في خدمات Google Play عند التعامل مع إعادة توجيه النية (من *.page.link أو المجال المخصص) 400 يُظهر القرص الدوار عند استدعاء خدمات Google Play ويختفي عند إرجاع استجابة 400 لا*

كيف يمكنني الترحيل من الخدمة؟

لقد وجدنا أن المطورين المختلفين لديهم احتياجات مختلفة عندما يتعلق الأمر باستخدام روابط Firebase الديناميكية.

اعتمادًا على حالات الاستخدام الخاصة بك وتقييم استخدام Firebase Dynamic Links، فمن المحتمل أن يتطابق أحد السيناريوهات أدناه مع احتياجاتك.

بالنسبة لهذا السيناريو، نوصيك باستخدام مقدمي/موردي خدمات الارتباط العميق الآخرين، مثل Adjust وAppsFlyer وBitly وBranch وKochava وغيرهم من مقدمي الخدمة المشابهين في السوق. (لاحظ أن هؤلاء الموفرين لم يتم فحصهم بواسطة Google، لكنهم يقدمون وظائف مشابهة للروابط الديناميكية لـ Firebase).

يمكنك أيضًا تصدير البيانات التعريفية للارتباط العميق ، مما يسهل ترحيل الروابط الخاصة بك إلى أي مزود تختاره.

للمساعدة في العثور على موفر يتمتع بميزات مطابقة لـ Firebase Dynamic Links، راجع قائمة الميزات التالية أدناه.

ميزات الروابط الديناميكية لـ Firebase:

  • يوجه المستخدمين إلى المتجر الصحيح لأجهزتهم بنقرة واحدة (ويعود إلى صفحة الويب إذا لزم الأمر)
  • يوفر للمستخدمين استمرار الرحلة بعد تنزيل تطبيقك وتثبيته وعرض رابط عميق مؤجل
  • يوفر للمستخدمين تجربة سياقية عبر المحتوى المرتبط بعمق في تطبيقك (عند تثبيته بالفعل)
  • يوفر بيانات تحليلية تتعلق بأحداث النقر على الرابط الديناميكي
  • يوفر القدرة على إنشاء عناوين URL للارتباط القصير
  • يوفر القدرة على إضافة بيانات التعريف إلى روابط للمشاركة الاجتماعية

ماذا لو كنت أهتم فقط بالارتباط العميق بتطبيقي بعد تثبيته بالفعل؟

بالنسبة لهذا السيناريو، نوصي باستخدام روابط التطبيقات والارتباطات العامة التي تعد طرقًا مدعومة بالنظام الأساسي للمطورين لتوفير تجارب الارتباط العميق لمستخدميهم.

راجع هذا الدليل للحصول على مزيد من التفاصيل حول كيفية الترحيل إلى استخدام روابط التطبيقات والارتباطات العامة .

يصف هذا الدليل أيضًا كيفية استخدام استضافة Firebase بشكل اختياري لاستضافة النطاق الضروري وملفات التحقق من رابط الأصول على النطاق الذي تخطط لاستخدامه لروابطك الجديدة (على سبيل المثال، ملف Assetlinks.json لروابط التطبيقات، وملف apple-app-site-association لـ الروابط العالمية).

في هذا السيناريو، قد لا تحتاج إلى اتخاذ أي إجراء في تطبيقك للتعامل مع غروب الشمس القادم، ومع ذلك نوصي بما يلي:

إذا رأيت سيناريو الترحيل لا يغطي احتياجاتك الخاصة، فيرجى التواصل معنا لإعلامنا بذلك

ستظل واجهات برمجة تطبيقات Firebase Dynamic Links للروابط القصيرة والتحليلات متاحة حتى تاريخ الانتهاء في 25 أغسطس 2025.

وبعد ذلك التاريخ، لن تكون واجهات برمجة التطبيقات هذه متاحة للاستخدام، وسيتم إيقاف الخدمة .

يرجى الرجوع إلى دليل تصدير البيانات التعريفية للرابط الخاص بك للحصول على إرشادات حول كيفية تصدير البيانات التعريفية للرابط الخاص بك.

يمكنك استخدام دليل التصدير لاسترداد بيانات تعريف Firebase Dynamic Links، والتي تتضمن الرابط نفسه.

يمكنك استخدام Firebase Dynamic Links Analytics API لاسترداد بيانات إحصائيات الارتباط لكل رابط من روابط Firebase الديناميكية. تقتصر واجهة برمجة تطبيقات Analytics هذه على 5 QPS تقريبًا. للحصول على مثال حول كيفية العمل ضمن حد الطلب هذا عند استخدام واجهة برمجة التطبيقات، يرجى الرجوع إلى نموذج مهمة السحابة هذا.

يمكنك أيضًا استخدام Google Analytics وتصدير بياناتك لمجموعة فرعية من بيانات تحليلات الارتباط، بما في ذلك أحداث تحديثات التطبيق الفريدة لبرنامج Google Analytics.

إذا كنت بحاجة إلى معدل طلب أعلى للمساعدة في عملية الترحيل، فيرجى الاتصال بنا على دعم Firebase .

سيتم وضع علامة على البيانات التعريفية للنطاق والرابط الخاص بك للحذف في 25 أغسطس 2025 وإزالتها وفقًا لسياسة الاحتفاظ بالبيانات لدينا .

نعم، ستستمر مصادقة رابط بريدك الإلكتروني باستخدام مصادقة Firebase في العمل.

تستخدم مصادقة Firebase حاليًا روابط Firebase الديناميكية لتخصيص روابط المصادقة، ولكننا سنقدم تحديثًا لضمان استمرار هذه الوظيفة في العمل بعد إيقاف تشغيل خدمة Firebase Dynamic Links.

لاحظ أن استمرار الوظيفة منفصل عن استخدام روابط Firebase الديناميكية لحالات الاستخدام الأساسية لتوجيه المتجر والويب، والارتباط العميق المؤجل والعادي، والذي سيتم إهماله وفقًا للمخطط الزمني للترحيل الذي تمت مشاركته أعلاه.

يرجى الاطلاع على الأسئلة الشائعة "كيف يمكنني الترحيل من الخدمة" والتي توضح بالتفصيل سيناريوهات الترحيل المختلفة وتوفر أدلة الترحيل لمختلف البدائل المتاحة.