Sobre os links de apps

Os Links do app Android são um recurso especial de vinculação direta no Android 6 e versões mais recentes que permite que os URLs verificados do seu site abram imediatamente o conteúdo correspondente no seu app Android, sem exigir que o usuário selecione o app em uma caixa de diálogo de desambiguação. Para isso, o Android usa declarações de Digital Asset Links hospedadas no seu site para estabelecer uma associação segura e verificada entre ele e o app. Depois de verificar a associação, o Android pode encaminhar automaticamente os links diretos do seu site diretamente para o app para processamento.

A partir do Android 15, os Links do app ficam ainda mais eficientes com a introdução dos Links dinâmicos do app. Com os novos recursos dinâmicos, você pode refinar os comportamentos de links diretos do app na hora, com mais controle e sem precisar lançar uma nova versão.

Por que usar links de apps:

  • Experiência do usuário integrada: leve os usuários diretamente para um conteúdo específico no seu app nos resultados da pesquisa, sites, mensagens e outros apps. Como os Links do app usam um único URL para o mesmo conteúdo no site e no app, os usuários que não têm o app instalado acessam o site. Não há erros 404.
  • Segurança reforçada: os links do app exigem a verificação da propriedade do domínio, impedindo que outros apps interceptem seus links.
  • Configuração dinâmica (Android 15 ou mais recente): atualize o comportamento de links diretos do app na hora, permitindo mais flexibilidade e atualizações mais rápidas para itens como URLs personalizados, campanhas sazonais ou links específicos do usuário.
  • Engajamento: você pode interagir com os usuários usando links em resultados da pesquisa, anúncios, páginas da Web, mensagens e muito mais.

Como oferecer suporte a Links do app

  1. Crie links diretos para conteúdo específico no seu app: no manifesto do app, crie filtros de intent para os URIs do seu site e configure o app para usar dados das intents e enviar os usuários ao conteúdo certo no app.
  2. Adicione a verificação aos seus links diretos: configure o app para solicitar a verificação dos Links do app. Em seguida, publique um arquivo JSON do Digital Asset Links nos seus sites para verificar a propriedade.

Como alternativa, use o Assistente de Links do App Android no Android Studio para orientar você em cada uma das etapas necessárias para criar e verificar Links do App Android. Para mais informações, consulte Ferramentas para desenvolvedores de Links do app.

  • Links dinâmicos do app: Android 15 (nível 35 da API) ou versões mais recentes em dispositivos com os Serviços do Google instalados.
  • Links do app – Android 6 (nível 23 da API) e versões mais recentes em dispositivos com os serviços do Google instalados.
  • Link direto normal (gerenciado pelo usuário): todas as versões do Android, em todos os dispositivos.

Como os links do app funcionam

Os links de apps são uma forma especial de link direto que oferece controle total sobre o processamento de links para seu próprio site. Ele se baseia no mesmo sistema de intenção usado por outros tipos de links diretos, mas adiciona uma etapa de verificação aos seus links usando um arquivo Digital Asset Links no seu site.

Os links de app criam uma associação segura e confiável entre o app e o site usando dados do app e um arquivo assetlinks.json especial hospedado no site ou domínio. O arquivo assetlinks.json declara instruções de Digital Asset Link para verificar a associação do app.

Confira o fluxo conceitual:

  1. O manifesto do app declara URLs em um filtro de intent com android:autoVerify="true" e aponta para o host do seu site.
  2. Quando o app é instalado, o sistema Android busca o arquivo assetlinks.json em um local conhecido no seu servidor da Web.
  3. O sistema verifica se o arquivo assetlinks.json é válido e se o sha256_cert_fingerprints corresponde ao certificado de assinatura do app.
  4. Quando o usuário clica em um link correspondente, o sistema o direciona diretamente para seu app, sem mostrar uma caixa de diálogo de desambiguação.

Como os Links do app usam URLs HTTP e associação com um site, os usuários que não têm o app instalado vão direto para o conteúdo do site. Dessa forma, os Links do app oferecem uma experiência confiável e integrada para os usuários que tocam em links diretos para suas propriedades da Web.

