Nozioni di base
Smart link e reindirizzamenti
Il tuo smart link, mapps.one/habitly, esamina il dispositivo di ogni visitatore e decide dove indirizzarlo in pochi millisecondi. Questa pagina spiega le regole predefinite, come modificarle, cosa vedono i bot delle anteprime dei link e come i tag delle campagne arrivano fino agli store.
Instradamento predefinito
| Visitatore | Va su | Se quel link manca |
|---|---|---|
| iPhone, iPad, iPod | App Store | Landing page |
| Android | Google Play | Landing page |
| Dispositivi Huawei e Honor, HarmonyOS | AppGallery | Google Play, poi la landing page |
| Windows | Microsoft Store | Landing page |
| macOS | App Store | Landing page |
| Dispositivi non riconosciuti ("Altro") | Landing page | — |
| Linux e ChromeOS | Landing page | — |
Il dispositivo viene rilevato dallo user agent del browser. I tablet seguono le stesse regole dei telefoni con lo stesso sistema. Gli iPad che richiedono i siti desktop si identificano come Mac, e arrivano comunque all'App Store perché macOS va lì per impostazione predefinita.
Regole di reindirizzamento
Apri la scheda Link dell'app per scegliere una destinazione per ciascuna di queste piattaforme: iOS, Android, Huawei, Windows, macOS e Altro. Le opzioni sono:
- App Store, Google Play, AppGallery o Microsoft Store: reindirizza a quella scheda dello store,
- URL web: reindirizza all'indirizzo web salvato nell'app, ad esempio una versione web o una lista d'attesa,
- Landing page: mostra la landing page all'indirizzo dello smart link.
Se la destinazione scelta non ha un link salvato, il visitatore passa a un'alternativa: i visitatori Huawei provano Google Play e poi la landing page, tutti gli altri vedono la landing page. L'anteprima delle regole nella dashboard mostra dove arriva ogni piattaforma in questo momento e segnala le righe che usano un fallback.
I reindirizzamenti usano HTTP 302 con Cache-Control: no-store, quindi browser e proxy non li memorizzano nella cache e le modifiche alle regole si applicano già alla visita successiva.
Anteprime dei link e bot
Quando qualcuno incolla il tuo link in una chat o in un post, l'app recupera la pagina per creare un'anteprima. Questi crawler ricevono sempre la landing page, mai un reindirizzamento, quindi l'anteprima mostra il nome della tua app, lo slogan e l'immagine presi dai tag Open Graph della pagina. Questo vale, tra gli altri, per Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom e Microsoft Teams.
Anche i crawler dei motori di ricerca, gli strumenti SEO, i servizi di monitoraggio dell'uptime, i crawler di intelligenza artificiale e i client a riga di comando come curl, wget o python-requests vengono trattati come bot. I bot ricevono la landing page e non vengono mai conteggiati nelle statistiche.
Browser in-app
I link aperti all'interno di Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit e Threads vengono riconosciuti. Il visitatore viene indirizzato in base al dispositivo come in qualsiasi altra visita. Nelle statistiche, l'app da cui proviene viene registrata come sorgente di traffico, anche se di solito questi browser non inviano alcuna provenienza.
Tag delle campagne
Aggiungi i tag UTM standard al tuo smart link per confrontare i canali:
https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launch
mapps.one registra sempre utm_source, utm_medium e utm_campaign nelle tue statistiche. Con Inoltra i parametri della campagna agli store attivo (l'impostazione predefinita), i tag vengono passati anche alla destinazione, nel formato che questa comprende:
| Destinazione | Cosa aggiungiamo |
|---|---|
| Google Play | Un parametro referrer che contiene i tag UTM codificati per URL, che la tua app può leggere con la Play Install Referrer API.https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch |
| App Store | Un token di campagna ct: il valore di utm_campaign, oppure di utm_source quando non c'è una campagna, fino a 40 caratteri.https://apps.apple.com/app/id1612345678?ct=launch |
| URL web | Gli stessi tag UTM.https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch |
| AppGallery, Microsoft Store | Niente. La scheda si apre senza parametri aggiuntivi. |
Vengono inoltrati tutti e cinque i tag: utm_source, utm_medium, utm_campaign, utm_term e utm_content. Ogni valore viene troncato a 100 caratteri.
ct a una campagna solo quando il link contiene anche il tuo provider token (pt). I link agli store vengono salvati in forma canonica, quindi un pt incollato nel tuo link dell'App Store non viene mantenuto. Usa la suddivisione per campagna nelle statistiche di mapps.one per confrontare i canali.Link dei badge degli store
I badge degli store sulla landing page puntano a un reindirizzamento tracciato, mapps.one/habitly/go/{store}. Il clic viene conteggiato come clic sullo store, poi il visitatore viene inviato alla scheda. Se l'app non ha un link per quello store, il visitatore viene riportato alla landing page.
Puoi usare tu stesso questi URL quando vuoi uno store specifico indipendentemente dal dispositivo, ad esempio in una campagna solo per Android. I tag UTM aggiunti a un URL /go/ vengono inoltrati come sullo smart link.
| Chiave dello store | URL |
|---|---|
app_store | mapps.one/habitly/go/app_store |
google_play | mapps.one/habitly/go/google_play |
app_gallery | mapps.one/habitly/go/app_gallery |
microsoft_store | mapps.one/habitly/go/microsoft_store |
web | mapps.one/habitly/go/web |
Riferimento degli URL
| URL | Scopo |
|---|---|
/habitly | Smart link: reindirizzamento in base al dispositivo, oppure la landing page |
/habitly/page | Landing page su tutti i dispositivi |
/habitly/go/{store} | Reindirizzamento tracciato a uno store |
/habitly/open/{path} | Deep link nell'app installata |
/habitly/privacy, /habitly/privacy/{language} | Informativa sulla privacy |
/habitly/terms, /habitly/terms/{language} | Termini di servizio |
/habitly/press, /habitly/press.zip | Pagina e download del press kit |
/habitly/qr.svg, /habitly/qr.png | Codice QR per lo smart link |
Quando un link non funziona
- 404 Not Found: nessuna app usa questo slug. Controlla come è scritto, o se lo slug è stato cambiato.
- 410 Gone, "in pausa": l'app è in pausa nella dashboard. Riattivala.
- 410 Gone, "non più disponibile": l'app è stata sospesa dal team per la fiducia e la sicurezza. Contatta l'assistenza.
- Sempre la landing page: la destinazione della piattaforma non ha un link salvato, la regola è impostata su Landing page, oppure stai facendo i test con un client simile a un bot.