Firebase App Indexing — essenza dell’indicizzazione dei contenuti delle app e principio di funzionamento

Cos’è Firebase App Indexing

Firebase App Indexing è una tecnologia Google che rende il contenuto dell’app mobile accessibile al crawler di ricerca di Google, consentendo di indicizzare gli schermi dell’app nello stesso modo in cui Google indicizza le pagine web. Quando il contenuto dell’app è indicizzato, gli utenti possono trovarlo in Google Search, Google Assistant o Google Lens e passare direttamente allo schermo desiderato dell’app con un clic, bypassando la pagina web.

Principio di indicizzazione dei contenuti mobili

Google indicizza le app attraverso due meccanismi: indicizzazione automatica e Firebase App Indexing API. L’indicizzazione automatica funziona su Android tramite Google Play Services: se l’app è installata, Google indicizza automaticamente i contenuti che hanno collegamenti profondi. L’indicizzazione API consente allo sviluppatore di controllare programmaticamente quali contenuti sono visibili nella ricerca, utilizzando Firebase App Indexing API per aggiornare o rimuovere pagine indicizzate.

Perché è necessaria l’indicizzazione delle app

L’indicizzazione delle app risolve diversi compiti: attrarre nuovi utenti dalla ricerca Google (i risultati di ricerca mostrano i contenuti dell’app in schede). Maggiore coinvolgimento — gli utenti esistenti trovano i contenuti desiderati più velocemente attraverso la ricerca sul dispositivo. Aumento delle installazioni — la ricerca Google mostra collegamenti profondi ai contenuti e, se l’app non è installata, Google mostra un collegamento per l’installazione. App Indexing migliora anche la visibilità dell’app in Google Assistant, che può suggerire di aprire l’app durante la ricerca vocale.

Come funziona l’indicizzazione dei contenuti delle app

