Firebase App Indexing — tətbiq məzmununun indeksasiyası mahiyyəti və iş prinsipi

Firebase App Indexing nədir

Firebase App Indexing — bu Google texnologiyasıdır, mobil tətbiqin məzmununu Google axtarış robotu üçün əlçatan edir, tətbiq ekranlarını Google-un veb-səhifələri indekslədiyi kimi indeksləşdirməyə imkan verir. Tətbiq məzmunu indeksləşdirildikdə, istifadəçi onu Google Search, Google Assistant və ya Google Lens-də tapa bilər və veb-səhifəni yan keçərək bir kliklə birbaşa tətbiqin lazımi ekranına keçə bilər.

Mobil məzmunun indeksasiya prinsipi

Google tətbiqləri iki mexanizm vasitəsilə indeksləyir: avtomatik indeksasiya və Firebase App Indexing API. Avtomatik indeksasiya Android-də Google Play Services vasitəsilə işləyir: əgər tətbiq quraşdırılıbsa, Google dərin keçidləri olan məzmunu avtomatik indeksləyir. API indeksasiyası proqramçıya Firebase App Indexing API-dən istifadə edərək indeksləşdirilmiş səhifələri yeniləmək və ya silmək üçün axtarışda hansı məzmunun göründüyünü proqramlı şəkildə idarə etməyə imkan verir.

Tətbiq indeksasiyası nə üçün lazımdır

Tətbiq indeksasiyası bir neçə vəzifəni həll edir: Google axtarışından yeni istifadəçilərin cəlb edilməsi (axtarış nəticələri tətbiqdən məzmunu kartlarda göstərir). İstifadəçi aktivliyinin artırılması — mövcud istifadəçilər cihazda axtarış vasitəsilə lazımi məzmunu daha tez tapırlar. Quraşdırmaların artırılması — Google axtarışı məzmun dərin keçidlərini göstərir və əgər tətbiq quraşdırılmayıbsa, Google quraşdırma keçidini göstərir. App Indexing həmçinin tətbiqin Google Assistant-da görünməsini yaxşılaşdırır, o səsli axtarış zamanı tətbiqi açmağı təklif edə bilər.

Tətbiq məzmununun indeksasiyası necə işləyir

İndeksasiya prosesi Google-un tətbiqinizin URI sxemlərini aşkar etməsi ilə başlayır. Android üçün Google tətbiqin xəritəsini qurmaq üçün Google Play Store məlumatlarından (API səviyyəsi, intent-filter, URI sxemləri) istifadə edir. iOS üçün indeksasiya Spotlight Integration və CSSearchableIndex vasitəsilə həyata keçirilir. Google tətbiq məzmununu indeksləşdirdikdə, URI-ni (məsələn, myapp://product/123) veb-URL ilə əlaqələndirir (əgər mövcuddursa) və bu cütü axtarış indeksində saxlayır.

Tətbiq və veb-saytın əlaqələndirilməsi

Düzgün indeksasiya üçün Google tətbiqiniz və veb-saytınız arasındakı əlaqəni başa düşməlidir. Digital Asset Links — bu veb-saytınıza yüklənən və mobil tətbiqin sayt sahibinə aid olduğunu təsdiqləyən JSON faylıdır. assetlinks.json faylı domenin kök qovluğunda yerləşdirilir və tətbiq imza sertifikatının SHA256 barmaq izini ehtiva edir. Google axtarış nəticələrində tətbiq açma düyməsini göstərməzdən əvvəl bu əlaqəni yoxlayır.

// 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:..."
            ]
        }
    }
]

İndeksasiya mənbələri

Google indeksasiya üçün məzmunu bir neçə mənbədən alır: Google Play Store (URI sxemləri ilə dərc edilmiş tətbiqlərin siyahısı), Android App Links (Android 6.0+-da təsdiqlənmiş HTTP sxemləri), Firebase App Indexing API (indeksin proqramlı yenilənməsi) və quraşdırılmış tətbiqi olan cihazlarda Google Play Services vasitəsilə avtomatik indeksasiya. Hər bir mənbə ümumi indeksi tamamlayaraq tətbiq məzmununu axtarış üçün maksimum dərəcədə əlçatan edir.

