Firebase App Indexing — az alkalmazások tartalomindexelésének lényege és működési elve

Mi az a Firebase App Indexing

Firebase App Indexing egy Google-technológia, amely a mobilalkalmazás tartalmát elérhetővé teszi a Google keresőrobotja számára, lehetővé téve az alkalmazás képernyőinek indexelését ugyanúgy, ahogy a Google a weboldalakat indexeli. Amikor az alkalmazás tartalma indexelve van, a felhasználó megtalálhatja azt a Google Search-ben, Google Assistant-ban vagy Google Lens-ben, és egy kattintással közvetlenül az alkalmazás kívánt képernyőjére ugorhat, megkerülve a weboldalt.

A mobiltartalom indexelésének elve

A Google két mechanizmuson keresztül indexeli az alkalmazásokat: automatikus indexelés és Firebase App Indexing API. Automatikus indexelés Android rendszeren Google Play Services-en keresztül működik: ha az alkalmazás telepítve van, a Google automatikusan indexeli a tartalmat, amelyhez mélyhivatkozások vezetnek. Az API-indexelés lehetővé teszi a fejlesztő számára, hogy programozottan kezelje, mely tartalom látható a keresésben, a Firebase App Indexing API segítségével frissítve vagy törölve az indexelt oldalakat.

Miért szükséges az alkalmazások indexelése

Az alkalmazás indexelése több feladatot old meg: új felhasználók vonzása a Google keresésből (a keresési találatok kártyákban jelenítik meg az alkalmazás tartalmát). Elköteleződés növelése — a meglévő felhasználók gyorsabban megtalálják a kívánt tartalmat az eszközön történő kereséssel. Telepítések növelése — a Google keresés mélyhivatkozásokat jelenít meg a tartalomhoz, és ha az alkalmazás nincs telepítve, a Google telepítési hivatkozást mutat. Az App Indexing javítja az alkalmazás láthatóságát a Google Assistant-ban is, amely hangalapú kereséskor javasolhatja az alkalmazás megnyitását.

Hogyan működik az alkalmazások tartalomindexelése

