يمكنك إنشاء 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 منسّقًا بشكل جيد، وأن يكون مشفّرًا بشكل صحيح، وأن يستخدم بروتوكول HTTP أو HTTPS، ولا يمكن أن يكون رابطًا ديناميكيًا آخر. |
| مَعلمات Android | |
|---|---|
| apn | اسم حزمة تطبيق Android الذي سيتم استخدامه لفتح الرابط يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في Firebase console. هذه المَعلمة مطلوبة لفتح تطبيق Android من خلال Dynamic Link. |
| afl | الرابط الذي سيتم فتحه عندما لا يكون التطبيق مثبَّتًا يُرجى تحديد هذه المَعلمة لتنفيذ إجراء آخر غير تثبيت تطبيقك من "متجر Google Play" عندما لا يكون التطبيق مثبَّتًا، مثل فتح إصدار الويب المتوافق مع الأجهزة الجوّالة من المحتوى، أو عرض صفحة ترويجية لتطبيقك. |
| amv | الـ versionCode لأدنى إصدار من تطبيقك يمكنه فتح الرابط إذا كان التطبيق المثبَّت إصدارًا أقدم، يتم نقل المستخدم إلى "متجر Google Play" لترقية التطبيق. |
| مَعلمات iOS | |
|---|---|
| ibi | رقم تعريف حزمة تطبيق iOS الذي سيتم استخدامه لفتح الرابط يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في Firebase console. هذه المَعلمة مطلوبة لفتح تطبيق iOS من خلال Dynamic Link. |
| ifl | الرابط الذي سيتم فتحه عندما لا يكون التطبيق مثبَّتًا يُرجى تحديد هذه المَعلمة لتنفيذ إجراء آخر غير تثبيت تطبيقك من App Store عندما لا يكون التطبيق مثبَّتًا، مثل فتح إصدار الويب المتوافق مع الأجهزة الجوّالة من المحتوى، أو عرض صفحة ترويجية لتطبيقك. |
| ius | مخطّط عنوان URL المخصّص لتطبيقك، إذا تم تحديده ليكون مختلفًا عن رقم تعريف حزمة تطبيقك |
| ipfl | الرابط الذي سيتم فتحه على أجهزة iPad عندما لا يكون التطبيق مثبَّتًا يُرجى تحديد هذه المَعلمة لتنفيذ إجراء آخر غير تثبيت تطبيقك من App Store عندما لا يكون التطبيق مثبَّتًا، مثل فتح إصدار الويب من المحتوى، أو عرض صفحة ترويجية لتطبيقك. |
| ipbi | رقم تعريف حزمة تطبيق iOS الذي سيتم استخدامه على أجهزة iPad لفتح الرابط يجب ربط التطبيق بمشروعك من صفحة "نظرة عامة" في Firebase console. |
| isi | رقم تعريف تطبيقك في App Store، ويُستخدم لإرسال المستخدمين إلى App Store عندما لا يكون التطبيق مثبَّتًا |
| imv | الـ رقم إصدار لأدنى إصدار من تطبيقك يمكنه فتح الرابط يتم تمرير هذه العلامة إلى تطبيقك عند فتحه، ويجب أن يقرّر تطبيقك الإجراء الذي يجب اتّخاذه بشأنها. |
| efr | إذا تم ضبط هذه المَعلمة على '1'، يتم تخطّي صفحة معاينة التطبيق عند فتح Dynamic Link، ويتم بدلاً من ذلك إعادة التوجيه إلى التطبيق أو المتجر. يمكن لصفحة معاينة التطبيق (المفعّلة تلقائيًا) إرسال المستخدمين بشكل أكثر موثوقية إلى الوجهة الأنسب عندما يفتحون Dynamic Links في التطبيقات. ومع ذلك، إذا كنت تتوقّع فتح Dynamic Link في التطبيقات فقط التي يمكنها فتح Dynamic Links بشكل موثوق بدون هذه الصفحة، يمكنك إيقافها باستخدام هذه المَعلمة. لن تؤثّر هذه المَعلمة في سلوك 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" |
تحديد مشاكل عنوان 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.