Processar Android App Links

Os links diretos processam URIs de conteúdo. Os links da Web processam os esquemas HTTP e HTTPS. Os links de apps Android processam o atributo autoVerify.
Figura 1. Recursos de links diretos, da Web e Links do app Android.

Os usuários que clicam em links em dispositivos só querem uma coisa: ver o conteúdo do que acessaram. Como desenvolvedor, você pode configurar Android App Links para levar os usuários ao conteúdo específico de um link diretamente no seu app, ignorando a caixa de diálogo de seleção de app, também conhecida como caixa de diálogo de desambiguação. Como os Android App Links usam URLs HTTP e a associação com um site, os usuários que não têm o app instalado vão diretamente para o conteúdo do site.

Antes de implementar os Android App Links, é importante entender os diferentes tipos de links que você pode criar no app Android: links diretos, links da Web e Android App Links. A Figura 1 mostra a relação entre esses tipos de links, e as seções a seguir descrevem cada tipo de link com mais detalhes.

Links diretos são URIs de qualquer esquema que levam os usuários diretamente a uma parte específica do app. Para criar links diretos, adicione filtros de intent para direcionar os usuários à atividade certa no app, conforme mostrado no snippet de código abaixo:

<activity
    android:name=".MyMapActivity"
    android:exported="true"
    ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="geo" />
    </intent-filter>
</activity>

Quando o usuário clica em um link direto, uma caixa de diálogo de desambiguação pode aparecer. Essa caixa de diálogo permite que o usuário selecione um dos vários apps, incluindo o seu, que podem processar o link direto fornecido. A Figura 2 mostra a caixa de diálogo depois que o usuário clica em um link de mapa, perguntando se ele quer abrir o link no Maps ou no Chrome.

Figura 2. Caixa de diálogo de desambiguação.

Os links da Web são links diretos que usam os esquemas HTTP e HTTPS. No Android 12 e versões mais recentes, um clique em um link da Web (que não seja um Android App Link) sempre mostra conteúdo em um navegador da Web. Em dispositivos com versões anteriores do Android, se o app ou outros apps instalados no dispositivo do usuário também puderem processar o link da Web, os usuários talvez não acessem diretamente o navegador. Em vez disso, uma caixa de diálogo de desambiguação semelhante à mostrada na Figura 2 será exibida.

O snippet de código a seguir mostra um exemplo de filtro de link da Web:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="http" />
    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Os Links do app Android, disponíveis no Android 6.0 (nível 23 da API) e versões mais recentes, são links da Web que usam os esquemas HTTP e HTTPS e contêm o atributo autoVerify. Esse atributo permite que o app se designe como o gerenciador padrão de um determinado tipo de link. Assim, quando o usuário clica em um link de app Android, o app é aberto imediatamente se estiver instalado. A caixa de diálogo de desambiguação não é exibida.

Se o usuário não quiser que o app seja o gerenciador padrão, ele poderá modificar esse comportamento nas configurações do app.

O snippet de código a seguir mostra um exemplo de filtro do Android App Link:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <!-- Do not include other schemes. -->
    <data android:scheme="http" />
    <data android:scheme="https" />

    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Os Android App Links oferecem os seguintes benefícios:

  • Seguro e específico:os Android App Links usam URLs HTTP vinculados a um domínio de site que você possui. Assim, nenhum outro app pode usar seus links. Um dos requisitos dos Links do app Android é que você verifique a propriedade do seu domínio por meio de um dos nossos métodos de associação de sites.
  • Experiência do usuário perfeita:como os Android App Links usam um único URL HTTP para o mesmo conteúdo no site e no app, os usuários que não têm o app instalado acessam apenas o site, sem páginas 404 ou outros erros.
  • Compatibilidade com Instant Apps Android:com o Instant Apps Android, os usuários podem executar seu app Android sem precisar instalá-lo. Para adicionar suporte ao Instant Apps ao seu app Android, configure os Links do app Android e acesse g.co/InstantApps.
  • Engajamento dos usuários na Pesquisa Google:os usuários abrem conteúdo específico diretamente no seu app clicando em um URL do Google em um navegador para dispositivos móveis, no app Pesquisa Google, na "Pesquisa direta" no Android ou pelo Google Assistente.

As etapas gerais para a criação de Android App Links são:

  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 app para os usuários. Saiba mais em Criar links diretos para o conteúdo do app.
  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 pelo Google Search Console. Saiba mais em Verificar links de app.

Como alternativa à documentação vinculada acima, o Android App Links Assistant é uma ferramenta no Android Studio que orienta você em cada etapa necessária para criar Android App Links.

Para mais informações, consulte os seguintes recursos:

Gerenciar e verificar Links do app Android

É possível gerenciar e verificar links diretos pelo Play Console. Depois que um app é enviado, o painel (localizado em "Crescimento > Links diretos") mostra uma visão geral dos links diretos e dos erros de configuração.

Figura 3. Painel de links diretos do Play Console

O painel oferece as seguintes seções:

  • Destaques da configuração geral de links diretos
  • Todos os domínios declarados no arquivo de manifesto
  • Links da Web agrupados por caminho
  • Links com esquemas personalizados
Cada uma dessas seções mostra o status do link direto e uma maneira de corrigi-lo em caso de erro.

Consulte este guia para mais informações sobre o painel.