Firebase App Indexing — esența indexării conținutului aplicațiilor și principiul de funcționare

Ce este Firebase App Indexing

Firebase App Indexing este o tehnologie Google care face conținutul aplicației mobile accesibil pentru robotul de căutare Google, permițând indexarea ecranelor aplicației la fel cum Google indexează paginile web. Când conținutul aplicației este indexat, utilizatorul îl poate găsi în Google Search, Google Assistant sau Google Lens și poate trece direct la ecranul dorit al aplicației cu un singur click, ocolind pagina web.

Principiul indexării conținutului mobil

Google indexează aplicațiile prin două mecanisme: indexarea automată și Firebase App Indexing API. Indexarea automată funcționează pe Android prin Google Play Services: dacă aplicația este instalată, Google indexează automat conținutul la care există linkuri profunde. Indexarea prin API permite programatorului să gestioneze programatic ce conținut este vizibil în căutare, folosind Firebase App Indexing API pentru actualizarea sau ștergerea paginilor indexate.

De ce este necesară indexarea aplicațiilor

Indexarea aplicației rezolvă mai multe sarcini: atragerea de noi utilizatori din căutarea Google (rezultatele căutării arată conținutul din aplicație în carduri). Creșterea implicării — utilizatorii existenți găsesc mai rapid conținutul dorit prin căutarea pe dispozitiv. Creșterea instalărilor — căutarea Google afișează linkuri profunde către conținut, iar dacă aplicația nu este instalată, Google afișează un link de instalare. App Indexing îmbunătățește, de asemenea, vizibilitatea aplicației în Google Assistant, care poate sugera deschiderea aplicației la căutarea vocală.

Cum funcționează indexarea conținutului aplicațiilor

