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

أطلقنا "روابط Firebase الديناميكية" قبل أكثر من 7 سنوات لجعل عناوين URL أكثر فعالية، على سبيل المثال، تغيير وجهة الرابط ديناميكيًا استنادًا إلى شروط وقت التشغيل.

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

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

بدلاً من مواصلة توفير تجربة غير مثالية، قرّرنا إيقاف ميزة "الروابط الديناميكية في Firebase" نهائيًا وإعادة توجيه مواردنا لحلّ الصعوبات الأخرى التي يواجهها المطوّرون.

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

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

ما هي المعلومات التي يجب معرفتها؟

سيتم إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا في 25 آب (أغسطس) 2025. ستتوقّف عن العمل كل الروابط التي تعرِضها "روابط Firebase الديناميكية" (المستضافة على النطاقات المخصّصة والنطاقات الفرعية page.link) ولن تتمكّن بعد ذلك من إنشاء روابط جديدة.

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

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

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

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

في 25 آب (أغسطس) 2025، سيتم إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا. ستتوقف عن العمل كل الروابط التي تقدّمها "روابط Firebase الديناميكية" (سواء تلك المستضافة على نطاقات مخصّصة أو على النطاقات الفرعية لـ page.link).

كم من الوقت لدي لنقل البيانات؟

لديك مهلة حتى 25 آب (أغسطس) 2025 لإكمال عملية نقل البيانات.

نعم، ستستمر الروابط الجديدة والحالية في العمل إلى أن يتم إيقاف خدمة "الروابط الديناميكية" في 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.

  • السلوك التالي استنادًا إلى إصدار نظام التشغيل لحزمة SDK وطلب بيانات واجهة برمجة التطبيقات الذي تم إجراؤه في تطبيقك:

    iOS

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

    shorten (Swift)

    ‫shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*
    تحديد مصدر الفتح الأول

    يتمّ استدعاؤه تلقائيًا عند FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

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

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*

    Android

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

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*
    تحديد مصدر الفتح الأول

    getDynamicLink(getIntent())‎ (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

كيف يمكنني نقل البيانات من الخدمة؟

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

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

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

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

للمساعدة في العثور على مقدّم خدمة يقدّم ميزات مطابقة لميزات "روابط Firebase الديناميكية"، يُرجى الرجوع إلى القائمة التالية من الميزات أدناه.

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

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

ماذا لو كنت مهتمًا فقط بإنشاء روابط لصفحات في تطبيقي بعد تثبيته؟

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

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

يوضّح هذا الدليل أيضًا كيفية استخدام ميزة "استضافة Firebase" اختياريًا لاستضافةملفّات إثبات ملكية النطاق وملفّات روابط مواد العرض اللازمة على النطاق الذي تخطّط لاستخدامه للروابط الجديدة (مثل ملف assetlinks.json للروابط لتطبيقات Android، ملف apple-app-site-association للروابط العامة).

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

  • مراجعة "روابط Firebase الديناميكية" الحالية باتّباع الدليل حول تصدير البيانات الوصفية للروابط لضمان عدم تأثُّر المستخدمين والتطبيق بعد إيقاف عرض الروابط

  • حذف بادئات عناوين URL لروابط Firebase الديناميكية في وحدة تحكُّم Firebase ملاحظة: سيتم تلقائيًا حذف نطاقات بادئة عناوين URL بعد 25 آب (أغسطس) 2025.

  • إزالة حزمة تطوير البرامج (SDK) لخدمة "روابط Firebase الديناميكية" من تطبيقاتك

إذا رأيت سيناريو نقل بيانات لا يلبي احتياجاتك، يُرجى التواصل معنا لإعلامنا بذلك.

ستظل واجهات برمجة التطبيقات لخدمة "روابط Firebase الديناميكية" متاحة للروابط القصيرة وإحصاءات Google حتى تاريخ الإيقاف النهائي في 25 آب (أغسطس) 2025.

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

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

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

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

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

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

سيتم وضع علامة على البيانات الوصفية لنطاقك والروابط لحذفها في 25 آب (أغسطس) 2025، وسيتم حذفها نهائيًا وفقًا لسياسة الاحتفاظ بالبيانات.

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

تستخدِم ميزة "مصادقة Firebase" حاليًا "روابط Firebase الديناميكية" لتخصيص روابط المصادقة، ولكن سنوفّر تحديثًا سيتطلّب تحديثًا من جانب العميل لضمان استمرار عمل المصادقة باستخدام رابط البريد الإلكتروني بعد إيقاف خدمة "روابط Firebase الديناميكية".

يُرجى العِلم أنّ Firebase Authentication تعتمد فقط على خدمة "روابط Firebase الديناميكية" داخليًا، ولكنّها لا تعتمد على حزمة تطوير البرامج (SDK) الخاصة بهذه الخدمة.

لا يمكن حاليًا إعداد ميزة "روابط Firebase الديناميكية" للمرة الأولى إذا كان مشروعك على Firebase غير مفعّل فيها اعتبارًا من تاريخ الإعلان عن إيقافها نهائيًا في 25 آب (أغسطس) 2023.

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

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

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