Noções básicas
Links inteligentes e redirecionamentos
Seu link inteligente, mapps.one/habitly, identifica o dispositivo de cada visitante e decide para onde enviá-lo em poucos milissegundos. Esta página explica as regras padrão, como alterá-las, o que os bots de pré-visualização de links veem e como as tags de campanha seguem até as lojas.
Roteamento padrão
| Visitante | Vai para | Se esse link estiver faltando |
|---|---|---|
| iPhone, iPad, iPod | App Store | Página de destino |
| Android | Google Play | Página de destino |
| Dispositivos Huawei e Honor, HarmonyOS | AppGallery | Google Play e depois a página de destino |
| Windows | Microsoft Store | Página de destino |
| macOS | App Store | Página de destino |
| Dispositivos não reconhecidos ("Outro") | Página de destino | — |
| Linux e ChromeOS | Página de destino | — |
O dispositivo é detectado pelo user agent do navegador. Tablets seguem as mesmas regras dos celulares do mesmo sistema. iPads que solicitam a versão para computador dos sites se identificam como Mac e mesmo assim chegam à App Store, porque o macOS vai para lá por padrão.
Regras de redirecionamento
Abra a aba Links do app para escolher um destino para cada uma destas plataformas: iOS, Android, Huawei, Windows, macOS e Outro. As opções são:
- App Store, Google Play, AppGallery ou Microsoft Store: redireciona para a ficha nessa loja,
- URL da web: redireciona para o endereço web salvo no app, por exemplo uma versão web ou uma lista de espera,
- Página de destino: mostra a página de destino no endereço do link inteligente.
Se o destino escolhido não tiver um link salvo, o visitante vai para um destino alternativo: visitantes Huawei tentam o Google Play e depois a página de destino, e todos os demais veem a página de destino. A prévia das regras no painel mostra onde cada plataforma vai parar neste momento e marca as linhas que usam um destino alternativo.
Os redirecionamentos usam HTTP 302 com Cache-Control: no-store, então navegadores e proxies não os armazenam em cache e as alterações nas regras valem a partir da próxima visita.
Pré-visualizações de links e bots
Quando alguém cola seu link em um chat ou post, o app em questão busca a página para montar uma pré-visualização. Esses rastreadores sempre recebem a página de destino, nunca um redirecionamento, então a pré-visualização mostra o nome, o slogan e a imagem do seu app a partir das tags Open Graph da página. Isso vale para Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom e Microsoft Teams, entre outros.
Rastreadores de mecanismos de busca, ferramentas de SEO, monitores de disponibilidade, rastreadores de IA e clientes de linha de comando como curl, wget ou python-requests também são tratados como bots. Bots recebem a página de destino e nunca são contados nas análises.
Navegadores no app
Links abertos dentro de Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit e Threads são reconhecidos. O visitante é direcionado de acordo com o dispositivo, como em qualquer outra visita. Nas análises, o app de onde ele veio é registrado como a origem do tráfego, mesmo que esses navegadores normalmente não enviem referência.
Tags de campanha
Adicione tags UTM padrão ao seu link inteligente para comparar canais:
https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launchO mapps.one sempre registra utm_source, utm_medium e utm_campaign nas suas análises. Com Repasse parâmetros de campanha para as lojas ativado (o padrão), as tags também são repassadas ao destino no formato que ele entende:
| Destino | O que adicionamos |
|---|---|
| Google Play | Um parâmetro referrer com as tags UTM codificadas para URL, que o seu app pode ler com a 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 | Um token de campanha ct: o valor de utm_campaign, ou de utm_source quando não há campanha, com até 40 caracteres.https://apps.apple.com/app/id1612345678?ct=launch |
| URL da web | As próprias tags UTM.https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch |
| AppGallery, Microsoft Store | Nada. A ficha abre sem parâmetros extras. |
As cinco tags são repassadas: utm_source, utm_medium, utm_campaign, utm_term e utm_content. Cada valor é cortado em 100 caracteres.
ct a uma campanha quando o link também traz o seu token de provedor (pt). Os links da loja são salvos na forma canônica, então um pt colado no seu link da App Store não é mantido. Use o detalhamento por campanha nas análises do mapps.one para comparar canais.Links dos selos da loja
Os selos da loja na página de destino apontam para um redirecionamento rastreado, mapps.one/habitly/go/{store}. O clique é contado como clique na loja e, em seguida, o visitante é enviado para a ficha. Se o app não tiver link para essa loja, o visitante volta para a página de destino.
Você mesmo pode usar essas URLs quando quiser uma loja específica independentemente do dispositivo, por exemplo em uma campanha só para Android. Tags UTM adicionadas a uma URL /go/ são repassadas da mesma forma que no link inteligente.
| Chave da loja | 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 |
Referência de URLs
| URL | Finalidade |
|---|---|
/habitly | Link inteligente: redirecionamento por dispositivo ou a página de destino |
/habitly/page | Página de destino em todos os dispositivos |
/habitly/go/{store} | Redirecionamento rastreado para uma loja |
/habitly/open/{path} | Deep link para o app instalado |
/habitly/privacy, /habitly/privacy/{language} | Política de privacidade |
/habitly/terms, /habitly/terms/{language} | Termos de serviço |
/habitly/press, /habitly/press.zip | Página e download do kit de imprensa |
/habitly/qr.svg, /habitly/qr.png | Código QR do link inteligente |
Quando um link não funciona
- 404 Not Found: nenhum app usa esse slug. Confira a grafia ou se o slug foi alterado.
- 410 Gone, "pausado": o app está pausado no painel. Reative-o.
- 410 Gone, "não está mais disponível": o app foi suspenso pela equipe de confiança e segurança. Entre em contato com o suporte.
- Sempre a página de destino: o destino da plataforma não tem link salvo, a regra está definida como Página de destino ou você está testando com um cliente que parece um bot.