Aprire i link nella tua app (deep linking)

Richiede modifiche alla tua app

1. Passo 1

   Prima di iniziare

   Questo richiede di caricare due file, cosa che puoi fare da solo se hai i valori che servono, ma le modifiche all’app e le nuove versioni richiedono uno sviluppatore. Ti serve un dominio personalizzato attivo — vedi Configurare un dominio personalizzato.
2. Passo 2

   Aggiungi il file iOS

   In Settings > Custom Domains, apri il dominio e il suo pannello Open in app, e scegli Build it for me accanto a iOS. Inserisci due valori della tua app:
   • App ID Prefix — dieci caratteri, in Membership su developer.apple.com (di solito il tuo Team ID)
   • Bundle ID — da Xcode, come com.example.app
   Controlla il file e salvalo. Se hai già un file apple-app-site-association, carica quello.

   

3. Passo 3

   Aggiungi il file Android

   Google Play Console mostra il file della tua app: nella pagina App integrity dell’app, in App signing, copia il Digital Asset Links JSON. Salvalo come assetlinks.json e caricalo accanto ad Android nello stesso pannello.

   

4. Passo 4

   Indica il dominio nell’app iOS

   In Xcode, apri Signing & Capabilities del tuo target, aggiungi Associated Domains e aggiungi una voce per il tuo dominio:

   applinks:get.example.com

   Poi gestisci il link in arrivo nell’app — l’URL arriva come user activity — e mostra il contenuto corrispondente. Apple descrive entrambe le cose in Supporting associated domains.
5. Passo 5

   Indica il dominio nell’app Android

   In AndroidManifest.xml, aggiungi un intent filter all’activity che deve aprire i link:

   <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" />
     <data android:scheme="https" android:host="get.example.com" />
   </intent-filter>

   Poi gestisci il link in arrivo in quell’activity e mostra il contenuto corrispondente. Google descrive entrambe le cose in Verify Android App Links.
6. Passo 6

   Scegli quali link aprono quale app

   Con la configurazione sopra, ogni link del dominio apre la tua app. Per aprire solo alcuni link, o per condividere il dominio tra più app, associa percorsi specifici a ciascuna app:
   • iOS: la tua app indica solo il dominio. Il file caricato stabilisce quali percorsi aprono quale app.
   • Android: la tua app indica il dominio e i suoi percorsi. Il file caricato elenca solo le app che possono usare il dominio.
   Su iOS, scrivi un tuo apple-app-site-association con i percorsi di ciascuna app, o con una regola di esclusione per togliere un singolo link, e caricalo. Non serve aggiornare l’app. Le nuove installazioni ricevono la modifica entro circa un giorno, e le app già installate la ricevono nei giorni successivi.
   Su Android, i percorsi sono nell’intent filter di ciascuna app, come android:pathPrefix="/webshop", quindi una modifica richiede un aggiornamento dell’app.
7. Passo 7

   Prima carica, poi pubblica

   Metti entrambi i file al loro posto prima che le nuove versioni dell’app arrivino negli store. Android verifica il dominio una sola volta, quando l’app viene installata o aggiornata, e Apple ricorda un file mancante per circa un giorno — un’app pubblicata prima che il suo file sia online non aprirà i link per i suoi primi utenti.
8. Passo 8

   Prova su un dispositivo

   Digitare il link nella barra degli indirizzi del browser non apre le app, su nessuna delle due piattaforme. Installa invece la nuova build e tocca un link al tuo dominio in Note, Messaggi o un’email.
   Un tocco che apre l’app va direttamente all’app, quindi non compare nelle statistiche del tuo Onelink.