Sobre os links de apps

Os Links do app Android são um recurso especial de links diretos no Android 6 e versões mais recentes que permite que os URLs verificados do seu site abram o conteúdo correspondente de imediato no app para Android, sem exigir que o usuário selecione o app em uma caixa de diálogo de desambiguação. Para isso, o Android usa Digital Asset Links declarações 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 seu site diretamente para o app para processamento.

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

Por que usar os Links do app:

  • Experiência do usuário integrada: leve os usuários diretamente a conteúdos específicos no seu app a partir de resultados de pesquisa, sites, mensagens e outros apps. Como os Links do app usam um único URL para o mesmo conteúdo no seu 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 aprimorada: 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 e versões mais recentes): atualize o comportamento de links diretos 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 engajar os usuários por meio de links em resultados de pesquisa, anúncios, páginas da Web, mensagens e muito mais.

Como oferecer suporte aos 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, a fim de enviar o conteúdo certo no seu app para os usuários.
  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, você pode usar o assistente de Links do app Android no Android Studio para orientar você em cada uma das etapas necessárias para criar e verificar os Links do app Android. Para mais informações, consulte Ferramentas de desenvolvedor de Links do app.

  • 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 do app: Android 6 (nível da API 23) 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 do app funcionam

Os Links do app são uma maneira especial de links diretos que oferece controle total sobre o tratamento de links para seu próprio site. Ele é baseado no mesmo sistema de intents usado por outros tipos de links diretos, mas adiciona uma etapa de verificação para seus links usando um arquivo Digital Asset Links no seu site.

Os Links do 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 seu site ou domínio. O arquivo assetlinks.json declara instruções de Digital Asset Links 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 o app sem mostrar uma caixa de diálogo de desambiguação.

Como os Links do app usam URLs HTTP e associação a um site, os usuários que não têm o app instalado acessam diretamente o conteúdo do 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 do app são ainda mais poderosos com a introdução dos Links dinâmicos de apps. Com os Links dinâmicos de apps, você tem a opção de 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 de apps oferecem suporte a campos de 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.

Anteriormente, esse arquivo era usado principalmente para verificação básica. Agora, ele é 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, você pode definir parâmetros específicos que, se presentes em um URL, vão impedir que o 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 do app sem precisar atualizar o app, especificando os caminhos de URL que o app processa diretamente no arquivo assetlinks.json hospedado no seu servidor.

Os Links dinâmicos de apps também oferecem controle refinado sobre os URLs que você quer abrir no app, incluindo a correspondência de caminhos de URL, fragmentos e parâmetros de consulta. Você também pode 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 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 links diretos definidas no campo dynamic_app_deep_link_components na instruçã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 para o app diretamente, 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 de uma atualização do app. A busca periódica é compatível com dispositivos que executam o Android 15 (nível 35 da API) ou versões mais recentes que têm 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 vendas 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, poderá criar um URL personalizado como "/partner/influencer-name" e adicionar uma regra para ele. Em seguida, você pode rastrear, atualizar ou remover esse URL dinamicamente à medida que as parcerias mudam.
  • Caminhos de URL de testes A/B: 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 ele teste o recurso com um subconjunto de usuários e modifique 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 do app

As extensões de Links dinâmicos de apps no Android 15 foram projetadas para oferecer compatibilidade total com as implementações atuais de Links do app em dispositivos que executam versões anteriores do Android. As versões mais antigas do app não podem usar a configuração dinâmica ou os recursos de configuração. Elas vão reverter 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, você pode 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 os filtros de intent para compatibilidade com versões anteriores, consulte Compatibilidade com versões anteriores de Links dinâmicos de apps 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 expandir o escopo definido estaticamente nas regras de filtro de intent do arquivo de manifesto.

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

Planejar a implementação dos Links do app

O suporte aos Links do app exige uma implementação no app, bem como 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 para mais detalhes.

  • Planejar seus links diretos: comece com uma avaliação dos links diretos necessários, dos padrões de URL que eles vão usar, de como e quando você vai atualizá-los e da atividade ou ação que você quer que cada URL resolva no seu app.
  • Oferecer suporte a Links dinâmicos de apps: ofereça aos usuários nos 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.
  • Planejar as 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. Lembre-se de que as regras de filtro no arquivo assetlinks.json não podem expandir o escopo dos filtros do manifesto do app. Você precisa planejar para que os filtros de manifesto declarem o escopo mais amplo possível, e as regras do lado do servidor podem refinar essas regras conforme necessário. Para mais informações, consulte Configurar regras dinâmicas.
  • Criar e testar 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 tratamento 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 do app recebidas: processe as intents de links diretos recebidas corretamente, resolvendo-as para a atividade apropriada. A implementação dos Links do app é a mesma dos links diretos normais, abordada em Ler dados de intents recebidas.
  • Configurar associações de sites e regras dinâmicas: para oferecer suporte aos Links do app, é necessário 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 o app. Saiba mais aqui.
  • Testar a verificação dos Links do app: verifique 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 verificados dos Links do app.
  • Saiba mais sobre as ferramentas que você pode usar para configurar os Links do app, incluindo o Android Studio e o Play Console. Saiba mais aqui.