Gestione dei link per app Android

I link diretti gestiscono gli URI dei contenuti. I link web gestiscono gli schemi HTTP e HTTPS. I link per app Android gestiscono l'attributo autoVerify.
Figura 1. Funzionalità dei link diretti, dei link web e dei link per app Android.

Gli utenti che seguono i link sui dispositivi hanno un obiettivo in mente: accedere ai contenuti che vogliono visualizzare. In qualità di sviluppatore, puoi configurare i link per app Android per indirizzare gli utenti a contenuti specifici di un link direttamente nella tua app, bypassando la finestra di dialogo di selezione dell'app, nota anche come finestra di dialogo di sambiguazione. Poiché i link app Android sfruttano gli URL HTTP e l'associazione con un sito web, gli utenti che non hanno installato la tua app vanno direttamente ai contenuti del tuo sito.

Prima di implementare Link per app Android, è importante comprendere i diversi tipi di link che puoi creare nella tua app per Android: link diretti, link web e link per app Android. La Figura 1 mostra la relazione tra questi tipi di link e le sezioni seguenti descrivono ciascun tipo di link in modo più dettagliato.

I link diretti sono URI di qualsiasi schema che indirizzano gli utenti direttamente a una parte specifica della tua app. Per creare link diretti, aggiungi filtri per intent per indirizzare gli utenti all'attività corretta nella tua app, come mostrato nel seguente snippet di codice:

<activity
    android:name=".MyMapActivity"
    android:exported="true"
    ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="geo" />
    </intent-filter>
</activity>

Quando l'utente fa clic su un link diretto, potrebbe essere visualizzata una finestra di dialogo di disambiguazione. Questa dialogo consente all'utente di selezionare una delle varie app, inclusa la tua, che puoi gestire il link diretto specificato. La Figura 2 mostra la finestra di dialogo dopo che l'utente fa clic su un link a una mappa, chiedendo se aprire il link in Maps o Chrome.

Figura 2. La finestra di dialogo di disambiguazione

I link web sono link diretti che utilizzano gli schemi HTTP e HTTPS. Su Android 12 e versioni successive, fare clic su un link web (che non sia un link ad app per Android) mostra sempre i contenuti in un browser web. Sui dispositivi con versioni precedenti di Android, se anche la tua app o altre app installate sul dispositivo di un utente sono in grado di gestire il link web, gli utenti potrebbero non andare direttamente al browser. Verrà visualizzata una finestra di dialogo di disambiguazione simile a quella mostrata nella Figura 2.

Il seguente snippet di codice mostra un esempio di filtro dei link web:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="http" />
    <data android:host="myownpersonaldomain.com" />
</intent-filter>

I link alle app per Android, disponibili su Android 6.0 (livello API 23) e versioni successive, sono link web che utilizzano gli schemi HTTP e HTTPS e contengono l'attributo autoVerify. Questo attributo consente alla tua app di definirsi come gestore predefinito di un determinato tipo di link. Di conseguenza, quando l'utente fa clic su un link per app Android, la tua app si apre immediatamente se è installata e la finestra di dialogo di disambiguazione non viene visualizzata.

Se l'utente non vuole che la tua app sia il gestore predefinito, può sostituire questo comportamento dalle impostazioni dell'app.

Il seguente snippet di codice mostra un esempio di filtro Link per app Android:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <!-- Do not include other schemes. -->
    <data android:scheme="http" />
    <data android:scheme="https" />

    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Link per app Android offre i seguenti vantaggi:

  • Sicuri e specifici: i link per app Android utilizzano URL HTTP che rimandano a un dominio di un sito web di tua proprietà, pertanto nessun'altra app può utilizzare i tuoi link. Uno dei requisiti per i link alle app Android è la verifica della proprietà del tuo dominio tramite uno dei nostri metodi di associazione del sito web.
  • Esperienza utente perfetta: poiché i link app Android utilizzano un unico URL HTTP per gli stessi contenuti del tuo sito web e della tua app, gli utenti che non hanno installato l'app vengono semplicemente indirizzati al tuo sito web anziché all'app, senza ricevere errori 404 o di altro tipo.
  • Supporto delle app istantanee Android:con le app istantanee Android, gli utenti possono eseguire la tua app Android senza installarla. Per aggiungere il supporto delle app istantanee alla tua app per Android, configura i link alle app per Android e visita la pagina g.co/InstantApps.
  • Coinvolgi gli utenti dalla Ricerca Google:gli utenti aprono contenuti specifici direttamente nella tua app facendo clic su un URL di Google in un browser mobile, nell'app Ricerca Google, nella ricerca sullo schermo su Android o tramite l'Assistente Google.

Di seguito sono riportati i passaggi generali per la creazione di link per app Android:

  1. Crea link diretti a contenuti specifici nella tua app: nel file manifest dell'app, crea filtri per intent per gli URI del tuo sito web e configura l'app in modo che utilizzi i dati degli intent per indirizzare gli utenti ai contenuti giusti nell'app. Scopri di più nella pagina Creare link diretti ai contenuti dell'app.
  2. Aggiungi la verifica dei link diretti: configura la tua app per richiedere la verifica dei link dell'app. Poi, pubblica un file JSON Digital Asset Links sui tuoi siti web per verificare la proprietà tramite Google Search Console. Scopri di più in Verificare i link delle app.

Come alternativa alla documentazione linkata sopra, l'Assistente Link per app Android è uno strumento di Android Studio che ti guida attraverso ogni passaggio necessario per creare i link per app Android.

Per ulteriori informazioni, consulta le seguenti risorse:

Gestire e verificare i link per app Android

Puoi gestire e verificare i link diretti tramite Play Console. Dopo che un'app è stata caricata correttamente, la dashboard (nella sezione Crescita > Link diretti) mostra una panoramica dei link diretti e degli errori di configurazione.

Figura 3. Dashboard di Play Console per i link diretti

La dashboard offre le seguenti sezioni:

  • Aspetti salienti della configurazione complessiva dei link diretti
  • Tutti i domini dichiarati nel file manifest
  • Link web raggruppati per percorso
  • Link con schemi personalizzati
Ognuna di queste sezioni mostra lo stato del link diretto e un modo per correggerlo in caso di errore.

Per saperne di più sulla dashboard, consulta questa guida.