Firebase App Indexing — podstata indexace obsahu aplikací a princip fungování

Co je Firebase App Indexing

Firebase App Indexing je technologie Google, která zpřístupňuje obsah mobilní aplikace vyhledávacímu robotu Google a umožňuje indexovat obrazovky aplikace stejně, jako Google indexuje webové stránky. Když je obsah aplikace indexován, uživatel jej může najít v Google Search, Google Assistant nebo Google Lens a přejít přímo na požadovanou obrazovku aplikace jedním kliknutím, aniž by musel procházet webovou stránku.

Princip indexace mobilního obsahu

Google indexuje aplikace prostřednictvím dvou mechanismů: automatická indexace a Firebase App Indexing API. Automatická indexace funguje na Androidu přes Google Play Services: pokud je aplikace nainstalována, Google automaticky indexuje obsah, na který vedou hluboké odkazy. Indexace přes API umožňuje vývojáři programově spravovat, který obsah je ve vyhledávání viditelný, pomocí Firebase App Indexing API pro aktualizaci nebo odstranění indexovaných stránek.

Proč je indexace aplikací potřebná

Indexace aplikace řeší několik úkolů: přilákání nových uživatelů z vyhledávání Google (výsledky vyhledávání zobrazují obsah z aplikace v kartách). Zvýšení zapojení — stávající uživatelé rychleji najdou požadovaný obsah pomocí vyhledávání na zařízení. Zvýšení instalací — vyhledávání Google zobrazuje hluboké odkazy na obsah, a pokud aplikace není nainstalována, Google zobrazí odkaz na instalaci. App Indexing také zlepšuje viditelnost aplikace v Google Assistant, který může při hlasovém vyhledávání navrhnout otevření aplikace.

Jak funguje indexace obsahu aplikací