Il processo di indicizzazione inizia quando Google scopre gli schemi URI della tua app. Per Android, Google utilizza le informazioni dal Google Play Store (livello API, intent-filter, schemi URI) per costruire una mappa dell’app. Per iOS, l’indicizzazione viene effettuata tramite Spotlight Integration e CSSearchableIndex. Quando Google indicizza i contenuti dell’app, collega l’URI (ad esempio, myapp://product/123) a un URL web, se esiste, e memorizza questa coppia nell’indice di ricerca.

Collegamento dell’app e del sito web

Per un’indicizzazione corretta, Google deve comprendere la relazione tra la tua app e il sito web. Digital Asset Links è un file JSON caricato sul tuo sito web che conferma che l’app mobile appartiene al proprietario del sito. Il file assetlinks.json viene posizionato nella radice del dominio e contiene l’impronta SHA256 del certificato di firma dell’app. Google verifica questo collegamento prima di mostrare il pulsante di apertura dell’app nei risultati di ricerca.

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

Fonti di indicizzazione

Google riceve contenuti da indicizzare da diverse fonti: Google Play Store (elenco delle app pubblicate con i loro schemi URI), Android App Links (schemi HTTP verificati in Android 6.0+), Firebase App Indexing API (aggiornamento programmatico dell’indice) e indicizzazione automatica tramite Google Play Services sui dispositivi con l’app installata. Ogni fonte integra l’indice generale, rendendo i contenuti dell’app il più accessibili possibile per la ricerca.

Indicizzazione automatica tramite Google Play Services

Google Play Services indicizza automaticamente i contenuti delle app installate su Android se l’app utilizza schemi URI e intent-filter corretti. Il meccanismo scansiona l’app alla ricerca di intent-filter con azione VIEW e raccoglie gli URI utilizzati nell’app. Questo processo è completamente automatico e non richiede codice aggiuntivo da parte dello sviluppatore — basta configurare correttamente i collegamenti profondi nel manifest.

Quali URI vengono indicizzati automaticamente

Google indicizza automaticamente gli URI che soddisfano determinati criteri: l’URI deve essere accessibile tramite intent-filter con azione VIEW, lo schema deve essere HTTP/HTTPS per Android App Links. Gli URI con schemi personalizzati (myapp://) vengono anch’essi indicizzati, ma solo quando l’app è installata. L’indicizzazione automatica non si applica agli URI che portano a pagine di autenticazione o dati personali dell’utente.

Limitazioni dell’indicizzazione automatica

L’indicizzazione automatica ha diverse limitazioni: l’indice non viene aggiornato istantaneamente, ma con un ritardo da alcune ore a giorni. Livello API dell’app — l’indicizzazione automatica richiede minSdkVersion 23 o superiore. Gli URI senza schema HTTP/HTTPS vengono indicizzati solo sui dispositivi con l’app installata. Per accelerare l’indicizzazione e aggiungere contenuti senza equivalenti web, si consiglia di utilizzare Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API è un’API HTTP di Google che consente allo sviluppatore di gestire programmaticamente i contenuti indicizzati dell’app. L’API accetta richieste per aggiungere, aggiornare e rimuovere pagine URI dall’indice di Google. A differenza dell’indicizzazione automatica, l’API funziona istantaneamente: dopo una chiamata, Google inizia a considerare i nuovi URI nei risultati di ricerca entro pochi minuti.

Formato della richiesta di Firebase App Indexing API

Una richiesta a Firebase App Indexing API contiene un oggetto pagina con il suo URI, titolo, descrizione e immagini opzionali. Ogni URI viene elaborato come una pagina separata che può essere trovata tramite la ricerca Google. L’API utilizza l’autenticazione OAuth 2.0 tramite un account di servizio Firebase. Per l’aggiunta in massa di URI, è supportata l’elaborazione in batch fino a 1000 pagine in una singola richiesta.

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

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

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

Aggiornamento e rimozione dei contenuti

Quando i contenuti dell’app cambiano, è necessario aggiornare l’indice di Google tramite Firebase App Indexing API. La rimozione dei contenuti obsoleti è anch’essa importante: se un URI non esiste più o porta a un 404, deve essere rimosso dall’indice. Firebase App Indexing non rimuove automaticamente i contenuti quando cambiano nell’app — lo sviluppatore è responsabile della sincronizzazione dell’indice con lo stato attuale dei contenuti. Si consiglia di chiamare l’API a ogni modifica dei dati: aggiunta, modifica o eliminazione di prodotti, articoli, profili.

Configurazione di App Indexing in Android

La configurazione di Firebase App Indexing in Android include diversi passaggi: aggiunta dell’SDK Firebase, aggiunta delle dipendenze app-indexing in build.gradle, configurazione di Android App Links e creazione di un servizio per gestire gli URI. La versione minima dell’API per Firebase App Indexing è 23. Dopo la configurazione dell’SDK, l’app inizia automaticamente a inviare dati per l’indicizzazione a Google tramite Google Play Services.

Aggiunta di dipendenze e configurazione

Per Firebase App Indexing, è necessario aggiungere la dipendenza com.google.firebase:firebase-appindexing e il plugin google-services al build.gradle del modulo dell’app. Firebase elabora automaticamente i dati di indicizzazione tramite Google Play Services se l’app soddisfa i requisiti: minSdkVersion 23+, presenza di intent-filter con schemi HTTP/HTTPS e utilizzo di Android App Links per la verifica. Per gli URI con schemi personalizzati, è necessaria una configurazione aggiuntiva.

// build.gradle (Modulo: 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 e verifica

Android App Links sono collegamenti HTTP/HTTPS che Google verifica come appartenenti alla tua app. La verifica viene eseguita tramite Digital Asset Links: il file assetlinks.json viene caricato sul tuo sito web. Dopo la verifica, Android gestisce automaticamente tutti i collegamenti dal tuo dominio come App Links, senza chiedere all’utente in quale app aprire il collegamento. Questa è una condizione necessaria per una corretta indicizzazione dei contenuti dell’app.

Verifica dell’indicizzazione

Dopo la configurazione, è necessario verificare che i contenuti dell’app siano effettivamente indicizzati. Firebase Console nella sezione App Indexing mostra le statistiche: numero di URI indicizzati, numero di impressioni di ricerca e clic. Per una verifica dettagliata, utilizza Google Search Console, dove vengono visualizzati errori di indicizzazione e raccomandazioni. Puoi anche cercare site:https://your-app.page.link in Google per vedere le pagine indicizzate dell’app.

Buone pratiche di indicizzazione

Un’indicizzazione efficace dell’app richiede il rispetto di diverse pratiche chiave. Tutti gli URI che desideri indicizzare devono portare a contenuti reali — nessun segnaposto, schermo vuoto o pagina di errore. Si consiglia di indicizzare solo contenuti pubblici e di non indicizzare pagine che richiedono autenticazione. Ogni URI dovrebbe avere un nome e una descrizione leggibili nella lingua dell’utente.

Cosa indicizzare

Indicizza i contenuti che gli utenti cercano in Google: schede prodotto, articoli, profili, categorie di menu, ricette, eventi. Non indicizzare pagine con dati personali, impostazioni, carrello della spesa, cronologia ordini o qualsiasi altro dato privato. Per i contenuti dinamici (feed di notizie, selezioni personalizzate), utilizza Firebase App Indexing API per aggiungere nuovi URI man mano che vengono creati e rimuoverli quando vengono eliminati.

Ottimizzazione per la ricerca

Ogni URI indicizzato dovrebbe avere un titolo, una descrizione e un’immagine di anteprima significativi per i risultati di ricerca. Usa parole chiave nel titolo e nella descrizione che corrispondano alle reali query di ricerca degli utenti. Per le immagini, utilizza il formato quadrato 1200x1200 px e assicurati che siano accessibili tramite URL pubblici. Aggiorna regolarmente i contenuti: Google mostra le pagine fresche più spesso nei risultati di ricerca.