A partir do Android 15, os links de apps ficam ainda mais poderosos com a introdução dos links dinâmicos de apps. Com os links dinâmicos do app, você pode atualizar as regras de links diretos no lado do servidor, no arquivo assetlinks.json, sem precisar publicar uma nova versão do app. Os links dinâmicos do app são compatíveis com os campos de links de recursos digitais para refinar as regras de links diretos. Os dispositivos Android com os Serviços do Google instalados vão atualizar seu arquivo periodicamente e aplicar as novas regras de vinculação direta de maneira dinâmica. Não é necessário atualizar o app.

Antes, esse arquivo era usado principalmente para verificação básica. Agora, é uma ferramenta de configuração avançada que permite especificar caminhos, parâmetros de consulta, fragmentos e exclusões, oferecendo uma solução de vinculação direta dinâmica e robusta:

  • Suporte a exclusões: você pode especificar determinados caminhos ou seções de um URL que não devem abrir seu app, mesmo que correspondam à configuração de vínculo do app.
  • Suporte a parâmetros de consulta: com a nova funcionalidade de parâmetros de consulta, você pode definir parâmetros específicos que, se presentes em um URL, impedem a abertura do app. Isso abre possibilidades interessantes para exclusões dinâmicas, testes A/B e ativação gradual da vinculação de apps para determinados segmentos de usuários.
  • Atualizações dinâmicas: faça atualizações na configuração dos App Links sem precisar atualizar o app especificando os caminhos de URL que ele processa diretamente no arquivo assetlinks.json hospedado no servidor.

Os links dinâmicos para apps também oferecem controle refinado sobre os URLs que você quer abrir no app, incluindo correspondência para caminhos, fragmentos e parâmetros de consulta de URL. Você também pode excluir qualquer uma das correspondências para que elas não possam abrir seu app. Para mais informações, consulte Configurar regras dinâmicas.

Confira o fluxo conceitual dos links dinâmicos de apps:

  1. O manifesto do app declara URLs em um filtro de intent com android:autoVerify="true" e aponta para o host do seu site.
  2. Quando o app é instalado, o sistema Android busca o arquivo assetlinks.json em um local conhecido no seu servidor da Web.
  3. O sistema verifica se o arquivo é válido e se o sha256_cert_fingerprints corresponde ao certificado de assinatura do app.
  4. O sistema analisa todas as regras de link direto definidas no campo dynamic_app_link_components da declaração de Digital Asset Links e as combina com as regras declaradas no manifesto.
    1. Quando o usuário clica em um link correspondente, o sistema o direciona diretamente para seu app, sem mostrar uma caixa de diálogo de desambiguação.
  5. O sistema busca novamente o arquivo assetlinks.json periodicamente para receber as regras mais recentes, permitindo que você atualize os links sem precisar atualizar o app. A nova busca periódica é compatível com dispositivos que executam o Android 15 (nível 35 da API) ou versões mais recentes e têm os Serviços do Google instalados.

Exemplos de casos de uso

  • Campanhas de marketing sazonal: um app de varejo pode adicionar uma regra para "/promo/summer-sale" ao arquivo assetlinks.json para direcionar os usuários a uma tela de venda específica. Quando a promoção acabar, a regra poderá ser removida sem exigir que os usuários atualizem o app.
  • URLs personalizados para parceiros: se você tiver uma parceria com um influenciador, crie um URL personalizado, como "/partner/influencer-name", e adicione uma regra para ele. Depois, você pode rastrear, atualizar ou remover esse URL de forma dinâmica à medida que as parcerias mudam.
  • Testes A/B com caminhos de URL: um desenvolvedor pode publicar um novo recurso em um caminho de URL específico e adicionar uma regra para ele no arquivo assetlinks.json. Isso permite que eles testem o recurso com um subconjunto de usuários e modifiquem o roteamento sem uma implantação completa do app.
  • Eventos de curta duração: um app de ingressos ou eventos pode adicionar regras de URL para eventos específicos. Depois que o evento passar, você poderá excluir essas regras do servidor.

Compatibilidade com implementações de links de apps

