Lorixen.
AR

أخفِ شريط «حمّل تطبيقنا» عمّن ثبّته: getInstalledRelatedApps

باختصار: شريط «حمّل تطبيقنا» في أعلى موقعك مفيد لمن لم يحمّل التطبيق بعد، ومزعج لمن حمّله فعلاً ويفتح الموقع من رابط على واتساب. توضح MDN أن الدالة navigator.getInstalledRelatedApps تعيد قائمة بالتطبيقات المرتبطة بموقعك المثبتة عند الزائر، ومن استخداماتها المذكورة إخفاء شريط التثبيت إن كان التطبيق موجوداً. لتعمل، يجب ذكر التطبيق في related_applications في ملف manifest، وأن يثبت تطبيق أندرويد علاقته بالموقع عبر Digital Asset Links. وهي تجريبية ومحدودة التوفر، وتعمل في سياق آمن وفي الصفحة الرئيسية لا داخل iframe، فاجعلها تحسيناً لا شرطاً.

المشكلة من جهة الزبون

مطعم في عمّان لديه تطبيق للطلب على متجر جوجل، وموقع ويب. في أعلى الموقع شريط ثابت: «اطلب أسرع من التطبيق، حمّله الآن». الزبائن الدائمون حمّلوا التطبيق منذ زمن، لكنهم أحياناً يفتحون الموقع من رابط عرض أُرسل في مجموعة واتساب، فيرون الشريط نفسه كل مرة. بعضهم يضغط عليه ظناً أنه تحديث، فيُنقل إلى صفحة المتجر ويرى زر «فتح»، ويعود مرتبكاً.

الأفضل: إن كان التطبيق مثبتاً، اعرض بدل الشريط زراً صغيراً «افتح هذا العرض في التطبيق»، أو لا تعرض شيئاً. وإن لم يكن مثبتاً، اعرض الشريط كما هو.

ما تفعله getInstalledRelatedApps

بحسب MDN، تعيد الدالة وعداً يُحل بمصفوفة من الكائنات تمثل التطبيقات المرتبطة التي ثبّتها المستخدم، سواء كانت تطبيقات خاصة بالمنصة أو تطبيقات ويب تقدمية PWA. وتذكر MDN صراحة أن هذا يمكن أن يُستخدم لتخصيص المحتوى، مثل إزالة شرائط «ثبّت تطبيقنا» من تطبيق الويب إن كان التطبيق مثبتاً.

وتقول MDN إنها تستطيع فحص تثبيت تطبيقات أندرويد وتطبيقات Windows UWP وتطبيقات PWA المرتبطة بالموقع. وكل كائن في النتيجة يحمل:

  • platform: المنصة، مثل "play" لتطبيق من متجر Google Play، أو "webapp" لتطبيق ويب تقدمي.
  • id: معرّف التطبيق على تلك المنصة، اختياري، وشكله يختلف بحسب المنصة.
  • url: رابط مرتبط بالتطبيق، اختياري، عادة صفحة معلوماته وتثبيته.

العلاقة يجب أن تُعلن من الطرفين

لا تكشف الدالة أي تطبيق عشوائي على جهاز الزائر؛ هذا مهم للخصوصية. تشرح MDN أن ربط تطبيق الويب بالتطبيق يحتاج أمرين:

  1. من جهة الموقع: يُذكر التطبيق في عضو related_applications في ملف manifest الخاص بالموقع.
  2. من جهة التطبيق: يعرّف التطبيق علاقته بالموقع. لتطبيق أندرويد يكون ذلك عبر نظام Digital Asset Links، ولتطبيق Windows عبر URI Handlers.

إن لم يكتمل الطرفان، تعود المصفوفة فارغة حتى لو كان التطبيق مثبتاً. وتذكر MDN أن الدالة تعيد فقط التطبيقات المذكورة في related_applications.

مثال توضيحي لملف manifest

{
  "name": "مطعم المثال",
  "start_url": "/ar/",
  "related_applications": [
    {
      "platform": "play",
      "id": "jo.example.restaurant",
      "url": "https://play.google.com/store/apps/details?id=jo.example.restaurant"
    }
  ]
}

ومن جهة التطبيق، يضيف مطور أندرويد ملف assetlinks.json في مجلد /.well-known/ على الموقع، يربط اسم حزمة التطبيق ببصمة شهادة توقيعه. هذا الملف نفسه يُستخدم عادة لفتح روابط الموقع داخل التطبيق مباشرة، فإن كان تطبيقك يفتح روابطك بالفعل، فالأرجح أن جزءاً من العمل منجز.

مثال توضيحي للكود

