I Universal Links aprono Safari? Correggili con un flusso ripetibile
Se i tuoi universal links o app links aprono il browser invece dell’app, di solito il problema è un drift di configurazione, redirect o identificatori app non allineati. Qui trovi una checklist operativa riutilizzabile.
In questa guida
Perché succede
Un universal link apre l’app solo quando sono allineati tre livelli: verifica dominio, identità app e routing runtime. La maggior parte dei problemi è ripetibile e diagnosticabile.
Errore tipico: pensare che il fallback browser significhi app rotta. Spesso l’app è corretta e il problema è su dominio, CDN/proxy o catena redirect.
Diagnosi rapida in 10 minuti
- Esegui il dominio nel Universal Link Validator e salva tutti gli errori.
- Verifica i file di associazione iOS/Android da rete pubblica.
- Controlla che i percorsi well-known non siano bloccati da redirect, auth o bot challenge.
- Verifica gli identificatori contro la build production realmente rilasciata.
- Testa da in-app browser Instagram/TikTok, Safari/Chrome mobile e fallback desktop.
Cause principali e fix
| Causa | Sintomo | Fix |
|---|---|---|
| File di associazione mancante o non accessibile | Tutti i link aprono browser sulla piattaforma | Verifica che `/.well-known/apple-app-site-association` e `/.well-known/assetlinks.json` rispondano 200 senza redirect. |
| Content-type errato o comportamento CDN | Il file esiste ma la verifica fallisce | Servi JSON via HTTPS e rimuovi trasformazioni su headers/body. |
| Identificatori app non allineati alla release | Funziona in staging, fallisce in produzione | Conferma Team ID + bundle ID (iOS) e package + fingerprint (Android). |
| Catena di redirect prima della destinazione | Alcune campagne funzionano, altre no | Riduci 301/302 e punta direttamente alla destinazione HTTPS finale. |
| Comportamento in-app browser diverso per placement | Link bio ok, click ads no (o viceversa) | Testa per canale/placement e imposta fallback deterministici. |
Formati di riferimento
apple-app-site-association (iOS)
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.app",
"paths": ["/promo/*", "/product/*"]
}
]
}
}assetlinks.json (Android)
[
{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": ["AA:BB:CC:..."]
}
}
]Checklist QA pre-lancio
- AASA e assetlinks validati senza errori critici.
- Almeno un iPhone reale e un Android reale aprono correttamente l’app.
- Fallback corretto per utenti senza app installata.
- UTM e parametri campagna non si perdono nella catena.
- Analytics distingue app open, store redirect e web fallback.
Workflow consigliato con strumenti
1. Valida
Esegui i check dominio con Universal Link Validator.
2. Correggi
Risolvi headers, identificatori, redirect e fallback in ordine di priorità.
3. Ritesta
Ripeti test su dispositivi reali e canali reali.
Se il problema emerge durante una campagna attiva, metti prima in sicurezza i fallback per proteggere conversioni, poi chiudi i fix deep link in parallelo.
Domande frequenti
Perché funziona per alcuni utenti ma non per altri?
Spesso per differenze di versione app/OS o contesto in-app browser. Valida per segmento.
I redirect possono rompere i universal links?
Sì. Redirect aggiuntivi possono rompere la verifica o il comportamento runtime.
Basta testare su simulatori?
No. La validazione finale va fatta su dispositivi reali e contesti reali.
Continua a esplorare
Deep Linking vs Universal Links: confronto completo
Comprendi le differenze chiave tra deep link e universal link, quando usare ciascun approccio e come implementarli correttamente.
Guida completa agli Universal Links per iOS e Android
Guida completa a universal links, deep links e app links: implementazione e best practice per il mobile marketing.
Deep link da Instagram e TikTok per installazioni app: instrada traffico verso app, store o web
Scopri come instradare il traffico da Instagram Stories, profilo e ads, e dalla bio/ads di TikTok verso deeplink, store o una pagina web di fallback.
Cerchi altro? Sfoglia tutti gli argomenti su il blog di Appy.
Valida prima di ogni lancio
Passa il dominio nel validator, correggi per priorità e lancia campagne senza sorprese.