Firebase App Indexing — innebörden av innehållsindexering för appar och funktionsprincip

Vad är Firebase App Indexing

Firebase App Indexing är en Google-teknologi som gör innehållet i en mobilapp tillgängligt för Googles sökrobot, vilket gör det möjligt att indexera app-skärmar precis som Google indexerar webbsidor. När appinnehåll är indexerat kan användaren hitta det i Google Search, Google Assistant eller Google Lens och gå direkt till önskad app-skärm med ett klick, utan att gå via en webbsida.

Princip för mobil innehållsindexering

Google indexerar appar via två mekanismer: automatisk indexering och Firebase App Indexing API. Automatisk indexering fungerar på Android via Google Play Services: om appen är installerad indexerar Google automatiskt innehåll som nås via djupa länkar. API-indexering gör att utvecklaren programmatiskt kan hantera vilket innehåll som syns i sökningen, med Firebase App Indexing API för att uppdatera eller ta bort indexerade sidor.

Varför appindexering behövs

Appindexering löser flera uppgifter: att locka nya användare från Google-sökning (sökresultaten visar appinnehåll i kort). Öka engagemang — befintliga användare hittar önskat innehåll snabbare via sökning på enheten. Öka installationer — Google-sökning visar djupa länkar till innehåll, och om appen inte är installerad visar Google en installationslänk. App Indexing förbättrar också appens synlighet i Google Assistant, som kan föreslå att öppna appen vid röstsökning.

Hur fungerar indexering av appinnehåll