Az indexelési folyamat azzal kezdődik, hogy a Google felfedezi az alkalmazás URI-sémáit. Android esetén a Google a Google Play Store információit (API-szint, intent-filter, URI-sémák) használja az alkalmazás térképének felépítéséhez. iOS esetén az indexelés a Spotlight Integration és a CSSearchableIndex segítségével történik. Amikor a Google indexeli az alkalmazás tartalmát, összekapcsol egy URI-t (pl. myapp://product/123) a webes URL-lel, ha létezik, és eltárolja ezt a párt a keresési indexben.

Az alkalmazás és a weboldal összekapcsolása

A helyes indexeléshez a Google-nak meg kell értenie az alkalmazás és a weboldal közötti kapcsolatot. Digital Asset Links egy JSON-fájl, amelyet a weboldalára töltenek fel, és megerősíti, hogy a mobilalkalmazás a weboldal tulajdonosáé. Az assetlinks.json fájl a domain gyökerében helyezkedik el, és tartalmazza az alkalmazás aláírási tanúsítványának SHA256 ujjlenyomatát. A Google ellenőrzi ezt a kapcsolatot, mielőtt megjelenítené az alkalmazás megnyitásához szükséges gombot a keresési találatokban.

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

Az indexelés forrásai

A Google több forrásból szerzi be a tartalmat az indexeléshez: Google Play Store (a közzétett alkalmazások listája URI-sémáikkal), Android App Links (hitelesített HTTP-sémák Android 6.0+ rendszerben), Firebase App Indexing API (az index programozott frissítése) és automatikus indexelés Google Play Services-en keresztül a telepített alkalmazással rendelkező eszközökön. Minden forrás kiegészíti az általános indexet, maximálisan elérhetővé téve az alkalmazás tartalmát a keresés számára.

Automatikus indexelés Google Play Services-en keresztül

Google Play Services automatikusan indexeli a telepített alkalmazások tartalmát Android rendszeren, ha az alkalmazás megfelelő URI-sémákat és intent-filter-t használ. A mechanizmus megvizsgálja az alkalmazást a VIEW művelethez tartozó intent-filter-ekre, és összegyűjti az alkalmazásban használt URI-kat. Ez a folyamat teljesen automatikus, és nem igényel további kódot a fejlesztőtől — elég a mélyhivatkozásokat helyesen beállítani a manifestben.

Mely URI-k indexelődnek automatikusan

A Google automatikusan indexeli azokat az URI-kat, amelyek megfelelnek bizonyos kritériumoknak: az URI-nak elérhetőnek kell lennie intent-filter-en keresztül VIEW művelettel, a sémának HTTP/HTTPS-nek kell lennie az Android App Linkshez. Az egyéni sémával rendelkező URI-k (myapp://) szintén indexelődnek, de csak telepített alkalmazással. Az automatikus indexelés nem vonatkozik azokra az URI-kra, amelyek hitelesítést igénylő vagy személyes adatokat tartalmazó oldalakra vezetnek.

Az automatikus indexelés korlátai

Az automatikus indexelésnek több korlátja van: az index nem azonnal frissül, hanem néhány órától napokig terjedő késéssel. Az alkalmazás API-szintje — az automatikus indexeléshez minSdkVersion 23 vagy magasabb szükséges. A HTTP/HTTPS séma nélküli URI-k csak a telepített alkalmazással rendelkező eszközökön indexelődnek. Az indexelés gyorsításához és a webes megfelelővel nem rendelkező tartalom hozzáadásához a Firebase App Indexing API használata javasolt.

Firebase App Indexing API

Firebase App Indexing API a Google HTTP API-ja, amely lehetővé teszi a fejlesztő számára, hogy programozottan kezelje az alkalmazás indexelt tartalmát. Az API kéréseket fogad URI-oldalak hozzáadására, frissítésére és törlésére a Google indexében. Az automatikus indexeléssel ellentétben az API azonnal működik: a hívás után a Google néhány percen belül elkezdi figyelembe venni az új URI-kat a keresési találatokban.

A Firebase App Indexing API kérésformátuma

A Firebase App Indexing API-nak küldött kérés egy oldalobjektumot tartalmaz az URI-val, címmel, leírással és opcionális képekkel. Minden URI különálló oldalként kerül feldolgozásra, amely megtalálható a Google keresésen keresztül. Az API OAuth 2.0 hitelesítést használ Firebase Service Account-on keresztül. URI-k tömeges hozzáadásához kötegelt feldolgozás támogatott, akár 1000 oldal egyetlen kérésben.

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

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

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

Tartalom frissítése és törlése

Amikor az alkalmazás tartalma megváltozik, frissíteni kell a Google indexét a Firebase App Indexing API-n keresztül. Az elavult tartalom törlése szintén fontos: ha egy URI már nem létezik vagy 404-es hibára vezet, el kell távolítani az indexből. A Firebase App Indexing nem törli automatikusan a tartalmat az alkalmazásban történő változásakor — a fejlesztő felelős az index szinkronizálásáért a tartalom aktuális állapotával. Javasolt az API meghívása minden adatváltozáskor: termékek, cikkek, profilok hozzáadásakor, szerkesztésekor vagy törlésekor.

App Indexing beállítása Android rendszerben

A Firebase App Indexing beállítása Android rendszerben több lépésből áll: a Firebase SDK csatlakoztatása, az app-indexing függőségek hozzáadása a build.gradle-ben, az Android App Links konfigurálása és egy szolgáltatás létrehozása az URI-k feldolgozásához. A Firebase App Indexing minimális API-verziója — 23. Az SDK konfigurálása után az alkalmazás automatikusan elkezdi küldeni az adatokat az indexeléshez a Google-nak a Google Play Services-en keresztül.

Függőségek hozzáadása és konfiguráció

A Firebase App Indexinghez hozzá kell adni a com.google.firebase:firebase-appindexing függőséget és a google-services bővítményt az alkalmazásmodul build.gradle fájljában. A Firebase automatikusan feldolgozza az indexelési adatokat a Google Play Services-en keresztül, ha az alkalmazás megfelel a követelményeknek: minSdkVersion 23+, intent-filter megléte HTTP/HTTPS sémákkal és Android App Links használata hitelesítéshez. Az egyéni sémával rendelkező URI-khoz további konfiguráció szükséges.

// 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 és hitelesítés

Az Android App Links olyan HTTP/HTTPS hivatkozások, amelyeket a Google hitelesített az alkalmazásához tartozóként. A hitelesítés Digital Asset Links-en keresztül történik: az assetlinks.json fájlt feltöltik a weboldalára. A hitelesítés után az Android automatikusan feldolgozza a domainjéről származó összes hivatkozást App Linksként, anélkül hogy megkérdezné a felhasználót, melyik alkalmazásban nyissa meg a hivatkozást. Ez szükséges feltétele az alkalmazás tartalma helyes indexelésének.

Az indexelés ellenőrzése

A konfiguráció után ellenőrizni kell, hogy az alkalmazás tartalma valóban indexelődik-e. Firebase Console App Indexing szakasza statisztikákat mutat: az indexelt URI-k számát, a keresésben való megjelenések számát és a kattintásokat. Részletes ellenőrzéshez használja a Search Console Google-t, ahol az indexelési hibák és javaslatok jelennek meg. A Google-ban a site:https://your-app.page.link kereséssel is megtekintheti az alkalmazás indexelt oldalait.

Az indexelés legjobb gyakorlatai

Hatékony indexelés az alkalmazás számára több kulcsfontosságú gyakorlat betartását igényli. Az összes indexelni kívánt URI-nak valódi tartalomra kell vezetnie — nincs helyettesítő oldal, üres képernyő vagy hibás oldal. Javasolt csak nyilvános tartalmat indexelni, és nem indexelni a hitelesítést igénylő oldalakat. Minden URI-nak olvasható névvel és leírással kell rendelkeznie a felhasználó nyelvén.

Mit indexeljünk

Indexelje azokat a tartalmakat, amelyeket a felhasználók a Google-ban keresnek: termékkártyák, cikkek, profilok, menükategóriák, receptek, események. Ne indexelje a személyes adatokat tartalmazó oldalakat, beállításokat, kosarat, rendelési előzményeket vagy bármilyen más privát adatot. Dinamikus tartalomhoz (hírfolyam, személyre szabott válogatások) használja a Firebase App Indexing API-t az új URI-k létrehozáskor történő hozzáadásához és törléskor történő eltávolításához.

Optimalizálás a kereséshez

Minden indexelt URI-nak értelmes címmel, leírással és képpel kell rendelkeznie a keresési találatokban való előnézethez. Használjon kulcsszavakat a címben és leírásban, amelyek megfelelnek a felhasználók valós keresési lekérdezéseinek. Képekhez használjon négyzetes 1200x1200 px formátumot, és győződjön meg arról, hogy nyilvános URL-eken keresztül elérhetők. Rendszeresen frissítse a tartalmat: a Google gyakrabban jeleníti meg a friss oldalakat a keresésben.