Procesul de indexare începe când Google descoperă schemele URI ale aplicației tale. Pentru Android, Google folosește informațiile din Google Play Store (nivel API, intent-filter, scheme URI) pentru a construi harta aplicației. Pentru iOS, indexarea se realizează prin Spotlight Integration și CSSearchableIndex. Când Google indexează conținutul aplicației, leagă URI (de exemplu, myapp://product/123) de URL-ul web, dacă există, și salvează această pereche în indexul de căutare.

Legarea aplicației și a site-ului web

Pentru o indexare corectă, Google trebuie să înțeleagă legătura dintre aplicația ta și site-ul web. Digital Asset Links este un fișier JSON care se încarcă pe site-ul tău și confirmă că aplicația mobilă aparține proprietarului site-ului. Fișierul assetlinks.json se plasează în rădăcina domeniului și conține amprenta SHA256 a certificatului de semnare a aplicației. Google verifică această legătură înainte de a afișa butonul de deschidere a aplicației în rezultatele căutării.

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

Surse de indexare

Google obține conținut pentru indexare din mai multe surse: Google Play Store (lista aplicațiilor publicate cu schemele lor URI), Android App Links (scheme HTTP verificate în Android 6.0+), Firebase App Indexing API (actualizarea programatică a indexului) și indexarea automată prin Google Play Services pe dispozitivele cu aplicația instalată. Fiecare sursă completează indexul general, făcând conținutul aplicației cât mai accesibil pentru căutare.

Indexarea automată prin Google Play Services

Google Play Services indexează automat conținutul aplicațiilor instalate pe Android, dacă aplicația folosește scheme URI și intent-filter corecte. Mecanismul scanează aplicația pentru intent-filter pentru acțiunea VIEW și colectează URI-urile utilizate în aplicație. Acest proces este complet automat și nu necesită cod suplimentar din partea programatorului — este suficient să configurezi corect deep links în manifest.

Care URI sunt indexate automat

Google indexează automat URI-urile care îndeplinesc anumite criterii: URI-ul trebuie să fie accesibil prin intent-filter cu acțiunea VIEW, schema trebuie să fie HTTP/HTTPS pentru Android App Links. URI-urile cu scheme personalizate (myapp://) sunt, de asemenea, indexate, dar numai cu aplicația instalată. Indexarea automată nu se aplică URI-urilor care duc la pagini care necesită autentificare sau care conțin date personale ale utilizatorului.

Limitări ale indexării automate

Indexarea automată are câteva limitări: indexul nu se actualizează instantaneu, ci cu o întârziere de la câteva ore până la zile. Nivelul API al aplicației — pentru indexarea automată este necesar minSdkVersion 23 sau mai mare. URI-urile fără schemă HTTP/HTTPS sunt indexate numai pe dispozitivele cu aplicația instalată. Pentru accelerarea indexării și adăugarea de conținut fără echivalent web, se recomandă utilizarea Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API este API-ul HTTP Google care permite programatorului să gestioneze programatic conținutul indexat al aplicației. API-ul primește cereri de adăugare, actualizare și ștergere a paginilor URI în indexul Google. Spre deosebire de indexarea automată, API-ul funcționează instantaneu: după apel, Google începe să ia în considerare noile URI în rezultatele căutării în câteva minute.

Formatul cererii Firebase App Indexing API

O cerere către Firebase App Indexing API conține un obiect pagină cu URI-ul său, titlul, descrierea și imagini opționale. Fiecare URI este procesat ca o pagină separată care poate fi găsită prin căutarea Google. API-ul utilizează autentificarea OAuth 2.0 prin Firebase Service Account. Pentru adăugarea în masă a URI-urilor, este suportată procesarea în loturi de până la 1000 de pagini într-o singură cerere.

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("Preț: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("Index", "OK"))
            .addOnFailureListener(e ->
                Log.e("Index", "Eroare", e));
    }

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

Actualizarea și ștergerea conținutului

Când conținutul din aplicație se modifică, este necesar să actualizezi indexul Google prin Firebase App Indexing API. Ștergerea conținutului învechit este, de asemenea, importantă: dacă URI-ul nu mai există sau duce la o eroare 404, trebuie șters din index. Firebase App Indexing nu șterge conținutul automat la modificarea lui în aplicație — programatorul este responsabil pentru sincronizarea indexului cu starea actuală a conținutului. Se recomandă apelarea API-ului la fiecare modificare a datelor: adăugarea, editarea sau ștergerea produselor, articolelor, profilurilor.

Configurarea App Indexing în Android

Configurarea Firebase App Indexing în Android include câțiva pași: conectarea Firebase SDK, adăugarea dependențelor app-indexing în build.gradle, configurarea Android App Links și crearea unui serviciu pentru procesarea URI-urilor. Versiunea minimă API pentru funcționarea Firebase App Indexing — 23. După configurarea SDK-ului, aplicația începe automat să trimită date pentru indexare către Google prin Google Play Services.

Adăugarea dependențelor și configurarea

Pentru Firebase App Indexing trebuie adăugată în build.gradle a modulului aplicației dependența com.google.firebase:firebase-appindexing și plugin-ul google-services. Firebase procesează automat datele de indexare prin Google Play Services, dacă aplicația îndeplinește cerințele: minSdkVersion 23+, prezența intent-filter cu scheme HTTP/HTTPS și utilizarea Android App Links pentru verificare. Pentru URI-urile cu scheme personalizate este necesară o configurare suplimentară.

// 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 și verificarea

Android App Links sunt linkuri HTTP/HTTPS pe care Google le verifică ca aparținând aplicației tale. Verificarea se realizează prin Digital Asset Links: fișierul assetlinks.json se încarcă pe site-ul tău web. După verificare, Android procesează automat toate linkurile din domeniul tău ca App Links, fără a întreba utilizatorul în ce aplicație să deschidă linkul. Aceasta este o condiție necesară pentru indexarea corectă a conținutului aplicației.

Verificarea indexării

După configurare, trebuie verificat dacă conținutul aplicației este într-adevăr indexat. Firebase Console în secțiunea App Indexing afișează statistici: numărul de URI indexate, numărul de afișări în căutare și clickuri. Pentru o verificare detaliată, folosește Search Console Google, unde sunt afișate erorile de indexare și recomandările. De asemenea, poți efectua o căutare după site:https://your-app.page.link în Google pentru a vedea paginile indexate ale aplicației.

Cele mai bune practici de indexare

Indexarea eficientă a aplicației necesită respectarea câtorva practici cheie. Toate URI-urile pe care dorești să le indexezi trebuie să ducă la conținut real — fără pagini placeholder, ecrane goale sau pagini de eroare. Se recomandă indexarea numai a conținutului public și neindexarea paginilor care necesită autentificare. Fiecare URI trebuie să aibă un nume și o descriere lizibile în limba utilizatorului.

Ce să indexezi

Indexează conținutul pe care utilizatorii îl caută în Google: carduri de produse, articole, profiluri, categorii de meniu, rețete, evenimente. Nu indexa paginile cu date personale, setări, coșul de cumpărături, istoricul comenzilor sau orice alte date private. Pentru conținut dinamic (flux de știri, selecții personalizate) folosește Firebase App Indexing API pentru a adăuga noi URI pe măsură ce sunt create și a le șterge la eliminare.

Optimizarea pentru căutare

Fiecare URI indexat trebuie să aibă un titlu semnificativ, o descriere și o imagine pentru previzualizare în rezultatele căutării. Folosește cuvinte cheie în titlu și descriere, corespunzând cererilor reale de căutare ale utilizatorilor. Pentru imagini, folosește formatul pătrat 1200x1200 px și asigură-te că sunt accesibile prin URL-uri publice. Actualizează regulat conținutul: Google afișează mai frecvent în căutare paginile proaspete.