Sobre os links de apps

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

A partir do Android 15, os links de apps estão ainda mais eficientes com a introdução dos links dinâmicos de apps. Com os novos recursos dinâmicos, você pode refinar os comportamentos de link direto do app em tempo real, com mais controle e sem precisar lançar uma nova versão do app.

Por que usar os links de apps:

  • Experiência do usuário integrada: leve os usuários diretamente para um conteúdo específico no seu app com base em 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 são direcionados ao site, sem erros 404.
  • Segurança aprimorada: os links de apps 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 em tempo real, permitindo mais flexibilidade e atualizações mais rápidas para itens como URLs curtos, campanhas sazonais ou links específicos do usuário.
  • Engajamento: você pode interagir com os usuários por 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 para enviar os usuários ao conteúdo certo no app.
  2. Adicionar verificação para seus links diretos: configure o app para solicitar a verificação de links de apps. 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 de apps.

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

Como os links de apps 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. Eles se baseiam no mesmo sistema baseado em intents usado por outros tipos de links diretos, mas adicionam uma etapa de verificação para seus links usando um arquivo Digital Asset Links no seu site.

Os links de apps criam uma associação segura e confiável entre o app e o site usando dados do app e um arquivo assetlinks.json especial que você hospeda no site ou domínio. O arquivo assetlinks.json declara as instruções do 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 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 o 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 acessam diretamente o conteúdo no seu 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 estão ainda mais avançados com a introdução dos links dinâmicos de apps. Com os Dynamic App Links, você pode atualizar as regras de links diretos no servidor, no arquivo assetlinks.json, sem precisar publicar uma nova versão do app. Os Dynamic App Links são compatíveis com os campos do Digital Asset Links para refinar as regras de links diretos. Os dispositivos Android com os Serviços do Google instalados vão atualizar o arquivo periodicamente e aplicar as novas regras de links diretos de forma 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 poderosa que permite especificar caminhos, parâmetros de consulta, fragmentos e exclusões, oferecendo uma solução de links diretos dinâmica e robusta:

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

Os links dinâmicos para apps também oferecem controle detalhado sobre os URLs que você quer que abram o app, incluindo correspondência para caminhos de URL, fragmentos e parâmetros de consulta. Também é possível excluir qualquer uma das correspondências para que elas não possam abrir o 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 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 as regras de links diretos que você definiu no campo dynamic_app_link_components na declaração do 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 o app, sem mostrar uma caixa de diálogo de desambiguação.
  5. O sistema busca novamente o arquivo assetlinks.json de forma periódica para receber as regras mais recentes, permitindo que você atualize seus links sem uma atualização do 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 com os Serviços do Google instalados.

Exemplos de casos de uso

  • Campanhas de marketing sazonais: 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 promoção específica. Quando a promoção terminar, a regra poderá ser removida sem que os usuários precisem atualizar o app.
  • URLs curtos para parceiros: se você tiver uma parceria com um influenciador, poderá criar um URL personalizado como "/partner/influencer-name" e adicionar uma regra para ele. Depois, você pode rastrear, atualizar ou remover esse URL de forma dinâmica conforme as parcerias mudam.
  • Teste A/B de caminhos de URL: um desenvolvedor pode publicar um novo recurso em um caminho do 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 venda de ingressos ou de 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 serem totalmente compatíveis com as implementações atuais de links de apps em dispositivos com versões anteriores do Android. As versões anteriores do app não podem usar a configuração dinâmica ou os recursos de configuração. Elas vão usar as regras declaradas no manifesto. O link do app ainda pode abrir o app corretamente ou recorrer à 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 sua 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 dos Links Dinâmicos do App para Android 14 e versões anteriores.

Considerações para configurar regras de filtro 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 ampliar o escopo definido 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, em seguida, usar as regras do assetlinks.json do lado do servidor para um refinamento adicional. Com essa configuração ideal, você poderá adicionar novos links de apps de forma dinâmica que se encaixem no escopo amplo definido no manifesto.

Correção de confiabilidade para regras dinâmicas

Em setembro de 2026, corrigimos um problema no Google Play Services que impedia de forma intermitente que alguns dispositivos com o Android 15 (nível 35 da API) e versões mais recentes aplicassem as regras dinâmicas no 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 puderam 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 declaradas.

Planejar a implementação dos links do app

Para oferecer suporte aos links de apps, é necessário implementar uma solução no seu app, além de realizar um trabalho do 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 mais detalhes.

  • Planejar os links diretos: comece avaliando os links diretos necessários, 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 app.
  • Suporte a links dinâmicos de apps: 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 os links dinâmicos de apps, planeje como as regras do lado do servidor vão funcionar com as regras estaticamente definidas 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 os 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 aos links dinâmicos de apps, talvez seja necessário mover alguns caminhos detalhados para o arquivo JSON do lado do servidor.
  • Ler dados de intents de links de apps recebidos: processe as intents de links diretos recebidas corretamente, resolvendo-as para a atividade adequada. A implementação de links de apps é igual à de links diretos normais, abordada em Ler dados de intents recebidas.
  • 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 aplicativo. Saiba mais aqui.
  • Testar a verificação de links do app: confira se o sistema Android consegue verificar automaticamente seus links diretos. Use a depuração e os testes de ponta a ponta para verificar se a configuração é segura e funciona corretamente em todos os caminhos de link do app verificados.
  • Saiba mais sobre as ferramentas que você pode usar para configurar links de apps, incluindo o Android Studio e o Play Console. Saiba mais aqui.