Firebase App Indexing — essentie van app-contentindexering en werkingsprincipe

Wat is Firebase App Indexing

Firebase App Indexing is een Google-technologie die de content van een mobiele app toegankelijk maakt voor de Google-zoekrobot, waardoor app-schermen kunnen worden geïndexeerd zoals Google webpagina's indexeert. Wanneer app-content is geïndexeerd, kan de gebruiker deze vinden in Google Search, Google Assistent of Google Lens en met één klik rechtstreeks naar het gewenste app-scherm gaan, zonder tussenkomst van een webpagina.

Principe van mobiele contentindexering

Google indexeert apps via twee mechanismen: automatische indexering en Firebase App Indexing API. Automatische indexering werkt op Android via Google Play Services: als de app is geïnstalleerd, indexeert Google automatisch de content waarnaar diepe links verwijzen. API-indexering stelt de ontwikkelaar in staat om programmatisch te beheren welke content zichtbaar is in zoekopdrachten, met behulp van Firebase App Indexing API voor het bijwerken of verwijderen van geïndexeerde pagina's.

Waarom is app-indexering nodig

App-indexering lost verschillende taken op: het aantrekken van nieuwe gebruikers uit Google-zoekopdrachten (zoekresultaten tonen app-content in kaarten). Verhogen van betrokkenheid — bestaande gebruikers vinden gewenste content sneller via zoeken op het apparaat. Verhogen van installaties — Google-zoekopdracht toont diepe links naar content, en als de app niet is geïnstalleerd, toont Google een installatielink. App Indexing verbetert ook de zichtbaarheid van de app in Google Assistent, die bij spraakgestuurd zoeken kan voorstellen om de app te openen.

Hoe werkt indexering van app-content

