Sobre os links de apps

Os Android App Links 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 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 link direto do app na hora, com mais controle e sem precisar lançar uma nova versão.

Por que usar os links do app:

  • Experiência do usuário integrada: leve os usuários diretamente a um conteúdo específico no app a partir de resultados da pesquisa, sites, mensagens e outros apps. Como os App Links 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, sem páginas 404 ou outros erros.
  • Segurança aprimorada: os links de 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 link direto do app em tempo real, 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 dos intents e enviar os usuários ao conteúdo certo no app. Saiba mais aqui.
  2. Adicione verificação para seus links diretos: configure seu app para solicitar a verificação dos links de app. Em seguida, publique um arquivo JSON Digital Asset Links nos seus sites para verificar a propriedade.

Como alternativa, use o Android App Links Assistant no Android Studio para orientar você em cada etapa necessária para criar e verificar Android App Links. 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 App Links 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 intents 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 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 hospedado no site ou domínio. O arquivo assetlinks.json declara instruções do Digital Asset Link para verificar a associação do app.

Este é 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 de app usam URLs HTTP e associação a 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 eficientes com a introdução dos links dinâmicos de apps. Com os Dynamic App Links, você pode atualizar as regras de link direto no lado do 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 de Digital Asset Links para refinar as regras de link direto. Os dispositivos Android com os Serviços do Google instalados vão atualizar seu arquivo periodicamente e aplicar dinamicamente as novas regras de vinculação direta. 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 link direto dinâmica e robusta:

  • Suporte a exclusões: é possível 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.
  • Compatibilidade com parâmetros de consulta: com a nova funcionalidade, você pode definir parâmetros específicos que, se estiverem presentes em um URL, vão impedir que seu app seja aberto. 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 links de apps 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.

Este é 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_deep_link_components da declaração Digital Asset Links e as mescla 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 seus 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 que 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 terminar, 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, é possível rastrear, atualizar ou remover esse URL dinamicamente à 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 Dynamic App Links no Android 15 foram projetadas para total compatibilidade com implementações atuais de App Links em dispositivos que executam versões anteriores do Android. Versões mais antigas do app não podem usar a configuração dinâmica nem os recursos de configuração. Elas vão voltar para as regras declaradas no manifesto. O link direto 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 sua base de usuários.

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 em 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 refinamento. Com essa configuração ideal, você poderá adicionar novos App Links dinamicamente que se encaixam no amplo escopo definido no manifesto.

Planejar a implementação dos Links do app

Para oferecer suporte aos Links do app, é 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.

  • Planeje 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 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 do app 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 de apps, 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 de 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.
  • Leia dados de intents de links de apps recebidas: processe corretamente as intents de links diretos recebidas, resolvendo-as para a atividade apropriada. 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 de app com seu app. Saiba mais aqui.
  • Teste a verificação de links de apps: 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 está segura e funcionando corretamente em todos os caminhos verificados de links de apps.
  • 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.