Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إنشاء عنوان URL لرابط ديناميكي يدويًا

يمكنك إنشاء Dynamic Link من خلال إنشاء عنوان URL يدويًا باستخدام النموذج التالي:

https://your_subdomain.page.link/?link=your_deep_link&apn=package_name[&amv=minimum_version][&afl=fallback_link]

مَعلمات Dynamic Link

مَعلمة الرابط لصفحة معيّنة (مَعلمة الحمولة)

الرابط

مَعلمة الرابط لصفحة معيّنة (مَعلمة الحمولة)
الرابط	الرابط الذي سيفتحه تطبيقك حدِّد عنوان URL يمكن لتطبيقك التعامل معه، وعادةً ما يكون محتوى التطبيق أو الحمولة، ما يؤدي إلى بدء منطق خاص بالتطبيق (مثل إضافة رصيد قسيمة إلى حساب المستخدم أو عرض شاشة ترحيب). يجب أن يكون هذا الرابط عنوان URL بتنسيق جيد، وأن يكون بترميز عنوان URL صحيح، وأن يستخدم إما HTTP أو HTTPS، ولا يمكن أن يكون رابطًا ديناميكيًا آخر. عندما يفتح المستخدمون Dynamic Link على متصفّح ويب على كمبيوتر مكتبي، سيتم تحميل عنوان URL هذا (ما لم يتم تحديد المَعلمة `ofl`). إذا لم يكن لديك مثيل على الويب لمحتوى الرابط، ليس من الضروري أن يشير عنوان URL إلى مورد ويب صالح. في هذه الحالة، عليك إعداد عملية إعادة توجيه من عنوان URL هذا إلى صفحتك الرئيسية مثلاً.

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

عندما يفتح المستخدمون Dynamic Link على متصفّح ويب على كمبيوتر مكتبي، سيتم تحميل عنوان URL هذا (ما لم يتم تحديد المَعلمة ofl). إذا لم يكن لديك مثيل على الويب لمحتوى الرابط، ليس من الضروري أن يشير عنوان URL إلى مورد ويب صالح. في هذه الحالة، عليك إعداد عملية إعادة توجيه من عنوان URL هذا إلى صفحتك الرئيسية مثلاً.

مَعلمات Android
apn	اسم حزمة تطبيق Android المطلوب استخدامه لفتح الرابط. يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في وحدة تحكّم Firebase. مطلوب لفتح تطبيق Android على Dynamic Link.
afl	الرابط الذي يتم فتحه عندما لا يكون التطبيق مثبّتًا حدِّد هذا الإجراء لتنفيذ إجراء آخر غير تثبيت تطبيقك من "متجر Play" عندما لا يكون التطبيق مثبّتًا، مثل فتح إصدار الويب المتوافق مع الأجهزة الجوّالة من المحتوى أو عرض صفحة ترويجية لتطبيقك.
amv	`versionCode` الحد الأدنى لإصدار تطبيقك الذي يمكنه فتح الرابط إذا كان التطبيق المثبَّت هو إصدار قديم، يتم نقل المستخدم إلى "متجر Play" لترقية التطبيق.