Het indexeringsproces begint wanneer Google de URI-schema's van uw app ontdekt. Voor Android gebruikt Google informatie uit Google Play Store (API-niveau, intent-filter, URI-schema's) om een kaart van de app te bouwen. Voor iOS wordt indexering uitgevoerd via Spotlight Integration en CSSearchableIndex. Wanneer Google app-content indexeert, koppelt het een URI (bijv. myapp://product/123) aan een web-URL, indien aanwezig, en slaat dit paar op in de zoekindex.

Koppeling van app en website

Voor correcte indexering moet Google de relatie tussen uw app en website begrijpen. Digital Asset Links is een JSON-bestand dat op uw website wordt geüpload en bevestigt dat de mobiele app eigendom is van de site-eigenaar. Het bestand assetlinks.json wordt in de hoofdmap van het domein geplaatst en bevat de SHA256-vingerafdruk van het app-ondertekeningscertificaat. Google controleert deze koppeling voordat het de knop om de app te openen in zoekresultaten weergeeft.

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

Bronnen van indexering

Google haalt content voor indexering uit verschillende bronnen: Google Play Store (lijst van gepubliceerde apps met hun URI-schema's), Android App Links (geverifieerde HTTP-schema's in Android 6.0+), Firebase App Indexing API (programmatische indexupdate) en automatische indexering via Google Play Services op apparaten met de geïnstalleerde app. Elke bron vult de algemene index aan, waardoor app-content maximaal toegankelijk wordt voor zoekopdrachten.

Automatische indexering via Google Play Services

Google Play Services indexeert automatisch de content van geïnstalleerde apps op Android, als de app correcte URI-schema's en intent-filter gebruikt. Het mechanisme scant de app op intent-filter voor de VIEW-actie en verzamelt de URI's die in de app worden gebruikt. Dit proces is volledig automatisch en vereist geen extra code van de ontwikkelaar — het volstaat om deep links correct in het manifest te configureren.

Welke URI's worden automatisch geïndexeerd

Google indexeert automatisch URI's die aan bepaalde criteria voldoen: de URI moet toegankelijk zijn via intent-filter met de VIEW-actie, het schema moet HTTP/HTTPS zijn voor Android App Links. URI's met aangepaste schema's (myapp://) worden ook geïndexeerd, maar alleen met de geïnstalleerde app. Automatische indexering is niet van toepassing op URI's die leiden naar pagina's die authenticatie vereisen of persoonlijke gebruikersgegevens bevatten.

Beperkingen van automatische indexering

Automatische indexering heeft enkele beperkingen: de index wordt niet onmiddellijk bijgewerkt, maar met een vertraging van enkele uren tot dagen. API-niveau van de app — voor automatische indexering is minSdkVersion 23 of hoger vereist. URI's zonder HTTP/HTTPS-schema worden alleen geïndexeerd op apparaten met de geïnstalleerde app. Voor versnelde indexering en toevoeging van content zonder web-equivalent wordt het gebruik van Firebase App Indexing API aanbevolen.

Firebase App Indexing API

Firebase App Indexing API is de HTTP API van Google waarmee de ontwikkelaar programmatisch de geïndexeerde content van de app kan beheren. De API ontvangt verzoeken voor het toevoegen, bijwerken en verwijderen van URI-pagina's in de Google-index. In tegenstelling tot automatische indexering werkt de API onmiddellijk: na aanroep begint Google binnen enkele minuten nieuwe URI's in zoekresultaten op te nemen.

Formaat van Firebase App Indexing API-verzoek

Een verzoek aan Firebase App Indexing API bevat een pagin-object met zijn URI, titel, beschrijving en optionele afbeeldingen. Elke URI wordt verwerkt als een afzonderlijke pagina die via Google-zoekopdracht kan worden gevonden. De API gebruikt OAuth 2.0-authenticatie via Firebase Service Account. Voor het bulksgewijs toevoegen van URI's wordt batchverwerking van maximaal 1000 pagina's in één verzoek ondersteund.

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

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

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

Content bijwerken en verwijderen

Wanneer content in de app verandert, moet de Google-index worden bijgewerkt via Firebase App Indexing API. Het verwijderen van verouderde content is ook belangrijk: als een URI niet meer bestaat of naar een 404 leidt, moet deze uit de index worden verwijderd. Firebase App Indexing verwijdert content niet automatisch bij wijziging in de app — de ontwikkelaar is verantwoordelijk voor synchronisatie van de index met de actuele contentstatus. Het wordt aanbevolen om de API aan te roepen bij elke gegevenswijziging: toevoegen, bewerken of verwijderen van producten, artikelen, profielen.

App Indexing configureren in Android

Firebase App Indexing configureren in Android omvat verschillende stappen: Firebase SDK aansluiten, app-indexing-afhankelijkheden toevoegen in build.gradle, Android App Links configureren en een service voor URI-verwerking maken. Minimale API-versie voor Firebase App Indexing — 23. Na SDK-configuratie begint de app automatisch gegevens voor indexering naar Google te sturen via Google Play Services.

Afhankelijkheden toevoegen en configuratie

Voor Firebase App Indexing moet in build.gradle van de app-module de afhankelijkheid com.google.firebase:firebase-appindexing en de google-services-plugin worden toegevoegd. Firebase verwerkt automatisch indexeringsgegevens via Google Play Services, als de app aan de vereisten voldoet: minSdkVersion 23+, aanwezigheid van intent-filter met HTTP/HTTPS-schema's en gebruik van Android App Links voor verificatie. Voor URI's met aangepaste schema's is aanvullende configuratie vereist.

// build.gradle (Module: 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 en verificatie

Android App Links zijn HTTP/HTTPS-links die Google verifieert als behorend tot uw app. Verificatie vindt plaats via Digital Asset Links: het bestand assetlinks.json wordt op uw website geüpload. Na verificatie verwerkt Android automatisch alle links van uw domein als App Links, zonder de gebruiker te vragen in welke app de link moet worden geopend. Dit is een noodzakelijke voorwaarde voor correcte indexering van app-content.

Indexering controleren

Na configuratie moet worden gecontroleerd of de app-content daadwerkelijk wordt geïndexeerd. Firebase Console in de sectie App Indexing toont statistieken: aantal geïndexeerde URI's, aantal weergaven in zoekopdrachten en klikken. Voor gedetailleerde controle gebruikt u Search Console Google, waar indexeringsfouten en aanbevelingen worden weergegeven. U kunt ook een zoekopdracht naar site:https://your-app.page.link in Google uitvoeren om de geïndexeerde pagina's van de app te zien.

Beste praktijken voor indexering

Effectieve indexering van de app vereist naleving van enkele belangrijke praktijken. Alle URI's die u wilt indexeren, moeten naar echte content leiden — geen placeholder-pagina's, lege schermen of foutpagina's. Het wordt aanbevolen om alleen openbare content te indexeren en pagina's die authenticatie vereisen niet te indexeren. Elke URI moet een leesbare naam en beschrijving hebben in de taal van de gebruiker.

Wat te indexeren

Indexeer content die gebruikers in Google zoeken: productkaarten, artikelen, profielen, menucategorieën, recepten, evenementen. Indexeer niet pagina's met persoonlijke gegevens, instellingen, winkelwagen, bestelgeschiedenis of andere privégegevens. Gebruik voor dynamische content (nieuwsfeed, gepersonaliseerde selecties) Firebase App Indexing API om nieuwe URI's toe te voegen wanneer ze worden gemaakt en te verwijderen bij verwijdering.

Optimalisatie voor zoekopdrachten

Elke geïndexeerde URI moet een betekenisvolle titel, beschrijving en afbeelding hebben voor voorbeeldweergave in zoekresultaten. Gebruik trefwoorden in titel en beschrijving die overeenkomen met echte zoekopdrachten van gebruikers. Gebruik voor afbeeldingen het vierkante formaat 1200x1200 px en zorg ervoor dat ze toegankelijk zijn via openbare URL's. Werk content regelmatig bij: Google toont vaker recente pagina's in zoekresultaten.