Cos'è il Deep Linking?

Cos'è il Deep Linking

Cos'è il Deep Linking? Universal Links e App Links Spiegati | We.Inc

Il deep linking apre una schermata precisa all'interno di un'app a partire da un link. Confronta schemi URL personalizzati, Universal Links e Android App Links, e genera i due file di verifica.

Deep linking significa che un link toccato apre una schermata specifica dentro un'app, per esempio un prodotto, invece della schermata iniziale. Le app possono registrare un proprio schema come myshop://, oppure rivendicare i normali link https del tuo sito tramite Universal Links su iPhone e App Links su Android, che richiedono un file sul tuo sito.

Tre tipi di deep link

Tipo
Aspetto
Dimostra che ne sei il proprietario?

Schema URL personalizzato
myshop://product/42
No

Universal Link (Apple)
Sì, tramite apple-app-site-association

Android App Link

Se gestisci un sito web e un'app, i deep link permettono a un solo indirizzo di servire entrambi: chi ha l'app arriva sulla schermata giusta, tutti gli altri vedono la pagina web. La parte web consiste in due piccoli file JSON sul tuo dominio. Compila il modulo qui sotto per scrivere entrambi i file, poi copiali sul tuo server.

Decidi quali percorsi devono aprirsi nell'app, per esempio /product/* ma non /account/*.
Inserisci il tuo Apple team ID e il bundle ID, e il nome del pacchetto Android con l'impronta del certificato di firma.
Copia ogni file generato nella cartella /.well-known/ del tuo sito, servito via https senza redirect.
Aggiungi l'impostazione corrispondente in ciascuna app: l'entitlement Associated Domains su iOS, un intent filter con android:autoVerify="true" su Android.

Tratta ogni link in arrivo come input non affidabile. Apple avverte che gli schemi URL sono un potenziale vettore di attacco, quindi controlla i parametri e ignora quelli malformati.
Mantieni una pagina web funzionante a ogni indirizzo usato come deep link. Quando l'app manca, si apre il browser.
Se usi la firma delle app di Play, prendi l'impronta da Play Console; quella del keystore locale di solito non corrisponde.
Escludi i percorsi che devono restare nel browser, come i callback di accesso o di checkout.

Domande frequenti

I deep link sono la stessa cosa degli Universal Links?

Gli Universal Links sono un tipo di deep link: la versione di Apple che usa normali indirizzi https e un file sul tuo sito per dimostrare che il dominio è tuo. Apple considera accettabili gli schemi URL personalizzati ma raccomanda vivamente gli Universal Links.

Cosa succede se l'app non è installata?

Per un Universal Link, Apple dice che il sistema apre l'indirizzo nel browser predefinito della persona, così il tuo sito può gestirlo. Su Android un link verificato resta un normale indirizzo https, quindi senza app installata lo apre il browser. Un link con schema personalizzato non ha una pagina web di ripiego.

Dove va apple-app-site-association?

In https://yourdomain/.well-known/apple-app-site-association, senza estensione, con un certificato valido e senza redirect. Da iOS 14, i dispositivi lo recuperano tramite una rete di distribuzione dei contenuti gestita da Apple invece che direttamente dal tuo server.

Quali versioni di Android verificano gli App Links?

La documentazione Android dice che gli App Links funzionano da Android 6 in poi, sui dispositivi che hanno i servizi Google.

Come testo la verifica su Android?

Su Android 12 e versioni successive, esegui adb shell pm verify-app-links --re-verify con il nome del tuo pacchetto, attendi qualche minuto, poi adb shell pm get-app-links per vedere se il dominio risulta verificato.

Perché hanno vinto i link verificati

Qualsiasi app può registrare uno schema personalizzato, quindi due app possono rivendicare lo stesso, e su Android i semplici deep link possono far comparire una finestra di scelta. I link verificati risolvono entrambi i problemi: solo il proprietario del sito può pubblicare il file che indica l'app.
I link verificati inoltre falliscono con eleganza, perché sono veri indirizzi web che portano già da qualche parte.

Link prima che l'app sia installata

Un normale deep link non sopravvive a un'installazione: si apre lo store, la persona installa, e l'app parte dalla schermata iniziale. Portare la destinazione originale attraverso l'installazione si chiama deferred deep linking, trattato in una guida dedicata.

Regole di hosting per entrambi i file

Cosa controlla ciascuna piattaforma (a ottobre 2026)

Indirizzo

https obbligatorio
Sì, certificato valido
Sì, anche se i link dell'app sono http

Redirect consentiti
No
No (nessun 301 o 302)

Nome e tipo del file
Nessuna estensione
Servito come application/json

Impostazione lato app
Associated Domains: applinks:yourdomain
android:autoVerify="true" su un intent filter

Gestire il link dentro l'app

Intent filter Android per i link verificati

Va dentro l'activity che deve aprirsi. Sostituisci l'host con il tuo dominio.

Controllare la verifica su Android 12 o successivi

Eseguilo con un dispositivo di test collegato. Uno stato verified significa che il file è stato accettato.

Generatore dei file di verifica

Apple team ID

Bundle ID iOS

Percorsi che aprono l'app (uno per riga)

Percorsi che restano nel browser (uno per riga)

Nome del pacchetto Android

Impronta SHA-256 del certificato di firma

L'impronta non sembra composta da 32 coppie esadecimali separate da due punti.

Salva come /.well-known/apple-app-site-association (senza estensione)

Copia

Copiato

Tutto viene generato nel tuo browser a partire da ciò che scrivi. Non viene inviato nulla.

Cos'è il Deep Linking?