Informazioni sugli app link

I link diretti per app Android sono una funzionalità speciale di deep linking in 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 richiedere all'utente di selezionare la tua app da una finestra di dialogo di disambiguazione. Per renderlo possibile, 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 link diretti dal tuo sito web direttamente alla tua app per la gestione.

A partire da Android 15, gli app link sono ancora più potenti con l'introduzione degli app link dinamici. Con le nuove funzionalità dinamiche, puoi perfezionare i comportamenti dei deep link della tua app al volo, con 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é gli app link utilizzano un unico URL per gli stessi contenuti del tuo sito web e della tua app, gli utenti che non hanno installato l'app vengono indirizzati al tuo sito web, senza ricevere errori 404 o di altro tipo.
  • Maggiore sicurezza: i link app richiedono la verifica della proprietà del dominio, impedendo ad altre app di intercettare i tuoi link.
  • Configurazione dinamica (Android 15+) – Aggiorna il comportamento di deep linking della tua app in tempo reale, consentendo maggiore flessibilità e aggiornamenti più rapidi per elementi come URL personalizzati, campagne stagionali o link specifici per gli utenti.
  • Coinvolgimento: puoi coinvolgere gli utenti tramite link nei risultati di ricerca, annunci, pagine web, messaggistica e altro ancora.

Come supportare gli app link

  1. Crea link diretti a contenuti specifici della 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 all'interno dell'app. Scopri di più qui.
  2. Aggiungi la verifica per i link diretti: configura l'app in modo che richieda la verifica dei link dell'app. 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 Android in Android Studio per guidarti in ogni passaggio necessario per creare e verificare gli app link Android. Per saperne di più, consulta Strumenti per sviluppatori di link per app.

  • Dynamic App Links: Android 15 (livello API 35) o versioni successive, su dispositivi con Google Services installato.
  • Link per le app: Android 6 (livello API 23) e versioni successive, su dispositivi con Google Services installato.
  • Link diretto 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 della gestione dei link al tuo sito web. Si basa sullo stesso sistema basato sull'intent utilizzato da altri tipi di link diretti, 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 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é gli app link utilizzano URL HTTP e l'associazione a un sito web, gli utenti che non hanno installato la tua app vengono indirizzati direttamente ai contenuti del tuo sito. In questo modo, gli app link offrono un'esperienza affidabile e fluida per gli utenti che toccano i link diretti alle tue proprietà web.

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

In precedenza, questo file veniva utilizzato principalmente per la verifica di base. Ora è uno strumento di configurazione potente 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 altrimenti corrisponderebbero alla configurazione dei link per app.
  • Supporto dei parametri di query: con la nuova funzionalità dei parametri di query puoi definire parametri specifici che, se presenti in un URL, impediranno l'apertura dell'app. Ciò apre possibilità entusiasmanti per le esclusioni dinamiche, i test A/B e l'attivazione graduale del collegamento app per determinati segmenti di utenti.
  • Aggiornamenti dinamici: apporta aggiornamenti alla configurazione degli app link senza dover aggiornare l'app specificando i percorsi URL gestiti dall'app direttamente nel file assetlinks.json ospitato sul server.

I link dinamici per app ti offrono anche un controllo granulare sugli URL che vuoi aprire la tua app, inclusa la corrispondenza per percorsi URL, frammenti e parametri della query. Puoi anche escludere una qualsiasi delle corrispondenze in modo che non sia consentito aprire la tua app. Per ulteriori informazioni, vedi Configurare le 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 tutte le regole di link diretto che hai definito nel campo dynamic_app_deep_link_components dell'istruzione 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. Una volta terminata la vendita promozionale, la regola può essere rimossa senza richiedere agli utenti di 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.
  • Percorsi URL per i test A/B: uno sviluppatore potrebbe pubblicare una nuova funzionalità in un percorso URL specifico e aggiungere una regola per questa 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 biglietti o eventi potrebbe aggiungere regole URL per eventi specifici. Una volta terminato l'evento, puoi eliminare queste regole dal server.

Compatibilità con le implementazioni dei link dell'app

Le estensioni Dynamic App Links in Android 15 sono progettate per la piena compatibilità con le implementazioni esistenti di App Links sui dispositivi con versioni precedenti di Android. Le versioni precedenti dell'app non sono in grado di utilizzare la configurazione dinamica o le funzionalità di configurazione e utilizzeranno le regole dichiarate nel manifest. Il tuo app link può comunque aprire correttamente l'app o tornare al web per gli utenti che utilizzano versioni precedenti di Android. Nella maggior parte dei casi, puoi implementare in sicurezza le regole dinamiche senza influire sull'esperienza del resto della tua base utenti.

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

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

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

Pianificare l'implementazione degli app link

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

  • Pianifica i link diretti: inizia con una valutazione dei link diretti 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 rimandi nella tua app.
  • Supporta i link dinamici per app: offri agli utenti dei dispositivi Android più recenti la migliore esperienza possibile. Sfrutta i link app dinamici per gli utenti con Android 15 o versioni successive.
  • Pianifica le regole di filtro dinamico: se utilizzi i link dinamici per app, 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. Pianifica i filtri del manifest in modo che dichiarino l'ambito più ampio possibile, quindi le regole lato server possono perfezionare queste regole in base alle esigenze. Per saperne di più, consulta Configurare le regole dinamiche.
  • Crea e testa i filtri per intent per i tuoi link: dichiara i tuoi link diretti nei filtri per intent e testa la corrispondenza dei pattern URL e la gestione degli intent in entrata. Per supportare gli app link dinamici, tieni presente che potresti dover spostare alcuni percorsi granulari nel file JSON lato server.
  • Leggi i dati dagli intent di App Link in entrata: gestisci correttamente gli intent di link diretti in entrata, risolvendoli nell'attività appropriata. L'implementazione dei link alle app è la stessa dei normali link diretti, descritta in Leggere 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 dei link alle app con la tua app. Scopri di più.
  • Verifica dei link alle app di test: controlla che il sistema Android sia in grado di verificare automaticamente i tuoi link diretti. Utilizza il debug e i test end-to-end per verificare che la configurazione sia sicura e funzioni correttamente in tutti i percorsi App Link verificati.
  • Scopri gli strumenti che puoi utilizzare per configurare gli app link, tra cui Android Studio e Play Console. Scopri di più qui.