Firebase App Indexing — جوهر فهرسة محتوى التطبيقات ومبدأ العمل

ما هو Firebase App Indexing

Firebase App Indexing هي تقنية من Google تجعل محتوى التطبيق المحمول متاحاً لبرنامج زحف بحث Google، مما يسمح بفهرسة شاشات التطبيق بنفس الطريقة التي يقوم بها Google بفهرسة صفحات الويب. عندما تتم فهرسة محتوى التطبيق، يمكن للمستخدمين العثور عليه في Google Search أو Google Assistant أو Google Lens والانتقال مباشرة إلى شاشة التطبيق المطلوبة بنقرة واحدة، متجاوزين صفحة الويب.

مبدأ فهرسة المحتوى المحمول

يقوم Google بفهرسة التطبيقات من خلال آليتين: الفهرسة التلقائية و Firebase App Indexing API. الفهرسة التلقائية تعمل على Android عبر Google Play Services: إذا كان التطبيق مثبتاً، يقوم Google تلقائياً بفهرسة المحتوى الذي يحتوي على روابط عميقة. تتيح فهرسة API للمطور التحكم برمجياً في المحتوى الظاهر في البحث، باستخدام Firebase App Indexing API لتحديث أو إزالة الصفحات المفهرسة.

لماذا نحتاج فهرسة التطبيقات

تحل فهرسة التطبيقات عدة مهام: جذب مستخدمين جدد من بحث Google (تظهر نتائج البحث محتوى التطبيق في بطاقات). زيادة التفاعل — يجد المستخدمون الحاليون المحتوى المطلوب بشكل أسرع من خلال البحث على الجهاز. زيادة التثبيتات — يعرض بحث Google روابط عميقة للمحتوى، وإذا لم يكن التطبيق مثبتاً، يعرض Google رابط تثبيت. يعمل App Indexing أيضاً على تحسين ظهور التطبيق في Google Assistant، الذي يمكنه اقتراح فتح التطبيق أثناء البحث الصوتي.

كيف تعمل فهرسة محتوى التطبيقات

عملية الفهرسة تبدأ عندما يكتشف Google مخططات URI الخاصة بتطبيقك. بالنسبة لـ Android، يستخدم Google المعلومات من Google Play Store (مستوى API، intent-filter، مخططات URI) لبناء خريطة التطبيق. بالنسبة لـ iOS، تتم الفهرسة من خلال Spotlight Integration و CSSearchableIndex. عندما يقوم Google بفهرسة محتوى التطبيق، يربط URI (مثل myapp://product/123) بعنوان URL للويب، إذا كان موجوداً، ويخزن هذا الزوج في فهرس البحث.

ربط التطبيق وموقع الويب

للفهرسة الصحيحة، يجب أن يفهم Google العلاقة بين تطبيقك وموقع الويب. Digital Asset Links هو ملف JSON يتم تحميله على موقع الويب الخاص بك ويؤكد أن التطبيق المحمول مالك لصاحب الموقع. يتم وضع ملف assetlinks.json في جذر النطاق ويحتوي على بصمة SHA256 لشهادة توقيع التطبيق. يتحقق Google من هذا الارتباط قبل عرض زر فتح التطبيق في نتائج البحث.

// https://yourapp.com/.well-known/assetlinks.json
[
    {
        "relation": ["delegate_permission/common.handle_all_urls"],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.myapp",
            "sha256_cert_fingerprints": [
                "14:6D:E9:92:..."
            ]
        }
    }
]

مصادر الفهرسة

يتلقى Google محتوى للفهرسة من عدة مصادر: Google Play Store (قائمة التطبيقات المنشورة مع مخططات URI الخاصة بها)، Android App Links (مخططات HTTP موثقة في Android 6.0+)، Firebase App Indexing API (تحديث برمجي للفهرس) والفهرسة التلقائية عبر Google Play Services على الأجهزة المثبت عليها التطبيق. يكمل كل مصدر الفهرس العام، مما يجعل محتوى التطبيق متاحاً قدر الإمكان للبحث.

