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