Firebase App Indexing — istota indeksowania treści aplikacji i zasada działania

Czym jest Firebase App Indexing

Firebase App Indexing — to technologia Google, która udostępnia treści aplikacji mobilnej robotowi wyszukiwarki Google, umożliwiając indeksowanie ekranów aplikacji tak, jak Google indeksuje strony internetowe. Gdy treści aplikacji są zaindeksowane, użytkownik może znaleźć je w Google Search, Google Assistant lub Google Lens i przejść bezpośrednio do odpowiedniego ekranu aplikacji jednym kliknięciem, omijając stronę internetową.

Zasada indeksowania treści mobilnych

Google indeksuje aplikacje przez dwa mechanizmy: automatyczne indeksowanie i Firebase App Indexing API. Automatyczne indeksowanie działa na Android przez Google Play Services: jeśli aplikacja jest zainstalowana, Google automatycznie indeksuje treści, do których prowadzą głębokie linki. Indeksowanie przez API pozwala programiście programowo zarządzać tym, jakie treści są widoczne w wyszukiwarce, używając Firebase App Indexing API do aktualizacji lub usuwania indeksowanych stron.

Po co potrzebne jest indeksowanie aplikacji

Indeksowanie aplikacji rozwiązuje kilka zadań: przyciąganie nowych użytkowników z wyszukiwarki Google (wyniki wyszukiwania pokazują treści z aplikacji w kartach). Zwiększanie zaangażowania — istniejący użytkownicy szybciej znajdują potrzebne treści przez wyszukiwanie na urządzeniu. Zwiększenie instalacji — wyszukiwarka Google pokazuje głębokie linki do treści, a jeśli aplikacja nie jest zainstalowana, Google wyświetla link do instalacji. App Indexing poprawia również widoczność aplikacji w Google Assistant, który może proponować otwarcie aplikacji przy wyszukiwaniu głosowym.

Jak działa indeksowanie treści aplikacji

Proces indeksowania rozpoczyna się od wykrycia przez Google schematów URI Twojej aplikacji. Dla Androida Google wykorzystuje informacje z Google Play Store (poziom API, intent-filter, schematy URI) do zbudowania mapy aplikacji. Dla iOS indeksowanie odbywa się przez Spotlight Integration i CSSearchableIndex. Gdy Google indeksuje treści aplikacji, wiąże URI (np. myapp://product/123) z adresem URL strony, jeśli istnieje, i zapisuje tę parę w indeksie wyszukiwania.

Łączenie aplikacji i strony internetowej

Do poprawnego indeksowania Google musi rozumieć związek między Twoją aplikacją a stroną internetową. Digital Asset Links — to plik JSON, który jest ładowany na Twoją stronę i potwierdza, że aplikacja mobilna należy do właściciela strony. Plik assetlinks.json umieszczany jest w katalogu głównym domeny i zawiera odcisk cyfrowy SHA256 certyfikatu podpisu aplikacji. Google sprawdza to połączenie, zanim pokaże przycisk otwarcia aplikacji w wynikach wyszukiwania.

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

Źródła indeksowania

Google pozyskuje treści do indeksowania z kilku źródeł: Google Play Store (lista opublikowanych aplikacji z ich schematami URI), Android App Links (zweryfikowane schematy HTTP w Android 6.0+), Firebase App Indexing API (programowa aktualizacja indeksu) i automatyczne indeksowanie przez Google Play Services na urządzeniach z zainstalowaną aplikacją. Każde źródło uzupełnia ogólny indeks, czyniąc treści aplikacji maksymalnie dostępnymi dla wyszukiwania.

Automatyczne indeksowanie przez Google Play Services

Google Play Services automatycznie indeksuje treści zainstalowanych aplikacji na Android, jeśli aplikacja używa poprawnych schematów URI i intent-filter. Mechanizm skanuje aplikację w poszukiwaniu intent-filter dla akcji VIEW i zbiera URI używane w aplikacji. Ten proces jest w pełni automatyczny i nie wymaga dodatkowego kodu ze strony programisty — wystarczy poprawnie skonfigurować deep links w manifeście.

Które URI są indeksowane automatycznie

Google automatycznie indeksuje URI, które spełniają określone kryteria: URI musi być dostępny przez intent-filter z akcją VIEW, schemat musi być HTTP/HTTPS dla Android App Links. URI z niestandardowymi schematami (myapp://) również są indeksowane, ale tylko przy zainstalowanej aplikacji. Automatyczne indeksowanie nie obejmuje URI, które prowadzą do stron wymagających autoryzacji lub zawierających dane osobowe użytkownika.

Ograniczenia automatycznego indeksowania

Automatyczne indeksowanie ma kilka ograniczeń: indeks aktualizuje się nie natychmiast, ale z opóźnieniem od kilku godzin do kilku dni. Poziom API aplikacji — do automatycznego indeksowania wymagane jest minSdkVersion 23 lub wyższe. URI bez schematu HTTP/HTTPS są indeksowane tylko na urządzeniach z zainstalowaną aplikacją. Aby przyspieszyć indeksowanie i dodać treści bez odpowiedników internetowych, zaleca się używanie Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API — to HTTP API Google, które pozwala programiście programowo zarządzać indeksowanymi treściami aplikacji. API przyjmuje zapytania o dodawanie, aktualizację i usuwanie stron URI w indeksie Google. W przeciwieństwie do automatycznego indeksowania, API działa natychmiastowo: po wywołaniu Google zaczyna uwzględniać nowe URI w wynikach wyszukiwania w ciągu kilku minut.

Format zapytania Firebase App Indexing API

Zapytanie do Firebase App Indexing API zawiera obiekt strony z jej URI, tytułem, opisem i opcjonalnymi obrazami. Każdy URI jest przetwarzany jako osobna strona, która może być znaleziona przez wyszukiwarkę Google. API używa autentykacji OAuth 2.0 przez Firebase Service Account. Do masowego dodawania URI obsługiwane jest przetwarzanie wsadowe do 1000 stron w jednym zapytaniu.

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("Indeks", "OK"))
            .addOnFailureListener(e ->
                Log.e("Indeks", "Błąd", e));
    }

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

