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 (Android 6.0+ میں تصدیق شدہ HTTP اسکیمیں)، Firebase App Indexing API (پروگراماتی اشاریہ اپ ڈیٹ)، اور ایپ انسٹال والے آلات پر Google Play Services کے ذریعے خودکار فہرست سازی۔ ہر ذریعہ مجموعی اشاریہ کو مکمل کرتا ہے، ایپ کے مواد کو تلاش کے لیے زیادہ سے زیادہ قابل رسائی بناتا ہے۔

Google Play Services کے ذریعے خودکار فہرست سازی

Google Play Services Android پر انسٹال کردہ ایپس کے مواد کو خود بخود فہرست بناتا ہے اگر ایپ درست URI اسکیمیں اور intent-filter استعمال کرتی ہے۔ طریقہ کار VIEW ایکشن کے لیے intent-filter کی ایپ اسکین کرتا ہے اور ایپ میں استعمال کردہ URI جمع کرتا ہے۔ یہ عمل مکمل طور پر خودکار ہے اور ڈویلپر کی طرف سے کسی اضافی کوڈ کی ضرورت نہیں ہے — صرف مینی فیسٹ میں گہرے لنکس کو درست طریقے سے ترتیب دیں۔

کون سے URI خود بخود فہرست بند ہوتے ہیں

Google خود بخود ان URI کو فہرست بناتا ہے جو مخصوص معیار پر پورا اترتے ہیں: URI VIEW ایکشن کے ساتھ intent-filter کے ذریعے قابل رسائی ہونا چاہیے، Android App Links کے لیے اسکیم HTTP/HTTPS ہونی چاہیے۔ اپنی مرضی کی اسکیموں والے URI (myapp://) بھی فہرست بند ہوتے ہیں، لیکن صرف اس وقت جب ایپ انسٹال ہو۔ خودکار فہرست سازی ان URI پر لاگو نہیں ہوتی جو تصدیقی صفحات یا صارف کے ذاتی ڈیٹا کی طرف لے جاتے ہیں۔

خودکار فہرست سازی کی حدود

خودکار فہرست سازی کی کئی حدود ہیں: اشاریہ فوری طور پر اپ ڈیٹ نہیں ہوتا بلکہ کئی گھنٹوں سے دنوں کی تاخیر سے اپ ڈیٹ ہوتا ہے۔ ایپ API کی سطح — خودکار فہرست سازی کے لیے minSdkVersion 23 یا اس سے اوپر درکار ہے۔ HTTP/HTTPS اسکیم کے بغیر URI صرف ایپ انسٹال والے آلات پر فہرست بند ہوتے ہیں۔ فہرست سازی کو تیز کرنے اور ویب کے بغیر مواد شامل کرنے کے لیے، Firebase App Indexing API استعمال کرنے کی سفارش کی جاتی ہے۔

Firebase App Indexing API

Firebase App Indexing API ایک Google HTTP API ہے جو ڈویلپر کو پروگراماتی طور پر ایپ کے فہرست شدہ مواد کو منظم کرنے کی اجازت دیتی ہے۔ API Google اشاریہ میں URI صفحات کو شامل کرنے، اپ ڈیٹ کرنے اور ہٹانے کی درخواستیں قبول کرتا ہے۔ خودکار فہرست سازی کے برعکس، API فوری کام کرتا ہے: کال کرنے کے بعد، Google منٹوں میں تلاش کے نتائج میں نئے URI پر غور کرنا شروع کر دیتا ہے۔

Firebase App Indexing API کی درخواست کی شکل

Firebase App Indexing API کو درخواست میں ایک صفحہ آبجیکٹ ہوتا ہے جس میں اس کا URI، عنوان، تفصیل اور اختیاری تصاویر ہوتی ہیں۔ ہر URI کو ایک علیحدہ صفحہ کے طور پر پروسیس کیا جاتا ہے جو Google تلاش کے ذریعے پایا جا سکتا ہے۔ API Firebase سروس اکاؤنٹ کے ذریعے OAuth 2.0 تصدیق استعمال کرتا ہے۔ URI کے بڑے پیمانے پر اضافے کے لیے، ایک درخواست میں 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);
    }
}

مواد کو اپ ڈیٹ اور ہٹانا