الفهرسة التلقائية عبر Google Play Services

Google Play Services يقوم تلقائياً بفهرسة محتوى التطبيقات المثبتة على Android إذا كان التطبيق يستخدم مخططات URI و intent-filter صحيحة. تقوم الآلية بمسح التطبيق بحثاً عن intent-filter مع إجراء VIEW وتجميع URIs المستخدمة في التطبيق. هذه العملية تلقائية بالكامل ولا تتطلب أي كود إضافي من المطور — يكفي تكوين الروابط العميقة بشكل صحيح في البيان.

ما هي URIs التي تتم فهرستها تلقائياً

يقوم Google بفهرسة URIs التي تستوفي معايير معينة تلقائياً: يجب أن يكون URI متاحاً عبر intent-filter مع إجراء VIEW، يجب أن يكون المخطط HTTP/HTTPS لـ Android App Links. URIs ذات المخططات المخصصة (myapp://) تتم فهرستها أيضاً، ولكن فقط عندما يكون التطبيق مثبتاً. لا تنطبق الفهرسة التلقائية على URIs التي تؤدي إلى صفحات المصادقة أو البيانات الشخصية للمستخدم.

قيود الفهرسة التلقائية

للفهرسة التلقائية عدة قيود: لا يتم تحديث الفهرس على الفور، ولكن مع تأخير من عدة ساعات إلى أيام. مستوى API للتطبيق — تتطلب الفهرسة التلقائية minSdkVersion 23 أو أعلى. URIs بدون مخطط HTTP/HTTPS تتم فهرستها فقط على الأجهزة المثبت عليها التطبيق. لتسريع الفهرسة وإضافة محتوى بدون نظائر ويب، يوصى باستخدام Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API هي واجهة HTTP API من Google تتيح للمطور إدارة المحتوى المفهرس للتطبيق برمجياً. تقبل API طلبات إضافة وتحديث وإزالة صفحات URI من فهرس Google. على عكس الفهرسة التلقائية، تعمل API على الفور: بعد الاستدعاء، يبدأ Google في اعتبار URIs الجديدة في نتائج البحث في غضون دقائق.

تنسيق طلب Firebase App Indexing API

يحتوي طلب Firebase App Indexing API على كائن صفحة مع URI الخاص بها وعنوان ووصف وصور اختيارية. كل URI تتم معالجته كصفحة منفصلة يمكن العثور عليها عبر بحث Google. تستخدم API مصادقة OAuth 2.0 عبر حساب خدمة Firebase. للإضافة الجماعية لـ URIs، يتم دعم المعالجة المجمعة حتى 1000 صفحة في طلب واحد.

import com.google.firebase.appindexing.FirebaseAppIndex;
import com.google.firebase.appindexing.Indexable;
import com.google.firebase.appindexing.builders.Indexables;

public class AppIndexingHelper {
    public static void indexProduct(String productId,
            String name, String price) {
        Indexable product = Indexables.newSimpleBuilder(name)
            .setUrl("myapp://product/" + productId)
            .setDescription("السعر: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("فهرس", "موافق"))
            .addOnFailureListener(e ->
                Log.e("فهرس", "خطأ", e));
    }

    public static void removeProduct(String productId) {
        FirebaseAppIndex.getInstance()
            .remove("myapp://product/" + productId);
    }
}

تحديث وإزالة المحتوى

عندما يتغير محتوى التطبيق، من الضروري تحديث فهرس Google عبر Firebase App Indexing API. إزالة المحتوى القديم مهمة أيضاً: إذا لم يعد URI موجوداً أو يؤدي إلى 404، فيجب إزالته من الفهرس. لا يقوم Firebase App Indexing بإزالة المحتوى تلقائياً عند تغييره في التطبيق — المطور مسؤول عن مزامنة الفهرس مع حالة المحتوى الحالية. يوصى باستدعاء API عند كل تغيير في البيانات: إضافة أو تحرير أو حذف المنتجات والمقالات والملفات الشخصية.

إعداد App Indexing في Android

إعداد Firebase App Indexing في Android يتضمن عدة خطوات: إضافة Firebase SDK، إضافة تبعيات app-indexing في build.gradle، تكوين Android App Links وإنشاء خدمة لمعالجة URIs. الحد الأدنى لإصدار API لـ Firebase App Indexing هو 23. بعد تكوين SDK، يبدأ التطبيق تلقائياً في إرسال بيانات الفهرسة إلى Google عبر Google Play Services.

إضافة التبعيات والتكوين

لـ Firebase App Indexing، تحتاج إلى إضافة التبعية com.google.firebase:firebase-appindexing والمكون الإضافي google-services إلى build.gradle لوحدة التطبيق. يقوم Firebase تلقائياً بمعالجة بيانات الفهرسة عبر Google Play Services إذا كان التطبيق يستوفي المتطلبات: minSdkVersion 23+، وجود intent-filter بمخططات HTTP/HTTPS واستخدام Android App Links للتحقق. بالنسبة لـ URIs ذات المخططات المخصصة، يلزم تكوين إضافي.

// build.gradle (الوحدة: التطبيق)
plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}

android {
    defaultConfig { minSdkVersion 24 }
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0')
    implementation 'com.google.firebase:firebase-appindexing'
}

Android App Links والتحقق

Android App Links هي روابط HTTP/HTTPS يتحقق Google من أنها تابعة لتطبيقك. يتم التحقق من خلال Digital Asset Links: يتم تحميل ملف assetlinks.json على موقع الويب الخاص بك. بعد التحقق، يقوم Android تلقائياً بمعالجة جميع الروابط من نطاقك كـ App Links، دون أن يطلب من المستخدم أي تطبيق لفتح الرابط فيه. هذا شرط ضروري لفهرسة محتوى التطبيق بشكل صحيح.

التحقق من الفهرسة

بعد التكوين، تحتاج إلى التحقق من أن محتوى التطبيق يتم فهرسته فعلياً. Firebase Console في قسم App Indexing يعرض إحصائيات: عدد URIs المفهرسة، عدد مرات الظهور في البحث والنقرات. للتحقق التفصيلي، استخدم Google Search Console، حيث يتم عرض أخطاء الفهرسة والتوصيات. يمكنك أيضاً البحث عن site:https://your-app.page.link في Google لرؤية الصفحات المفهرسة للتطبيق.

أفضل ممارسات الفهرسة

الفهرسة الفعالة للتطبيق تتطلب اتباع عدة ممارسات رئيسية. يجب أن تؤدي جميع URIs التي تريد فهرستها إلى محتوى حقيقي — لا عناصر نائبة أو شاشات فارغة أو صفحات خطأ. يوصى بفهرسة المحتوى العام فقط وعدم فهرسة الصفحات التي تتطلب مصادقة. يجب أن يكون لكل URI اسم ووصف قابلين للقراءة بلغة المستخدم.

ما يجب فهرسته

قم بفهرسة المحتوى الذي يبحث عنه المستخدمون في Google: بطاقات المنتجات والمقالات والملفات الشخصية وفئات القوائم والوصفات والأحداث. لا تقم بفهرسة الصفحات التي تحتوي على بيانات شخصية أو إعدادات أو سلة التسوق أو سجل الطلبات أو أي بيانات خاصة أخرى. للمحتوى الديناميكي (خلاصة الأخبار، التحديدات المخصصة)، استخدم Firebase App Indexing API لإضافة URIs جديدة عند إنشائها وإزالتها عند حذفها.

تحسين البحث

يجب أن يكون لكل URI مفهرس عنوان ووصف وصورة معاينة ذات معنى لنتائج البحث. استخدم الكلمات المفتاحية في العنوان والوصف التي تتطابق مع استعلامات البحث الحقيقية للمستخدمين. للصور، استخدم التنسيق المربع 1200x1200 بكسل وتأكد من أنها متاحة عبر عناوين URL عامة. قم بتحديث المحتوى بانتظام: يعرض Google الصفحات الجديدة في كثير من الأحيان في البحث.