Aktualizacja i usuwanie treści

Gdy treści w aplikacji się zmieniają, należy aktualizować indeks Google przez Firebase App Indexing API. Usuwanie nieaktualnych treści jest również ważne: jeśli URI już nie istnieje lub prowadzi do 404, należy go usunąć z indeksu. Firebase App Indexing nie usuwa treści automatycznie przy ich zmianie w aplikacji — programista odpowiada za synchronizację indeksu z aktualnym stanem treści. Zaleca się wywoływanie API przy każdej zmianie danych: dodawaniu, edytowaniu lub usuwaniu produktów, artykułów, profili.

Konfiguracja App Indexing w Android

Konfiguracja Firebase App Indexing w Android obejmuje kilka kroków: podłączenie Firebase SDK, dodanie zależności app-indexing w build.gradle, konfiguracja Android App Links i utworzenie serwisu do obsługi URI. Minimalna wersja API do działania Firebase App Indexing — 23. Po skonfigurowaniu SDK aplikacja automatycznie zaczyna wysyłać dane do indeksowania w Google przez Google Play Services.

Dodawanie zależności i konfiguracja

Do Firebase App Indexing należy dodać w build.gradle modułu aplikacji zależność com.google.firebase:firebase-appindexing oraz wtyczkę google-services. Firebase automatycznie przetwarza dane indeksowania przez Google Play Services, jeśli aplikacja spełnia wymagania: minSdkVersion 23+, obecność intent-filter ze schematami HTTP/HTTPS i używanie Android App Links do weryfikacji. Dla URI z niestandardowymi schematami wymagana jest dodatkowa konfiguracja.

// build.gradle (Moduł: 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 weryfikacja

Android App Links — to linki HTTP/HTTPS, które Google weryfikuje jako należące do Twojej aplikacji. Weryfikacja odbywa się przez Digital Asset Links: plik assetlinks.json jest ładowany na Twoją stronę internetową. Po weryfikacji Android automatycznie przetwarza wszystkie linki z Twojej domeny jako App Links, nie pytając użytkownika, w której aplikacji otworzyć link. Jest to niezbędny warunek poprawnego indeksowania treści aplikacji.

Sprawdzanie indeksowania

Po konfiguracji należy sprawdzić, czy treści aplikacji rzeczywiście są indeksowane. Firebase Console w sekcji App Indexing pokazuje statystyki: liczbę indeksowanych URI, liczbę wyświetleń w wyszukiwarce i kliknięć. Do szczegółowego sprawdzenia użyj Search Console Google, gdzie wyświetlane są błędy indeksowania i zalecenia. Można również wykonać wyszukiwanie według zapytania site:https://your-app.page.link w Google, aby zobaczyć zaindeksowane strony aplikacji.

Najlepsze praktyki indeksowania

Efektywne indeksowanie aplikacji wymaga przestrzegania kilku kluczowych praktyk. Wszystkie URI, które chcesz indeksować, muszą prowadzić do rzeczywistych treści — żadnych atrap, pustych ekranów ani stron z błędami. Zaleca się indeksowanie tylko publicznych treści i nieindeksowanie stron wymagających autoryzacji. Każdy URI powinien mieć czytelną nazwę i opis w języku użytkownika.

Co indeksować

Indeksuj treści, których użytkownicy szukają w Google: karty produktów, artykuły, profile, kategorie menu, przepisy, wydarzenia. Nie indeksuj stron z danymi osobowymi, ustawieniami, koszykiem, historią zamówień ani żadnymi innymi prywatnymi danymi. Dla dynamicznych treści (kanał newsów, spersonalizowane zestawienia) używaj Firebase App Indexing API do dodawania nowych URI w miarę ich tworzenia i usuwania przy ich usuwaniu.

Optymalizacja dla wyszukiwania

Każdy indeksowany URI powinien mieć znaczący tytuł, opis i obraz do podglądu w wynikach wyszukiwania. Używaj słów kluczowych w tytule i opisie, odpowiadających rzeczywistym zapytaniom użytkowników. Do obrazów używaj kwadratowego formatu 1200x1200 px i upewnij się, że są dostępne pod publicznymi URL. Regularnie aktualizuj treści: Google częściej pokazuje w wyszukiwarce świeże strony.