Indexeringsprocessen börjar när Google upptäcker din apps URI-scheman. För Android använder Google information från Google Play Store (API-nivå, intent-filter, URI-scheman) för att bygga en appkarta. För iOS utförs indexering via Spotlight Integration och CSSearchableIndex. När Google indexerar appinnehåll kopplar det en URI (t.ex. myapp://product/123) till en webb-URL, om den finns, och lagrar detta par i sökindexet.

Koppling mellan app och webbplats

För korrekt indexering måste Google förstå sambandet mellan din app och webbplats. Digital Asset Links är en JSON-fil som laddas upp på din webbplats och bekräftar att mobilappen tillhör webbplatsägaren. Filen assetlinks.json placeras i domänens rot och innehåller SHA256-avtrycket från appens signeringscertifikat. Google kontrollerar denna koppling innan det visar knappen för att öppna appen i sökresultaten.

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

Källor för indexering

Google hämtar innehåll för indexering från flera källor: Google Play Store (lista över publicerade appar med deras URI-scheman), Android App Links (verifierade HTTP-scheman i Android 6.0+), Firebase App Indexing API (programmatisk uppdatering av index) och automatisk indexering via Google Play Services på enheter med installerad app. Varje källa kompletterar det allmänna indexet och gör appinnehållet maximalt tillgängligt för sökning.

Automatisk indexering via Google Play Services

Google Play Services indexerar automatiskt innehåll i installerade appar på Android, om appen använder korrekta URI-scheman och intent-filter. Mekanismen skannar appen efter intent-filter för VIEW-åtgärden och samlar in URI:er som används i appen. Denna process är helt automatisk och kräver ingen extra kod från utvecklaren — det räcker med att konfigurera djupa länkar korrekt i manifestet.

Vilka URI:er indexeras automatiskt

Google indexerar automatiskt URI:er som uppfyller vissa kriterier: URI:n måste vara tillgänglig via intent-filter med VIEW-åtgärd, schemat måste vara HTTP/HTTPS för Android App Links. URI:er med anpassade scheman (myapp://) indexeras också, men endast med installerad app. Automatisk indexering gäller inte URI:er som leder till sidor som kräver autentisering eller innehåller personlig användardata.

Begränsningar för automatisk indexering

Automatisk indexering har flera begränsningar: indexet uppdateras inte omedelbart utan med en fördröjning från några timmar till dagar. Appens API-nivå — för automatisk indexering krävs minSdkVersion 23 eller högre. URI:er utan HTTP/HTTPS-schema indexeras endast på enheter med installerad app. För att påskynda indexering och lägga till innehåll utan webbmotsvarighet rekommenderas att använda Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API är Googles HTTP-API som gör att utvecklaren programmatiskt kan hantera appens indexerade innehåll. API:et tar emot förfrågningar om att lägga till, uppdatera och ta bort URI-sidor i Googles index. Till skillnad från automatisk indexering fungerar API:et omedelbart: efter anrop börjar Google inom några minuter att ta hänsyn till nya URI:er i sökresultaten.

Format för Firebase App Indexing API-förfrågan

En förfrågan till Firebase App Indexing API innehåller ett sidobjekt med dess URI, titel, beskrivning och valfria bilder. Varje URI behandlas som en separat sida som kan hittas via Google-sökning. API:et använder OAuth 2.0-autentisering via Firebase Service Account. För massinläggning av URI:er stöds batchbehandling av upp till 1000 sidor i en enda förfrågan.

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

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

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

Uppdatera och ta bort innehåll

När innehållet i appen ändras måste Google-indexet uppdateras via Firebase App Indexing API. Borttagning av föråldrat innehåll är också viktigt: om en URI inte längre finns eller leder till en 404:a måste den tas bort från indexet. Firebase App Indexing tar inte bort innehåll automatiskt när det ändras i appen — utvecklaren ansvarar för att synkronisera indexet med innehållets aktuella tillstånd. Det rekommenderas att anropa API:et vid varje dataändring: tillägg, redigering eller borttagning av produkter, artiklar, profiler.

Konfigurera App Indexing i Android

Konfigurera Firebase App Indexing i Android innefattar flera steg: ansluta Firebase SDK, lägga till app-indexing-beroenden i build.gradle, konfigurera Android App Links och skapa en tjänst för URI-behandling. Minsta API-version för Firebase App Indexing — 23. Efter SDK-konfiguration börjar appen automatiskt skicka data för indexering till Google via Google Play Services.

Lägga till beroenden och konfiguration

För Firebase App Indexing måste beroendet com.google.firebase:firebase-appindexing och google-services-plugin läggas till i appmodulens build.gradle. Firebase behandlar automatiskt indexeringsdata via Google Play Services, om appen uppfyller kraven: minSdkVersion 23+, förekomst av intent-filter med HTTP/HTTPS-scheman och användning av Android App Links för verifiering. För URI:er med anpassade scheman krävs ytterligare konfiguration.

// 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 och verifiering

Android App Links är HTTP/HTTPS-länkar som Google verifierar som tillhörande din app. Verifiering utförs via Digital Asset Links: filen assetlinks.json laddas upp på din webbplats. Efter verifiering behandlar Android automatiskt alla länkar från din domän som App Links, utan att fråga användaren i vilken app länken ska öppnas. Detta är ett nödvändigt villkor för korrekt indexering av appinnehåll.

Kontrollera indexering

Efter konfiguration måste du kontrollera att appinnehållet verkligen indexeras. Firebase Console i avsnittet App Indexing visar statistik: antal indexerade URI:er, antal visningar i sökning och klick. För detaljerad kontroll använder du Search Console Google, där indexeringsfel och rekommendationer visas. Du kan också göra en sökning på site:https://your-app.page.link i Google för att se appens indexerade sidor.

Bästa metoder för indexering

Effektiv indexering av appen kräver att flera viktiga metoder följs. Alla URI:er du vill indexera måste leda till verkligt innehåll — inga platshållarsidor, tomma skärmar eller felsidor. Det rekommenderas att endast indexera offentligt innehåll och inte indexera sidor som kräver autentisering. Varje URI bör ha ett läsbart namn och beskrivning på användarens språk.

Vad ska indexeras

Indexera innehåll som användare söker efter i Google: produktkort, artiklar, profiler, menykategorier, recept, evenemang. Indexera inte sidor med personuppgifter, inställningar, varukorg, orderhistorik eller andra privata data. För dynamiskt innehåll (nyhetsflöde, personaliserade urval) använder du Firebase App Indexing API för att lägga till nya URI:er när de skapas och ta bort dem när de tas bort.

Optimering för sökning

Varje indexerad URI bör ha en meningsfull titel, beskrivning och bild för förhandsvisning i sökresultaten. Använd sökord i titel och beskrivning som motsvarar användarnas verkliga sökfrågor. För bilder, använd kvadratiskt format 1200x1200 px och säkerställ att de är tillgängliga via offentliga URL:er. Uppdatera innehållet regelbundet: Google visar oftare färska sidor i sökningen.