Google Play Services vasitəsilə avtomatik indeksasiya

Google Play Services Android-də quraşdırılmış tətbiqlərin məzmununu avtomatik indeksləyir, əgər tətbiq düzgün URI sxemləri və intent-filter istifadə edirsə. Mexanizm tətbiqi VIEW əməliyyatı üçün intent-filterlər üçün skan edir və tətbiqdə istifadə olunan URI-ləri toplayır. Bu proses tamamilə avtomatikdir və proqramçı tərəfindən əlavə kod tələb etmir — sadəcə manifestdə deep links-i düzgün konfiqurasiya etmək kifayətdir.

Hansı URI-lər avtomatik indeksləşir

Google müəyyən kriteriyalara cavab verən URI-ləri avtomatik indeksləyir: URI VIEW əməliyyatı ilə intent-filter vasitəsilə əlçatan olmalıdır, sxem Android App Links üçün HTTP/HTTPS olmalıdır. Xüsusi sxemli URI-lər (myapp://) də indeksləşir, ancaq tətbiq quraşdırıldıqda. Avtomatik indeksasiya avtorizasiya tələb edən və ya istifadəçinin şəxsi məlumatlarını ehtiva edən səhifələrə aparan URI-lərə şamil edilmir.

Avtomatik indeksasiyanın məhdudiyyətləri

Avtomatik indeksasiyanın bir neçə məhdudiyyəti var: indeks dərhal deyil, bir neçə saatdan günlərə qədər gecikmə ilə yenilənir. Tətbiqin API səviyyəsi — avtomatik indeksasiya üçün minSdkVersion 23 və ya daha yüksək tələb olunur. HTTP/HTTPS sxemi olmayan URI-lər yalnız tətbiq quraşdırılmış cihazlarda indeksləşir. İndeksasiyanı sürətləndirmək və veb-analoqu olmayan məzmun əlavə etmək üçün Firebase App Indexing API-dən istifadə etmək tövsiyə olunur.

Firebase App Indexing API

Firebase App Indexing API — bu Google-un HTTP API-sidir, proqramçıya tətbiqin indeksləşdirilmiş məzmununu proqramlı şəkildə idarə etməyə imkan verir. API Google indeksinə URI-səhifələrinin əlavə edilməsi, yenilənməsi və silinməsi üçün sorğular qəbul edir. Avtomatik indeksasiyadan fərqli olaraq, API dərhal işləyir: çağırışdan sonra Google bir neçə dəqiqə ərzində yeni URI-ləri axtarış nəticələrində nəzərə almağa başlayır.

Firebase App Indexing API sorğu formatı

Firebase App Indexing API-yə sorğu URI-si, başlığı, təsviri və isteğe bağlı şəkilləri olan səhifə obyektini ehtiva edir. Hər bir URI Google axtarışı vasitəsilə tapıla bilən ayrıca səhifə kimi işlənir. API Firebase Service Account vasitəsilə OAuth 2.0 autentifikasiyasından istifadə edir. Kütləvi URI əlavə etmək üçün bir sorğuda 1000 səhifəyə qədər paket emalı dəstəklənir.

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("Qiymət: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("İndeks", "OK"))
            .addOnFailureListener(e ->
                Log.e("İndeks", "Xəta", e));
    }

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

Məzmunun yenilənməsi və silinməsi

Tətbiqdə məzmun dəyişdikdə, Firebase App Indexing API vasitəsilə Google indeksini yeniləmək lazımdır. Köhnəlmiş məzmunun silinməsi də vacibdir: əgər URI artıq mövcud deyilsə və ya 404-ə aparırsa, onu indeksdən silmək lazımdır. Firebase App Indexing tətbiqdə məzmun dəyişdikdə onu avtomatik silmir — proqramçı indeksin məzmunun cari vəziyyəti ilə sinxronizasiyasına cavabdehdir. Məlumatların hər dəyişməsində API-ni çağırmaq tövsiyə olunur: məhsulların, məqalələrin, profillərin əlavə edilməsi, redaktəsi və ya silinməsi.

Android-də App Indexing qurulumu

Android-də Firebase App Indexing qurulumu bir neçə addımı əhatə edir: Firebase SDK-nın qoşulması, build.gradle-da app-indexing asılılıqlarının əlavə edilməsi, Android App Links-in konfiqurasiyası və URI-lərin işlənməsi üçün xidmətin yaradılması. Firebase App Indexing-in işləməsi üçün minimal API versiyası — 23. SDK konfiqurasiya edildikdən sonra tətbiq avtomatik olaraq Google Play Services vasitəsilə Google-a indeksasiya üçün məlumat göndərməyə başlayır.

Asılılıqların əlavə edilməsi və konfiqurasiya

Firebase App Indexing üçün tətbiq modulunun build.gradle faylına com.google.firebase:firebase-appindexing asılılığı və google-services plaginini əlavə etmək lazımdır. Firebase avtomatik Google Play Services vasitəsilə indeksasiya məlumatlarını emal edir, əgər tətbiq tələblərə cavab verirsə: minSdkVersion 23+, HTTP/HTTPS sxemləri ilə intent-filter-in olması və təsdiqləmə üçün Android App Links-in istifadəsi. Xüsusi sxemli URI-lər üçün əlavə konfiqurasiya tələb olunur.

// build.gradle (Modul: 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 və təsdiqləmə

Android App Links — bunlar Google-un tətbiqinizə aid olduğunu təsdiqlədiyi HTTP/HTTPS keçidləridir. Təsdiqləmə Digital Asset Links vasitəsilə həyata keçirilir: assetlinks.json faylı veb-saytınıza yüklənir. Təsdiqləmədən sonra Android avtomatik olaraq domeninizdən bütün keçidləri App Links kimi emal edir, istifadəçidən keçidi hansı tətbiqdə açmağı soruşmadan. Bu tətbiq məzmununun düzgün indeksasiyası üçün zəruri şərtdir.

İndeksasiyanın yoxlanılması

Konfiqurasiyadan sonra tətbiq məzmununun həqiqətən indeksləşdiyini yoxlamaq lazımdır. Firebase Console-un App Indexing bölməsində statistika göstərilir: indeksləşdirilmiş URI-lərin sayı, axtarışda göstərilmə sayı və kliklər. Ətraflı yoxlama üçün Search Console Google-dan istifadə edin, orada indeksasiya xətaları və tövsiyələr göstərilir. Həmçinin Google-da site:https://your-app.page.link sorğusu ilə axtarış edərək tətbiqin indeksləşdirilmiş səhifələrini görə bilərsiniz.

İndeksasiyanın ən yaxşı təcrübələri

Effektiv indeksasiya tətbiq bir neçə əsas təcrübəyə riayət etməyi tələb edir. İndeksləmək istədiyiniz bütün URI-lər real məzmuna aparmalıdır — heç bir saxta səhifə, boş ekran və ya xəta səhifəsi olmamalıdır. Yalnız ictimai məzmunu indeksləmək və avtorizasiya tələb edən səhifələri indeksləməmək tövsiyə olunur. Hər bir URI istifadəçinin dilində oxunaqlı ad və təsvirə malik olmalıdır.

Nəyi indeksləmək

İstifadəçilərin Google-da axtardığı məzmunu indeksləyin: məhsul kartları, məqalələr, profillər, menyu kateqoriyaları, reseptlər, tədbirlər. İndeksləməyin şəxsi məlumatları olan səhifələri, parametrləri, səbəti, sifariş tarixçəsini və ya hər hansı digər məxfi məlumatları. Dinamik məzmun üçün (xəbər lenti, fərdiləşdirilmiş seçimlər) yeni URI-lər yaradıldıqca əlavə etmək və silindikdə silmək üçün Firebase App Indexing API-dən istifadə edin.

Axtarış üçün optimallaşdırma

Hər bir indeksləşdirilən URI axtarış nəticələrində önizləmə üçün mənalı başlığa, təsvirə və şəkilə malik olmalıdır. Açar sözlərdən istifadə edin başlıq və təsvirdə, istifadəçilərin real axtarış sorğularına uyğun. Şəkillər üçün kvadrat format 1200x1200 px istifadə edin və onların ictimai URL-lər vasitəsilə əlçatan olduğundan əmin olun. Məzmunu mütəmadi yeniləyin: Google axtarışda təzə səhifələri daha tez-tez göstərir.