مَعلمات iOS
ibi	معرّف حزمة تطبيق iOS المطلوب استخدامه لفتح الرابط يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في وحدة تحكّم Firebase. مطلوب لفتح تطبيق iOS على Dynamic Link.
ifl	الرابط الذي يتم فتحه عندما لا يكون التطبيق مثبّتًا حدِّد هذا الإجراء لتنفيذ إجراء آخر غير تثبيت تطبيقك من App Store عندما لا يكون التطبيق مثبّتًا، مثل فتح إصدار الويب المتوافق مع الأجهزة الجوّالة من المحتوى أو عرض صفحة ترويجية لتطبيقك.
ius	مخطّط عنوان URL المخصّص لتطبيقك، إذا تم تحديده ليكون شيئًا آخر غير معرّف حزمة تطبيقك
ipfl	الرابط المراد فتحه على أجهزة iPad عندما لا يكون التطبيق مثبّتًا حدِّد هذا الإجراء لتنفيذ إجراء آخر غير تثبيت تطبيقك من App Store عندما يكون التطبيق غير مثبّت، مثل فتح إصدار الويب من المحتوى أو عرض صفحة ترويجية لتطبيقك.
ipbi	رقم تعريف حزمة تطبيق iOS المطلوب استخدامه على أجهزة iPad لفتح الرابط يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في وحدة تحكّم Firebase.
isi	رقم تعريف تطبيقك على App Store، والذي يُستخدَم لإرسال المستخدمين إلى App Store عندما لا يكون التطبيق مثبّتًا
imv	رقم الإصدار الأدنى لتطبيقك الذي يمكنه فتح الرابط يتم تمرير هذا العلامة إلى تطبيقك عند فتحه، وعلى تطبيقك تحديد الإجراء الذي يجب اتّخاذه بشأنها.
efr	في حال ضبط القيمة على "1"، سيتم تخطّي صفحة معاينة التطبيق عند فتح Dynamic Link، وسيتم بدلاً من ذلك إعادة التوجيه إلى التطبيق أو المتجر. يمكن لصفحة معاينة التطبيق (المفعّلة تلقائيًا) توجيه المستخدمين بشكل أكثر موثوقية إلى الوجهة الأنسب عند فتح Dynamic Links في التطبيقات. ومع ذلك، إذا كنت تتوقّع أن يتم فتح Dynamic Links فقط في التطبيقات التي يمكنها فتح Dynamic Links بشكل موثوق بدون هذه الصفحة، يمكنك إيقافها باستخدام هذه المَعلمة.Dynamic Link ستؤثّر هذه المَعلمة في سلوك Dynamic Link على نظام التشغيل iOS فقط.

مَعلمات المنصة الأخرى
ofl	الرابط الذي سيتم فتحه على الأنظمة الأساسية غير Android وiOS يكون ذلك مفيدًا لتحديد سلوك مختلف على أجهزة الكمبيوتر المكتبي، مثل عرض صفحة ويب كاملة لمحتوى التطبيق أو الحمولة (على النحو المحدّد من خلال رابط المَعلمة) مع رابط ديناميكي آخر لتثبيت التطبيق.

مَعلمات العلامة الوصفية لوسائل التواصل الاجتماعي
st	العنوان الذي سيتم استخدامه عند مشاركة Dynamic Link في مشاركة على وسائل التواصل الاجتماعي.
sd	الوصف الذي سيتم استخدامه عند مشاركة Dynamic Link في مشاركة على وسائل التواصل الاجتماعي.
si	عنوان URL لصورة ذات صلة بهذا الرابط يجب أن تكون الصورة بحجم 300×200 بكسل على الأقل وبحجم أقل من 300 كيلوبايت.

مَعلمات "إحصاءات Google"
utm_source utm_medium utm_campaign utm_term utm_content	مَعلمات إحصاءات Google Play
at ct mt pt	مَعلمات إحصاءات iTunes Connect

ملاحظة: يمكنك دمج مَعلمات Android و iOS لإنشاء Dynamic Link يمكن استخدامه على كلتا المنصّتَين. على سبيل المثال:

https://example.page.link/?link=https://www.example.com/someresource&apn=com.example.android&amv=3&ibi=com.example.ios&isi=1234567&ius=exampleapp

تصحيح أخطاء عنوان URL

يمكنك تصحيح أخطاء Dynamic Link من خلال أخذ عنوان URL طويل أو قصير وإرفاق مَعلمة تصحيح أخطاء.

https://example.page.link/?link=https://www.example.com&d=1
https://example.page.link/WXYZ?d=1

معلّمة تصحيح الأخطاء
يوم	بدلاً من تحميل Dynamic Link، يمكنك إنشاء مخطّط بياني يمكنك استخدامه لمعاينة سلوك Dynamic Links على المنصات والإعدادات المختلفة.

الخطوات التالية

بعد إنشاء Dynamic Link، عليك إعداد تطبيقك لتلقّي Dynamic Links وإرسال المستخدمين إلى المكان المناسب في تطبيقك بعد فتحه.

لتلقّي Dynamic Links في تطبيقك، اطّلِع على مستندات iOS وAndroid و C++ وUnity.