O que é deep linking?

O que é deep linking

O que é deep linking? Universal Links e App Links explicados | We.Inc

Deep linking abre uma tela específica dentro de um app a partir de um link. Compare esquemas de URL próprios, Universal Links e Android App Links e gere os dois arquivos de verificação.

Deep linking significa que um link tocado abre uma tela específica dentro de um app, como um produto, em vez da tela inicial do app. Os apps podem registrar um esquema próprio como myshop:// ou assumir links https normais do seu site por meio de Universal Links no iPhone e App Links no Android, que exigem um arquivo no seu site.

Três tipos de deep link

Tipo
Formato
Comprova que é seu?

Esquema de URL próprio
myshop://product/42
Não

Universal Link (Apple)
Sim, via apple-app-site-association

Android App Link

Se você tem um site e um app, os deep links permitem que um único endereço sirva aos dois: quem tem o app cai na tela certa, todos os outros veem a página web. A parte web disso são dois pequenos arquivos JSON no seu domínio. Preencha o formulário abaixo para gerar os dois arquivos e depois copie-os para o seu servidor.

Decida quais caminhos devem abrir no app, por exemplo /product/* mas não /account/*.
Preencha o seu team ID da Apple e o bundle ID, e o nome do pacote Android e a impressão digital do certificado de assinatura.
Copie cada arquivo gerado para a pasta /.well-known/ do seu site, servido por https e sem redirecionamentos.
Adicione a configuração correspondente em cada app: o entitlement Associated Domains no iOS e um intent filter com android:autoVerify="true" no Android.

Trate todo link recebido como entrada não confiável. A Apple alerta que esquemas de URL são um possível vetor de ataque, então valide os parâmetros e ignore os malformados.
Mantenha uma página web funcionando em cada endereço com deep link. Quando o app não está instalado, o navegador a abre.
Se você usa a Assinatura de apps do Google Play, pegue a impressão digital no Play Console; a da sua keystore local normalmente não vai bater.
Exclua caminhos como callbacks de login ou de checkout que precisam ficar no navegador.

Perguntas frequentes

Deep links são a mesma coisa que Universal Links?

Universal Links são um tipo de deep link: a versão da Apple que usa endereços https comuns e um arquivo no seu site para provar que o domínio é seu. A Apple considera esquemas de URL próprios aceitáveis, mas recomenda fortemente os Universal Links.

O que acontece se o app não estiver instalado?

Para um Universal Link, a Apple diz que o sistema abre o endereço no navegador padrão da pessoa para que o seu site cuide dele. No Android, um link verificado continua sendo um endereço https comum, então sem o app instalado o navegador o abre. Um link de esquema próprio não tem página web para onde voltar.

Onde fica o apple-app-site-association?

Em https://yourdomain/.well-known/apple-app-site-association, sem extensão de arquivo, com certificado válido e sem redirecionamentos. Desde o iOS 14, os dispositivos o buscam por uma rede de distribuição de conteúdo operada pela Apple, e não direto do seu servidor.

Quais versões do Android verificam App Links?

A documentação do Android diz que os App Links funcionam no Android 6 e posteriores, em dispositivos com os serviços do Google.

Como testo a verificação no Android?

No Android 12 ou mais recente, rode adb shell pm verify-app-links --re-verify com o nome do seu pacote, espere alguns minutos e depois rode adb shell pm get-app-links para ver se o domínio aparece como verificado.

Por que os links verificados venceram

Qualquer app pode registrar um esquema próprio, então dois apps podem reivindicar o mesmo, e no Android deep links simples podem abrir uma caixa de escolha de app. Links verificados resolvem os dois problemas: só o dono do site pode publicar o arquivo que nomeia o app.
Links verificados também falham com elegância, porque são endereços web reais que já levam a algum lugar.

Links antes de o app ser instalado

Um deep link normal não sobrevive a uma instalação: a loja abre, a pessoa instala e o app começa na tela inicial. Levar o destino original através da instalação se chama deferred deep linking, tema de um guia próprio.

Regras de hospedagem para os dois arquivos

O que cada plataforma verifica (em outubro de 2026)

Endereço

https obrigatório
Sim, certificado válido
Sim, mesmo que os links do app sejam http

Redirecionamentos permitidos
Não
Não (nem 301 nem 302)

Nome e tipo do arquivo
Sem extensão de arquivo
Servido como application/json

Configuração no app
Associated Domains: applinks:yourdomain
android:autoVerify="true" em um intent filter

Tratando o link dentro do app

Intent filter do Android para links verificados

Vai dentro da activity que deve abrir. Troque o host pelo seu próprio domínio.

Conferindo a verificação no Android 12 ou mais recente

Rode com um dispositivo de teste conectado. O estado verified significa que o arquivo foi aceito.

Gerador de arquivos de verificação

Team ID da Apple

Bundle ID do iOS

Caminhos que abrem o app (um por linha)

Caminhos que ficam no navegador (um por linha)

Nome do pacote Android

Impressão digital SHA-256 do certificado de assinatura

Essa impressão digital não parece ter 32 pares hexadecimais separados por dois-pontos.

Salve como /.well-known/apple-app-site-association (sem extensão)

Copiar

Copiado

Tudo é gerado no seu navegador a partir do que você digita. Nada é enviado para lugar nenhum.

O que é deep linking?