جب ایپ کا مواد بدلتا ہے، Firebase App Indexing API کے ذریعے Google اشاریہ کو اپ ڈیٹ کرنا ضروری ہے۔ پرانے مواد کو ہٹانا بھی اہم ہے: اگر URI مزید موجود نہیں ہے یا 404 کی طرف لے جاتا ہے، تو اسے اشاریہ سے ہٹا دینا چاہیے۔ Firebase App Indexing ایپ میں تبدیل ہونے پر خود بخود مواد نہیں ہٹاتا — ڈویلپر موجودہ مواد کی حالت کے ساتھ اشاریہ کو ہم آہنگ کرنے کا ذمہ دار ہے۔ ہر ڈیٹا تبدیلی پر API کو کال کرنے کی سفارش کی جاتی ہے: مصنوعات، مضامین، پروفائلز کو شامل کرنا، ترمیم کرنا یا حذف کرنا۔

Android میں App Indexing کی ترتیب

Android میں Firebase App Indexing کی ترتیب میں کئی مراحل شامل ہیں: Firebase SDK شامل کرنا، build.gradle میں app-indexing انحصاریاں شامل کرنا، Android App Links ترتیب دینا اور URI کو ہینڈل کرنے کے لیے ایک سروس بنانا۔ Firebase App Indexing کے لیے کم از کم API ورژن 23 ہے۔ SDK ترتیب کے بعد، ایپ خود بخود Google Play Services کے ذریعے Google کو فہرست سازی کے لیے ڈیٹا بھیجنا شروع کر دیتی ہے۔

انحصاریاں اور ترتیب شامل کرنا

Firebase App Indexing کے لیے، آپ کو ایپ ماڈیول کی build.gradle میں com.google.firebase:firebase-appindexing انحصاری اور google-services پلگ ان شامل کرنا ہوگا۔ Firebase خود بخود Google Play Services کے ذریعے فہرست سازی کے ڈیٹا کو پروسیس کرتا ہے اگر ایپ ضروریات پوری کرتی ہے: minSdkVersion 23+، HTTP/HTTPS اسکیموں کے ساتھ intent-filter کی موجودگی اور تصدیق کے لیے Android App Links کا استعمال۔ اپنی مرضی کی اسکیموں والے URI کے لیے، اضافی ترتیب درکار ہے۔

// build.gradle (ماڈیول: app)
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 سیکشن میں اعدادوشمار دکھائے جاتے ہیں: فہرست شدہ URI کی تعداد، تلاش میں نمائشوں اور کلکس کی تعداد۔ تفصیلی تصدیق کے لیے، Google Search Console استعمال کریں، جو فہرست سازی کی غلطیاں اور سفارشات دکھاتا ہے۔ آپ Google میں site:https://your-app.page.link تلاش کرکے بھی ایپ کے فہرست شدہ صفحات دیکھ سکتے ہیں۔

فہرست سازی کے بہترین طریقے

مؤثر ایپ فہرست سازی کے لیے کئی اہم طریقوں پر عمل کرنا ضروری ہے۔ تمام URI جو آپ فہرست بنانا چاہتے ہیں حقیقی مواد تک لے جانے چاہئیں — کوئی پلیس ہولڈر، خالی اسکرین یا غلطی کے صفحات نہیں۔ صرف عوامی مواد کو فہرست بنانے اور تصدیق کی ضرورت والے صفحات کو فہرست نہ بنانے کی سفارش کی جاتی ہے۔ ہر URI کا صارف کی زبان میں پڑھنے کے قابل نام اور تفصیل ہونا چاہیے۔

کیا فہرست بنائیں

وہ مواد فہرست بنائیں جو صارفین Google میں تلاش کرتے ہیں: مصنوعات کے کارڈ، مضامین، پروفائلز، مینو کے زمرے، ترکیبیں، تقریبات۔ ذاتی ڈیٹا، ترتیبات، شاپنگ کارٹ، آرڈر کی تاریخ یا کسی دوسرے نجی ڈیٹا والے صفحات کو فہرست نہ بنائیں۔ متحرک مواد (خبروں کی فیڈ، ذاتی نوعیت کے انتخاب) کے لیے، Firebase App Indexing API کا استعمال کرتے ہوئے نئے URI شامل کریں جب وہ بنائے جائیں اور حذف ہونے پر ہٹا دیں۔

تلاش کی اصلاح

فہرست شدہ ہر URI میں تلاش کے نتائج کے لیے ایک بامعنی عنوان، تفصیل اور پیش نظارہ تصویر ہونی چاہیے۔ عنوان اور تفصیل میں مطلوبہ الفاظ استعمال کریں جو حقیقی صارف کی تلاش کے سوالات سے مماثل ہوں۔ تصاویر کے لیے، 1200x1200 px مربع فارمیٹ استعمال کریں اور یقینی بنائیں کہ وہ عوامی URL کے ذریعے قابل رسائی ہیں۔ مواد کو باقاعدگی سے اپ ڈیٹ کریں: Google تلاش میں تازہ صفحات زیادہ کثرت سے دکھاتا ہے۔