Proces indexace začíná tím, že Google objeví URI schémata vaší aplikace. Pro Android Google používá informace z Google Play Store (úroveň API, intent-filter, URI schémata) k sestavení mapy aplikace. Pro iOS se indexace provádí přes Spotlight Integration a CSSearchableIndex. Když Google indexuje obsah aplikace, propojí URI (např. myapp://product/123) s webovou URL, pokud existuje, a uloží tento pár do vyhledávacího indexu.

Propojení aplikace a webu

Pro správnou indexaci musí Google rozumět vztahu mezi vaší aplikací a webem. Digital Asset Links je JSON soubor, který se nahrává na váš web a potvrzuje, že mobilní aplikace patří vlastníkovi webu. Soubor assetlinks.json je umístěn v kořenu domény a obsahuje SHA256 otisk certifikátu podpisu aplikace. Google toto propojení zkontroluje, než zobrazí tlačítko otevření aplikace ve výsledcích vyhledávání.

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

Zdroje indexace

Google získává obsah pro indexaci z několika zdrojů: Google Play Store (seznam publikovaných aplikací s jejich URI schématy), Android App Links (ověřená HTTP schémata v Android 6.0+), Firebase App Indexing API (programová aktualizace indexu) a automatická indexace přes Google Play Services na zařízeních s nainstalovanou aplikací. Každý zdroj doplňuje celkový index a činí obsah aplikace maximálně dostupným pro vyhledávání.

Automatická indexace přes Google Play Services

Google Play Services automaticky indexuje obsah nainstalovaných aplikací na Androidu, pokud aplikace používá správná URI schémata a intent-filter. Mechanismus skenuje aplikaci na intent-filter pro akci VIEW a shromažďuje URI používané v aplikaci. Tento proces je zcela automatický a nevyžaduje žádný další kód od vývojáře — stačí správně nastavit hluboké odkazy v manifestu.

Která URI se indexují automaticky

Google automaticky indexuje URI, která splňují určitá kritéria: URI musí být přístupné přes intent-filter s akcí VIEW, schéma musí být HTTP/HTTPS pro Android App Links. URI s vlastními schématy (myapp://) se také indexují, ale pouze s nainstalovanou aplikací. Automatická indexace se nevztahuje na URI, která vedou na stránky vyžadující autentizaci nebo obsahující osobní údaje uživatele.

Omezení automatické indexace

Automatická indexace má několik omezení: index se neaktualizuje okamžitě, ale se zpožděním od několika hodin až po dny. Úroveň API aplikace — pro automatickou indexaci je vyžadováno minSdkVersion 23 nebo vyšší. URI bez HTTP/HTTPS schématu se indexují pouze na zařízeních s nainstalovanou aplikací. Pro urychlení indexace a přidání obsahu bez webového ekvivalentu se doporučuje používat Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API je HTTP API Google, které umožňuje vývojáři programově spravovat indexovaný obsah aplikace. API přijímá požadavky na přidání, aktualizaci a odstranění URI stránek v indexu Google. Na rozdíl od automatické indexace API funguje okamžitě: po volání Google začne zohledňovat nová URI ve výsledcích vyhledávání během několika minut.

Formát požadavku Firebase App Indexing API

Požadavek na Firebase App Indexing API obsahuje objekt stránky s jejím URI, názvem, popisem a volitelnými obrázky. Každé URI je zpracováno jako samostatná stránka, kterou lze najít prostřednictvím vyhledávání Google. API používá autentizaci OAuth 2.0 přes Firebase Service Account. Pro hromadné přidávání URI je podporováno dávkové zpracování až 1000 stránek v jednom požadavku.

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

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

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

Aktualizace a odstranění obsahu

Když se obsah v aplikaci změní, je nutné aktualizovat index Google přes Firebase App Indexing API. Odstranění zastaralého obsahu je také důležité: pokud URI již neexistuje nebo vede na 404, je třeba jej z indexu odstranit. Firebase App Indexing neodstraňuje obsah automaticky při jeho změně v aplikaci — vývojář je odpovědný za synchronizaci indexu s aktuálním stavem obsahu. Doporučuje se volat API při každé změně dat: přidání, úpravě nebo odstranění produktů, článků, profilů.

Nastavení App Indexing v Android

Nastavení Firebase App Indexing v Android zahrnuje několik kroků: připojení Firebase SDK, přidání závislostí app-indexing do build.gradle, konfiguraci Android App Links a vytvoření služby pro zpracování URI. Minimální verze API pro fungování Firebase App Indexing — 23. Po konfiguraci SDK aplikace automaticky začne odesílat data pro indexaci do Google přes Google Play Services.

Přidání závislostí a konfigurace

Pro Firebase App Indexing je třeba do build.gradle modulu aplikace přidat závislost com.google.firebase:firebase-appindexing a plugin google-services. Firebase automaticky zpracovává data indexace přes Google Play Services, pokud aplikace splňuje požadavky: minSdkVersion 23+, přítomnost intent-filter s HTTP/HTTPS schématy a použití Android App Links pro ověření. Pro URI s vlastními schématy je vyžadována další konfigurace.

// 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 a ověření

Android App Links jsou HTTP/HTTPS odkazy, které Google ověřuje jako patřící vaší aplikaci. Ověření se provádí přes Digital Asset Links: soubor assetlinks.json se nahraje na váš web. Po ověření Android automaticky zpracovává všechny odkazy z vaší domény jako App Links, aniž by se uživatele ptal, ve které aplikaci odkaz otevřít. To je nezbytná podmínka pro správnou indexaci obsahu aplikace.

Kontrola indexace

Po konfiguraci je třeba zkontrolovat, zda je obsah aplikace skutečně indexován. Firebase Console v sekci App Indexing zobrazuje statistiky: počet indexovaných URI, počet zobrazení ve vyhledávání a kliknutí. Pro podrobnou kontrolu použijte Search Console Google, kde jsou zobrazeny chyby indexace a doporučení. Můžete také provést vyhledávání podle site:https://your-app.page.link v Google a zobrazit indexované stránky aplikace.

Nejlepší postupy indexace

Efektivní indexace aplikace vyžaduje dodržování několika klíčových postupů. Všechna URI, která chcete indexovat, musí vést na skutečný obsah — žádné zástupné stránky, prázdné obrazovky nebo chybové stránky. Doporučuje se indexovat pouze veřejný obsah a neindexovat stránky vyžadující autentizaci. Každé URI by mělo mít čitelný název a popis v jazyce uživatele.

Co indexovat

Indexujte obsah, který uživatelé hledají v Google: karty produktů, články, profily, kategorie menu, recepty, události. Neindexujte stránky s osobními údaji, nastavením, košíkem, historií objednávek nebo jinými soukromými daty. Pro dynamický obsah (zpravodajský kanál, personalizované výběry) použijte Firebase App Indexing API pro přidávání nových URI při jejich vytvoření a odstraňování při jejich odstranění.

Optimalizace pro vyhledávání

Každé indexované URI by mělo mít smysluplný název, popis a obrázek pro náhled ve výsledcích vyhledávání. Používejte klíčová slova v názvu a popisu, která odpovídají skutečným vyhledávacím dotazům uživatelů. Pro obrázky používejte čtvercový formát 1200x1200 px a ujistěte se, že jsou přístupné přes veřejná URL. Pravidelně aktualizujte obsah: Google častěji zobrazuje ve vyhledávání čerstvé stránky.