Guida completa agli Universal Links

Cosa sono gli Universal Links?

Gli universal links sono URL che funzionano senza interruzioni tra web e app mobili. Quando un utente tocca un universal link su iOS, il sistema verifica se è installata un’app in grado di gestire quel link. Se l’app è installata, apre direttamente il contenuto specifico. Altrimenti il link si apre in Safari.

Su Android, la tecnologia equivalente si chiama App Links. Il concetto è lo stesso: un solo URL che instrada in modo intelligente verso app o sito web.

Come funzionano gli Universal Links

Il processo coinvolge tre componenti chiave:

Implementazione Universal Links su iOS

Passo 1: Crea il file AASA

Crea un file chiamato apple-app-site-association (senza estensione) con questa struttura: apple-app-site-association

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID.com.yourcompany.yourapp",
        "paths": [
          "/products/*",
          "/articles/*",
          "/user/*"
        ]
      }
    ]
  }
}

Passo 2: Configura la tua app iOS

In Xcode, aggiungi la capability Associated Domains con il tuo dominio:

applinks:yourdomain.com
applinks:www.yourdomain.com

Passo 3: Gestisci l’URL nella tua app

// AppDelegate.swift
func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL else {
        return false
    }
    
    // Handle the URL and navigate to appropriate screen
    handleUniversalLink(url)
    return true
}

Implementazione App Links su Android

Passo 1: Crea assetlinks.json

Ospita questo file su https://yourdomain.com/.well-known/assetlinks.json:

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.yourcompany.yourapp",
    "sha256_cert_fingerprints": [
      "XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX"
    ]
  }
}]

Passo 2: Aggiorna AndroidManifest.xml

<activity android:name=".MainActivity">
    <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" />
        <data android:host="yourdomain.com" />
        <data android:pathPrefix="/products" />
    </intent-filter>
</activity>

Passo 3: Gestisci l’Intent

// MainActivity.kt
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    val action = intent.action
    val data = intent.data
    
    if (Intent.ACTION_VIEW == action && data != null) {
        // Handle the deep link
        handleDeepLink(data)
    }
}

Best practice ed errori comuni

Test e debugging

Analytics e attribuzione

Una buona analytics è fondamentale per capire le performance dei tuoi universal links. Monitora queste metriche:

• CTR da canali diversi
• Tasso di apertura app vs fallback web
• Costo acquisizione per canale
• Tassi di conversione dei contenuti deep-linked
• Tempo alla prima azione dopo il deep link
• Performance per piattaforma (iOS vs Android)

Conclusione

Gli universal links sono essenziali per le app mobili moderne. Offrono UX fluida, migliorano l’attribuzione e funzionano in modo affidabile tra piattaforme. Anche se l’implementazione richiede attenzione, i benefici valgono lo sforzo.

Parti dalle basi, testa a fondo e migliora in base ai dati reali. Se vuoi evitare la complessità, usa una piattaforma come Appy che gestisce tutto automaticamente.