Vai al contenuto

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

VisitatoreVa suSe quel link manca
iPhone, iPad, iPodApp StoreLanding page
AndroidGoogle PlayLanding page
Dispositivi Huawei e Honor, HarmonyOSAppGalleryGoogle Play, poi la landing page
WindowsMicrosoft StoreLanding page
macOSApp StoreLanding page
Dispositivi non riconosciuti ("Altro")Landing page—
Linux e ChromeOSLanding 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.

Esempio: Habitly non ha un'app per Mac. Imposta macOS su Landing page, così i visitatori Mac vedono gli screenshot ed entrambi i badge degli store invece della scheda per iPhone nel Mac App Store.

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:

DestinazioneCosa 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 StoreNiente. 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.

Informazioni sulle campagne dell'App Store: App Store Connect attribuisce un token 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 storeURL
app_storemapps.one/habitly/go/app_store
google_playmapps.one/habitly/go/google_play
app_gallerymapps.one/habitly/go/app_gallery
microsoft_storemapps.one/habitly/go/microsoft_store
webmapps.one/habitly/go/web

Riferimento degli URL

URLScopo
/habitlySmart link: reindirizzamento in base al dispositivo, oppure la landing page
/habitly/pageLanding 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.zipPagina e download del press kit
/habitly/qr.svg, /habitly/qr.pngCodice 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.