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 Links do app Android usam URLs HTTP e associação a um site, os usuários que não têm o app instalado vão diretamente ao conteúdo do seu 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. As seções a seguir descrevem cada tipo de link em 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. Isso permite que o usuário selecione um dos vários aplicativos, incluindo seu aplicativo, que pode lidar com 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. Ativado Android 12 e versões mais recentes, cliques em um link da Web (que não seja Android App Link) sempre mostra o conteúdo em um navegador da Web. Em dispositivos com versões anteriores do Android, se o app ou outros instalado no dispositivo do usuário também lida com o link da Web, mas os usuários podem diretamente no navegador. Em vez disso, eles vão ver uma caixa de diálogo de desambiguação semelhante à mostrada na Figura 2.

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 da Web. links que usam os esquemas HTTP e HTTPS e contêm o autoVerify . Esse atributo permite que o app se designe como o gerenciador padrão de um determinado tipo de link. Então, quando o usuário clica em um Link do app Android, o app abre imediatamente se estiver instalado. A caixa de diálogo de desambiguação não aparecer.

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 para apps Android Você precisa verificar a propriedade do seu domínio usando um dos nossos métodos de associação de sites.
  • Experiência do usuário perfeita: já que os Links do app Android usam um único URL HTTP para o mesmo conteúdo no site e no app, os usuários que não tiverem o app instalado basta acessar seu site em vez do app: sem erros 404 e sem erros.
  • Compatibilidade com Instant Apps Android: com o Instant Apps Android, os usuários podem executar seu app Android sem precisar instalá-lo. Para que seu app Android seja compatível com o app instantâneo, configure Links do app Android e acesse g.co/InstantApps.
  • Engajar os usuários a partir da Pesquisa Google:os usuários abrem conteúdo específico diretamente no seu app. Para isso, clique em um URL do Google em um navegador para dispositivos móveis, no app Pesquisa Google, Pesquisa direta no Android ou com o Google Assistente.

As etapas gerais para criar Links do app Android são as seguintes: segue:

  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. Adicionar verificação para links diretos:configure o app para solicitar verificação de links de apps. Em seguida, publique um arquivo JSON do 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, a O Android App Links Assistant é uma ferramenta na Android Studio que orienta você em cada uma das etapas necessárias para criar Links do app Android.

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. Após o upload do aplicativo concluído no painel (localizada em Crescer > Links diretos) exibe uma visão geral dos links diretos e 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 dos 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 a mais avançado.