async function decideAppBanner() {
  const banner = document.getElementById('app-banner');
  if (!('getInstalledRelatedApps' in navigator)) {
    banner.hidden = false;
    return;
  }
  try {
    const apps = await navigator.getInstalledRelatedApps();
    const hasApp = apps.some(a => a.platform === 'play');
    banner.hidden = hasApp;
    if (hasApp) document.getElementById('open-in-app').hidden = false;
  } catch (e) {
    banner.hidden = false;
  }
}

لاحظ أن كل حالة غير مؤكدة تعود إلى السلوك القديم: عرض الشريط. أي أن الزائر الذي لا يدعم متصفحه الدالة يرى الموقع كما كان تماماً.

الحدود التي يجب أن تعرفها

  • تجريبية: تصفها MDN بأنها تقنية تجريبية، وليست Baseline لأنها لا تعمل في بعض المتصفحات الأكثر استخداماً. زوار آيفون تحديداً لا يُتوقع أن يستفيدوا منها، وتطبيقك على متجر أبل ليس ضمن المنصات المذكورة في قائمتها.
  • سياق آمن وفي الصفحة الرئيسية: تذكر MDN أنها يجب أن تُستدعى في سياق آمن على المستوى الأعلى، أي ليس داخل iframe، وإلا ترمي خطأ InvalidStateError.
  • لا تبنِ عليها قرارات مهمة: هي لتحسين العرض فقط. لا تخفِ معلومات أو عروضاً عن زائر لأن الدالة قالت إن التطبيق مثبت.

لزوار آيفون

بما أن الدالة لا تساعد مع تطبيقات أبل، فخيارك هناك مختلف. توثيق أبل للمطورين يشرح «شريط التطبيق الذكي» Smart App Banner في Safari: تضيف وسم meta باسم apple-itunes-app في رأس كل صفحة تريد ظهور الشريط فيها، مع معرّف التطبيق app-id، وبشكل اختياري app-argument برابط يعطي التطبيق سياق الصفحة. وتذكر أبل أنه إن كان التطبيق مثبتاً، يغيّر الشريط فعله تلقائياً، فيفتح التطبيق مباشرة عند الضغط. وإن لم يكن مثبتاً، ينقل الزائر إلى صفحة التطبيق في App Store.

مثال توضيحي:

<meta name="apple-itunes-app" content="app-id=1234567890, app-argument=https://example.jo/ar/offers/friday">

إن استخدمته، فلا تعرض شريطك الخاص لزوار iOS في الوقت نفسه، حتى لا يرى الزائر شريطين. ومع app-argument، يستطيع التطبيق أن يفتح العرض نفسه الذي كان الزبون يقرؤه، لا الشاشة الرئيسية فقط، إن برمجه المطور على قراءة هذا الرابط.

قِس قبل أن تقرر

بعد التفعيل، سجّل في أداة التحليل حدثاً بسيطاً: هل عُرض الشريط أم أُخفي، وهل ضُغط زر «افتح في التطبيق». بعد أسابيع ستعرف كم زائراً من زوار أندرويد يملك التطبيق أصلاً، وهل يفضلون الإكمال في الموقع أم الانتقال إلى التطبيق. هذه معلومة تفيدك في قرارات أكبر، مثل أين تضع العروض الحصرية.

زر الإغلاق يبقى ضرورياً

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

أسئلة شائعة

لماذا تعيد الدالة مصفوفة فارغة رغم أن التطبيق مثبت عندي؟

غالباً لأن العلاقة غير مكتملة: التطبيق غير مذكور في related_applications، أو ملف assetlinks.json غير صحيح، أو المتصفح لا يدعم الدالة.

هل تكشف الدالة كل التطبيقات على جهاز الزائر؟

لا. بحسب MDN تعيد فقط التطبيقات المذكورة في manifest موقعك والتي أثبتت علاقتها به.

هل تعمل مع تطبيقي على متجر أبل؟

قائمة المنصات في MDN لا تشمله. لزوار آيفون، استخدم شريط Safari الذكي بوسم apple-itunes-app، وهو يعرض «فتح» تلقائياً إن كان التطبيق مثبتاً بحسب أبل.

هل أستطيع استدعاءها من صفحة مضمنة في iframe؟

لا. MDN تذكر أنها يجب أن تُستدعى في المستوى الأعلى، وإلا يظهر خطأ InvalidStateError.

إذا كان لديك تطبيق وموقع ويب وتريد أن يتعاملا كمنتج واحد أمام الزبون، تواصل معنا لترتيب العلاقة بينهما.

المصادر

WhatsAppاحجز مكالمة