Informazioni sugli app link

Android App Links è una funzionalità di deep linking speciale di Android 6 e versioni successive che consente agli URL del tuo sito web verificato di aprire immediatamente i contenuti corrispondenti nella tua app per Android, senza che l'utente debba selezionare l'app da una finestra di dialogo di disambiguazione. Per rendere possibile tutto questo, Android utilizza le istruzioni Digital Asset Links ospitate sul tuo sito web per stabilire un'associazione sicura e verificata tra il tuo sito web e la tua app. Dopo aver verificato l'associazione, Android può indirizzare automaticamente i deep link al tuo sito web direttamente alla tua app per la gestione.

A partire da Android 15, gli app link sono ancora più potenti grazie all'introduzione degli app link dinamici. Con le nuove funzionalità dinamiche, puoi perfezionare al volo i comportamenti dei deep link della tua app, con un maggiore controllo e senza dover rilasciare una nuova versione dell'app.

Perché dovresti utilizzare gli app link:

  • Esperienza utente fluida: indirizza gli utenti direttamente a contenuti specifici della tua app dai risultati di ricerca, dai siti web, dalla messaggistica e da altre app. Poiché i link app utilizzano un singolo URL per gli stessi contenuti sul tuo sito web e nella tua app, gli utenti che non hanno installato l'app vengono indirizzati al tuo sito web, senza errori 404 o di altro tipo.
  • Sicurezza avanzata: gli App Link richiedono la verifica della proprietà del dominio, impedendo ad altre app di intercettare i tuoi link.
  • Configurazione dinamica (Android 15 e versioni successive): aggiorna il comportamento di deep linking della tua app al volo, per una maggiore flessibilità e aggiornamenti più rapidi per elementi come vanity URL, campagne stagionali o link specifici per l'utente.
  • Coinvolgimento: puoi coinvolgere gli utenti tramite link nei risultati di ricerca, annunci, pagine web, messaggi e altro ancora.

Come supportare gli app link

  1. Crea deep link a contenuti specifici nella tua app: nel 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 corretti nell'app.
  2. Aggiungi la verifica per i deep link: configura l'app in modo che richieda la verifica degli app link. Poi, pubblica un file JSON Digital Asset Links sui tuoi siti web per verificare la proprietà.