As extensões de links dinâmicos de apps no Android 15 foram projetadas para total compatibilidade com implementações atuais de links de apps em dispositivos que executam versões anteriores do Android. Versões mais antigas não podem usar a configuração dinâmica ou os recursos de configuração. Elas vão voltar para as regras declaradas no manifesto. O link do app ainda pode abrir o app corretamente ou reverter normalmente para a Web para usuários em versões anteriores do Android. Na maioria dos casos, é possível implantar regras dinâmicas com segurança sem afetar a experiência do restante da base de usuários. Para mais detalhes sobre como configurar seus filtros de intent para compatibilidade com versões anteriores, consulte Compatibilidade com versões anteriores de Links Dinâmicos do App para Android 14 e versões anteriores.

Considerações para configurar regras de filtragem de links dinâmicos de apps

Se você estiver configurando filtros de intent para uso com links dinâmicos de apps no Android 15 e versões mais recentes, lembre-se de que as regras de roteamento no nível do caminho definidas no arquivo assetlinks.json do lado do servidor não podem expandir o escopo que você definiu estaticamente nas regras de filtro de intent do arquivo de manifesto.

Por isso, recomendamos configurar o escopo mais amplo possível nos filtros de intent do manifesto e usar as regras do assetlinks.json do lado do servidor para mais refinamentos. Com essa configuração ideal, você poderá adicionar novos Links do app dinamicamente que se encaixam no amplo escopo definido no manifesto.

Correção de confiabilidade para regras dinâmicas

Em setembro de 2026, corrigimos um problema no Google Play Services que impedia intermitentemente alguns dispositivos com Android 15 (nível 35 da API) e versões mais recentes de aplicar as regras dinâmicas no seu arquivo assetlinks.json. Quando o problema ocorreu, os dispositivos afetados usaram apenas os filtros de intent declarados no manifesto do app. Assim, os URLs excluídos pelas regras dinâmicas podiam abrir o app. Não é necessário mudar o app nem o arquivo assetlinks.json. Com a correção, esperamos que a maioria dos dispositivos aplique as regras dinâmicas conforme você as declarou.

Planejar a implementação dos links do app

Para oferecer suporte a Links de apps, é necessário fazer uma implementação no app e trabalhar no lado do servidor para configurar o arquivo assetlinks.json. As tarefas gerais de preparação e implementação estão listadas aqui, com links para outros recursos com detalhes.

  • Planejar seus links diretos: comece com uma avaliação dos links diretos que você precisa, os padrões de URL que eles vão usar, como e quando você vai atualizá-los e a atividade ou ação que você quer que cada URL resolva no seu app.
  • Compatibilidade com Dynamic App Links: ofereça aos usuários dos dispositivos Android mais recentes a melhor experiência possível. Aproveite os links dinâmicos de apps para usuários do Android 15 ou versões mais recentes.
  • Planeje suas regras de filtro dinâmico: se você estiver usando links dinâmicos do app, planeje como as regras do lado do servidor vão funcionar com as regras definidas estaticamente no manifesto do app. As regras de filtro no arquivo assetlinks.json não podem expandir o escopo dos filtros do manifesto do app. Planeje os filtros de manifesto para declarar o escopo mais amplo possível. Depois, as regras do lado do servidor podem refinar essas regras conforme necessário. Para mais informações, consulte Configurar regras dinâmicas.
  • Crie e teste filtros de intent para seus links. Declare seus links diretos em filtros de intent e teste a correspondência de padrões de URL e o processamento de intents recebidas. Para oferecer suporte a links dinâmicos de apps, talvez seja necessário mover alguns caminhos refinados para o arquivo JSON do lado do servidor.
  • Ler dados de intents de links de apps recebidos: processe corretamente os intents de links diretos recebidos, resolvendo-os para a atividade adequada. A implementação dos links de apps é a mesma dos links diretos normais, abordada em Ler dados de intents recebidos.
  • Configurar associações de sites e regras dinâmicas: para oferecer suporte aos links de apps, você precisa configurar um arquivo do lado do servidor hospedado no seu site ou domínio. Os dispositivos Android vão recuperar esse arquivo para validar a implementação dos Links do app com seu app. Saiba mais aqui.
  • Teste a verificação de Links do app. Verifique se o sistema Android consegue fazer a verificação automática dos seus links diretos. Use a depuração e os testes de ponta a ponta para verificar se a configuração está segura e funcionando corretamente em todos os caminhos de links do app verificados.
  • Saiba mais sobre as ferramentas que você pode usar para configurar links para apps, incluindo o Android Studio e o Play Console. Saiba mais aqui.