Formati dei link di App Store, Google Play e AppGallery: la guida di riferimento
Tutte le URL canoniche, legacy e a schema dei tre store principali: cosa fa ciascuna forma, dove muore e gli errori di encoding che divorano in silenzio i dati di campagna. Fatta per essere salvata nei segnalibri.
Perché i formati dei link mordono
Ogni store mantiene almeno tre forme di URL per la stessa scheda: una URL https canonica, una forma legacy tenuta in vita dai redirect e uno schema per dispositivo che salta del tutto il browser. Sembrano intercambiabili. Non lo sono. Gli schemi sono link morti sul sistema operativo sbagliato, le forme legacy dipendono da redirect che non controlli, e le canoniche nascondono opzioni — codici paese, parametri referrer — che cambiano il comportamento in silenzio.
Questa pagina le elenca tutte con valori segnaposto: a cosa serve ogni forma e dove esattamente fallisce. I formati sono costanti; cambiano solo le campagne intorno.
Apple App Store
Una regola risolve tutti i link Apple: la risoluzione è ancorata all’id numerico. Il segmento {app-name} nel percorso è cosmetico — scrivilo male, sostituiscilo, eliminalo: finché id{appId} è intatto, il link atterra sulla stessa scheda.
https://apps.apple.com/{country}/app/{app-name}/id{appId}https://apps.apple.com/app/id{appId}https://itunes.apple.com/app/id{appId}itms-apps://itunes.apple.com/app/id{appId}- Il codice paese è di due lettere minuscole (us, it, de). Ancora il link a un solo storefront — un account registrato altrove riceve un errore di disponibilità anche se l’app è pubblicata nel suo store.
- Omettere il segmento paese lascia che Apple risolva lo storefront dal visitatore. Per tutto ciò che è globale è il default corretto, non un compromesso.
- Le URL legacy itunes.apple.com reindirizzano ancora ad apps.apple.com. I vecchi link continuano a funzionare; non crearne di nuovi in quel formato.
- itms-apps:// apre direttamente l’app App Store, saltando il passaggio nel browser. Su iOS elimina un redirect visibile; su Android o desktop è un link morto. Usalo solo dove controlli la piattaforma.
Google Play
Su Play la risoluzione è ancorata al nome del package — il parametro id. Non c’è segmento paese; Play sceglie lo storefront dall’account. Il lavoro interessante lo fanno i parametri opzionali.
https://play.google.com/store/apps/details?id={package}https://play.google.com/store/apps/details?id={package}&hl={lang}https://play.google.com/store/apps/details?id={package}&referrer=utm_source%3Dqr%26utm_campaign%3Dlaunchmarket://details?id={package}- &hl={lang} forza la lingua della scheda ignorando le impostazioni del dispositivo. Utile per uno screenshot nella documentazione; quasi sempre sbagliato in campagna — omettilo e lascia decidere al dispositivo.
- market:// apre direttamente l’app Play, senza browser. Solo Android; ovunque altro è un link morto.
Il parametro referrer: l’attribution gratuita che quasi tutti dimenticano
Tutto ciò che metti in &referrer= attraversa l’installazione e arriva alla tua app tramite la Install Referrer API di Play al primo avvio. È attribution delle installazioni senza SDK di attribution: tagga un poster con QR con utm_source%3Dqr%26utm_campaign%3Dlaunch e la tua app sa quale poster ha portato l’installazione.
Il valore va codificato per intero: = diventa %3D e & diventa %26. Lasciato grezzo, il primo & dentro la stringa referrer chiude il parametro — Play tiene utm_source in silenzio e scarta il resto, e la perdita di dati emerge solo settimane dopo nei report.
Huawei AppGallery
AppGallery conta dove i servizi Google sono assenti: dispositivi Huawei e Honor consegnati senza Play. L’id dell’app è numerico con prefisso C, preso dalla console AppGallery Connect. Sui dispositivi HMS esiste lo schema appmarket:// — con la stessa avvertenza di ogni schema: morto fuori dal dispositivo.
https://appgallery.huawei.com/app/C{appId}appmarket://details?id={package}Errori comuni
Cinque modalità di errore coprono quasi tutti i link di store rotti in circolazione.
Forzare un codice paese in una campagna globale
Gli account registrati in altri storefront ricevono errori di storefront sbagliato. Elimina il segmento e lascia che Apple risolva per posizione.
Valori referrer non codificati
Un & grezzo chiude il parametro; Play tronca in silenzio dopo la prima coppia. Codifica l’intero valore: = diventa %3D, & diventa %26.
market:// o itms-apps:// in email, QR o bio social
Gli schemi risolvono solo sul proprio sistema operativo — un 404 per tutti gli altri. Su ogni superficie multipiattaforma usa https o un link che instrada per dispositivo.
http:// invece di https://
Nel migliore dei casi un redirect in più; nel peggiore browser in-app rotti e dati referrer persi. Entrambi gli store sono https — scrivilo così.
Linkare una pagina di risultati di ricerca dello store
Le URL di ricerca cambiano ranking; il primo risultato di oggi domani potrebbe non essere la tua app. Linka la scheda canonica ancorata all’id.
2026: si irrigidiscono le regole di distribuzione, non i formati
Secondo gli annunci per sviluppatori Android di Google, il requisito di sviluppatore verificato è in rollout: accesso anticipato da ottobre 2025, disponibilità ampia a marzo 2026 e obbligatorio per le app installate fuori da Play in Brasile, Indonesia, Singapore e Thailandia da settembre 2026. Nulla di tutto ciò cambia i formati di URL qui sopra — cambia chi può distribuire app Android fuori da Play. I link alle schede Play si comportano esattamente come prima.
Quando un solo link deve servire ogni store
Assemblare questi formati a mano va benissimo quando punti a una sola piattaforma. Un annuncio solo-iOS a utenti iOS richiede una URL Apple canonica e nient’altro.
La matrice si rompe nel momento in cui una sola superficie serve tutti — un link in bio, un QR stampato, un footer email. Allora servono la URL Apple per gli iPhone, la URL Play per la maggior parte degli Android, la URL AppGallery per i dispositivi Huawei e il tuo sito web per il desktop, tutto dietro un unico link. Quel passaggio di instradamento per dispositivo è ciò che fa uno smart link, ed è ciò per cui esiste il piano gratuito di Appy: una URL, ogni dispositivo verso il suo store.
Domande frequenti
I miei link all’App Store devono includere un codice paese?
Solo se punti davvero a un unico storefront — una promozione valida solo nello store USA, per esempio. Altrimenti omettilo e lascia risolvere ad Apple; un codice fisso diventa un errore per gli account registrati altrove.
Come aggiungo dati di campagna a un link di store?
Google Play: il parametro &referrer, codificato, letto dalla tua app tramite la Install Referrer API. Apple: la URL dell’App Store non trasporta parametri di campagna per terze parti — metti gli UTM su un link intermedio che controlli e misura il clic. AppGallery non ha un canale pubblico equivalente; vale lo stesso approccio del link intermedio.
I codici QR richiedono un formato speciale?
No — un QR codifica la URL che gli dai. Ma eredita il problema del sistema singolo: un QR con URL Play è un vicolo cieco per ogni iPhone che lo scansiona. Codifica un link che instrada per dispositivo invece di una URL di store grezza.
I link itms-apps:// e market:// sono più veloci?
Sul dispositivo giusto, sì — un passaggio in meno, dritti nell’app dello store senza il lampo del browser. Fuori dal dispositivo sono link morti. Usali dove la piattaforma è garantita, come dentro la tua app iOS; usa https ovunque il pubblico sia misto.
Continua a esplorare
Scopri quale link ha portato ogni installazione: l’SDK iOS e Android di Appy
Ora Appy segue i tuoi link anche oltre lo store. Il nuovo SDK ti mostra installazioni, eventi in-app e ricavi per ogni link, QR code e campagna, e apre ai nuovi utenti la schermata giusta.
Parametri UTM per campagne di app: guida pratica
A cosa serve ogni tag UTM, un sistema di naming che resta ordinato, valori pronti per ogni canale di un’app e cosa succede davvero ai tuoi tag su App Store e Google Play.
Chrome dice a ogni server che il tuo telefono ha Android 10
Chrome su Android dichiara Android 10, modello K, per qualsiasi telefono. Cosa ha rotto nel matching dei deferred deep link, perché Critical-CH conterebbe ogni clic due volte e come i Client Hints restituiscono versione e modello reali.
Cerchi altro? Sfoglia tutti gli argomenti su il blog.
Un link per ogni store
Crea uno smart link gratuito che manda gli iPhone all’App Store, gli Android a Google Play, gli Huawei ad AppGallery e il desktop al tuo sito.
Crea uno smart link gratis