In alternativa, puoi utilizzare l'assistente per app link in Android Studio per seguire i passaggi necessari per creare e verificare Android App Links. Per saperne di più, consulta Strumenti per sviluppatori di link alle app.

  • Link alle app dinamici: Android 15 (livello API 35) o versioni successive, su dispositivi con Google Services installati.
  • Link per app: Android 6 (livello API 23) e versioni successive, su dispositivi con servizi Google installati.
  • Deep linking normale (gestito dall'utente): tutte le versioni di Android, su tutti i dispositivi.

Come funzionano gli App Link

Gli App Link sono un modo speciale di deep linking che ti offre il controllo completo sulla gestione dei link al tuo sito web. Si basa sullo stesso sistema basato sugli intent utilizzato da altri tipi di deep link, ma aggiunge un passaggio di verifica per i tuoi link utilizzando un file Digital Asset Links sul tuo sito web.

Gli app link creano un'associazione sicura e attendibile tra la tua app e il tuo sito web utilizzando i dati dell'app e un file assetlinks.json speciale che ospiti sul tuo sito web o dominio. Il file assetlinks.json dichiara le istruzioni Digital Asset Links per verificare l'associazione dell'app.

Ecco il flusso concettuale:

  1. Il manifest della tua app dichiara gli URL in un filtro per intent con android:autoVerify="true" e rimanda all'host del tuo sito web.
  2. Quando l'app viene installata, il sistema Android recupera il file assetlinks.json da una posizione nota sul tuo server web.
  3. Il sistema verifica che il file assetlinks.json sia valido e che l'elemento sha256_cert_fingerprints corrisponda al certificato di firma della tua app.
  4. Quando l'utente fa clic su un link corrispondente, il sistema lo indirizza direttamente alla tua app, senza mostrare una finestra di dialogo di disambiguazione.

Poiché i link app utilizzano URL HTTP e l'associazione a un sito web, gli utenti che non hanno installato la tua app accedono direttamente ai contenuti del tuo sito. In questo modo, App Links offre un'esperienza affidabile e fluida per gli utenti che toccano i deep link alle tue proprietà web.

A partire da Android 15, gli App Link sono ancora più potenti grazie all'introduzione degli App Link dinamici. Con gli App Link dinamici, hai la possibilità di aggiornare le regole di deep linking lato server, nel file assetlinks.json, senza dover pubblicare una nuova versione dell'app. Gli App Link dinamici supportano i campi di Digital Asset Links per perfezionare le regole di deep linking. I dispositivi Android con i servizi Google installati aggiorneranno periodicamente il file e applicheranno le nuove regole di deep linking in modo dinamico. Non è necessario alcun aggiornamento dell'app.

In precedenza, questo file veniva utilizzato principalmente per la verifica di base. Ora è un potente strumento di configurazione che ti consente di specificare percorsi, parametri di query, frammenti ed esclusioni, fornendo una soluzione di deep linking dinamica e solida:

  • Supporto delle esclusioni: puoi specificare determinati percorsi o sezioni di un URL che non devono aprire la tua app, anche se corrispondono alla configurazione dei link alle app.
  • Supporto dei parametri di query: con la nuova funzionalità Parametri di query, puoi definire parametri specifici che, se presenti in un URL, impediscono l'apertura dell'app. Ciò apre interessanti possibilità per le esclusioni dinamiche, i test A/B e l'attivazione graduale dei link alle app per determinati segmenti utenti.
  • Aggiornamenti dinamici: apporta aggiornamenti alla configurazione degli app link senza dover aggiornare l'app specificando i percorsi degli URL gestiti dall'app direttamente nel file assetlinks.json ospitato sul tuo server.

I link alle app dinamici ti offrono anche un controllo granulare sugli URL che vuoi che aprano la tua app, inclusa la corrispondenza per percorsi dell'URL, frammenti e parametri di query. Puoi anche escludere una qualsiasi delle corrispondenze in modo che non sia consentito aprire la tua app. Per maggiori informazioni, consulta Configura regole dinamiche.

Ecco il flusso concettuale per gli app link dinamici:

  1. Il manifest della tua app dichiara gli URL in un filtro per intent con android:autoVerify="true" e rimanda all'host del tuo sito web.
  2. Quando l'app viene installata, il sistema Android recupera il file assetlinks.json da una posizione nota sul tuo server web.
  3. Il sistema verifica che il file sia valido e che sha256_cert_fingerprints corrisponda al certificato di firma della tua app.
  4. Il sistema analizza le regole di deep linking definite nel campo dynamic_app_link_components della dichiarazione Digital Asset Links e le unisce alle regole dichiarate nel manifest.
    1. Quando l'utente fa clic su un link corrispondente, il sistema lo indirizza direttamente alla tua app, senza mostrare una finestra di dialogo di disambiguazione.
  5. Il sistema recupera periodicamente il file assetlinks.json per ottenere le regole più recenti, consentendoti di aggiornare i link senza un aggiornamento dell'app. Il recupero periodico è supportato sui dispositivi con Android 15 (livello API 35) o versioni successive su cui sono installati i servizi Google.

Esempi di casi d'uso

  • Campagne di marketing stagionali: un'app di vendita al dettaglio potrebbe aggiungere una regola per "/promo/summer-sale" al file assetlinks.json per indirizzare gli utenti a una schermata di vendita specifica. Al termine della promozione, la regola può essere rimossa senza che gli utenti debbano aggiornare l'app.
  • URL personalizzati per i partner: se hai una partnership con un influencer, puoi creare un URL personalizzato come "/partner/nome-influencer" e aggiungere una regola per questo URL. Puoi quindi monitorare, aggiornare o rimuovere questo URL in modo dinamico man mano che le partnership cambiano.
  • Test A/B dei percorsi degli URL: uno sviluppatore potrebbe pubblicare una nuova funzionalità in un percorso dell'URL specifico e aggiungere una regola nel file assetlinks.json. In questo modo, possono testare la funzionalità con un sottoinsieme di utenti e poi modificare il routing senza un deployment completo dell'app.
  • Eventi di breve durata: un'app di biglietteria o di eventi potrebbe aggiungere regole per gli URL di eventi specifici. Una volta terminato l'evento, puoi eliminare queste regole dal server.

Compatibilità con le implementazioni di App Links

Le estensioni degli app link dinamici in Android 15 sono progettate per la piena compatibilità con le implementazioni esistenti degli app link sui dispositivi con versioni precedenti di Android. Le versioni precedenti dell'app non possono utilizzare la configurazione dinamica o le funzionalità di configurazione e utilizzeranno le regole dichiarate nel manifest. Il tuo link all'app può comunque aprire correttamente l'app o eseguire il fallback sul web per gli utenti con versioni di Android precedenti. Nella maggior parte dei casi, puoi implementare in sicurezza le regole dinamiche senza influire sull'esperienza del resto della tua base utenti. Per maggiori dettagli su come configurare i filtri per intent per la compatibilità con le versioni precedenti, consulta Compatibilità con le versioni precedenti degli app link dinamici per Android 14 e versioni precedenti.

Considerazioni per la configurazione delle regole di filtro degli app link dinamici

Se stai configurando filtri per intent da utilizzare con app link dinamici in Android 15 o versioni successive, tieni presente che le regole di instradamento a livello di percorso definite nel file assetlinks.json lato server non possono espandere l'ambito impostato staticamente nelle regole dei filtri per intent del file manifest.

Per questo motivo, ti consigliamo di configurare l'ambito più ampio possibile nei filtri per intent del manifest e poi di affidarti alle regole nel file assetlinks.json lato server per un ulteriore perfezionamento. Con questa configurazione ideale, potrai aggiungere dinamicamente nuovi app link che rientrano nell'ambito ampio impostato nel manifest.

Correzione dell'affidabilità per le regole dinamiche

A settembre 2026, abbiamo risolto un problema in Google Play Services che impediva in modo intermittente ad alcuni dispositivi con Android 15 (livello API 35) e versioni successive di applicare le regole dinamiche nel file assetlinks.json. Quando si è verificato il problema, i dispositivi interessati hanno utilizzato solo i filtri per intent dichiarati nel manifest dell'app, pertanto gli URL esclusi dalle regole dinamiche potevano aprire l'app. Non è necessario modificare l'app o il file assetlinks.json. Con la correzione, ci aspettiamo che la maggior parte dei dispositivi applichi le regole dinamiche come le hai dichiarate.

Pianifica l'implementazione degli App Link

Il supporto degli app link richiede un'implementazione nella tua app, nonché un lavoro lato server per configurare il file assetlinks.json. Le attività generali di preparazione e implementazione sono elencate qui, con link ad altre risorse per i dettagli.

  • Pianifica i deep link: inizia con una valutazione dei deep link di cui hai bisogno, dei pattern URL che utilizzeranno, di come e quando li aggiornerai e dell'attività o dell'azione a cui vuoi che ogni URL venga risolto nella tua app.
  • Supporta i link dinamici alle app: offri agli utenti dei dispositivi Android più recenti la migliore esperienza possibile. Sfrutta i link alle app dinamici per gli utenti con Android 15 o versioni successive.
  • Pianifica le regole di filtro dinamico: se utilizzi gli app link dinamici, pianifica il funzionamento delle regole lato server con le regole definite staticamente nel file manifest dell'app. Tieni presente che le regole di filtro nel file assetlinks.json non possono espandere l'ambito dei filtri del file manifest dell'app. Ti consigliamo di pianificare i filtri del manifest in modo che dichiarino l'ambito più ampio possibile, per poi perfezionare le regole lato server in base alle esigenze. Per saperne di più, consulta Configura le regole dinamiche.
  • Crea e testa i filtri per intent per i tuoi link: dichiara i deep link nei filtri per intent e testa la corrispondenza dei pattern URL e la gestione degli intent in entrata. Per supportare i link per app dinamici, tieni presente che potresti dover spostare alcuni percorsi granulari nel file JSON lato server.
  • Leggi i dati dagli intent dei link alle app in arrivo: gestisci correttamente gli intent dei deep link in arrivo, risolvendoli nell'attività appropriata. L'implementazione per gli App Link è la stessa dei normali deep link, descritta in Leggi i dati dagli intent in entrata.
  • Configura le associazioni di siti web e le regole dinamiche: per supportare gli app link, devi configurare un file lato server ospitato sul tuo sito web o dominio. I dispositivi Android recupereranno questo file per convalidare l'implementazione di App Links con la tua app. Scopri di più qui.
  • Testa la verifica dei link alle app: controlla che il sistema Android sia in grado di verificare automaticamente i tuoi deep link. Utilizza il debug e i test end-to-end per verificare che la configurazione sia sicura e funzioni correttamente in tutti i percorsi degli App Link verificati.
  • Scopri gli strumenti che puoi utilizzare per configurare i link alle app, tra cui Android Studio e Play Console. Scopri di più qui.