Firebase App Indexing — essência da indexação de conteúdo de aplicativos e princípio de funcionamento

O que é Firebase App Indexing

Firebase App Indexing é uma tecnologia do Google que torna o conteúdo do aplicativo móvel acessível ao rastreador de pesquisa do Google, permitindo que as telas do aplicativo sejam indexadas da mesma forma que o Google indexa páginas da web. Quando o conteúdo do aplicativo é indexado, os usuários podem encontrá-lo no Google Search, Google Assistant ou Google Lens e navegar diretamente para a tela desejada do aplicativo com um clique, ignorando a página da web.

Princípio de indexação de conteúdo móvel

O Google indexa aplicativos através de dois mecanismos: indexação automática e Firebase App Indexing API. A indexação automática funciona no Android via Google Play Services: se o aplicativo estiver instalado, o Google indexa automaticamente o conteúdo que possui links profundos. A indexação por API permite ao desenvolvedor controlar programaticamente qual conteúdo fica visível na pesquisa, usando Firebase App Indexing API para atualizar ou remover páginas indexadas.

Por que a indexação de aplicativos é necessária

A indexação de aplicativos resolve várias tarefas: atrair novos usuários da pesquisa do Google (os resultados de pesquisa mostram o conteúdo do aplicativo em cartões). Maior engajamento — usuários existentes encontram o conteúdo desejado mais rapidamente através da pesquisa no dispositivo. Aumento de instalações — a pesquisa do Google mostra links profundos para o conteúdo e, se o aplicativo não estiver instalado, o Google exibe um link de instalação. O App Indexing também melhora a visibilidade do aplicativo no Google Assistant, que pode sugerir abrir o aplicativo durante a pesquisa por voz.

Como funciona a indexação de conteúdo de aplicativos

O processo de indexação começa quando o Google descobre os esquemas URI do seu aplicativo. Para Android, o Google usa informações do Google Play Store (nível de API, intent-filter, esquemas URI) para construir um mapa do aplicativo. Para iOS, a indexação é feita através do Spotlight Integration e CSSearchableIndex. Quando o Google indexa o conteúdo do aplicativo, ele vincula o URI (por exemplo, myapp://product/123) a uma URL da web, se existir, e armazena esse par no índice de pesquisa.

Vinculação do aplicativo e do site

Para uma indexação correta, o Google deve entender a relação entre seu aplicativo e o site. Digital Asset Links é um arquivo JSON que é carregado no seu site e confirma que o aplicativo móvel pertence ao proprietário do site. O arquivo assetlinks.json é colocado na raiz do domínio e contém a impressão digital SHA256 do certificado de assinatura do aplicativo. O Google verifica esse vínculo antes de mostrar o botão de abrir o aplicativo nos resultados de pesquisa.

// https://yourapp.com/.well-known/assetlinks.json
[
    {
        "relation": ["delegate_permission/common.handle_all_urls"],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.myapp",
            "sha256_cert_fingerprints": [
                "14:6D:E9:92:..."
            ]
        }
    }
]

Fontes de indexação

O Google recebe conteúdo para indexar de várias fontes: Google Play Store (lista de aplicativos publicados com seus esquemas URI), Android App Links (esquemas HTTP verificados no Android 6.0+), Firebase App Indexing API (atualização programática do índice) e indexação automática via Google Play Services em dispositivos com o aplicativo instalado. Cada fonte complementa o índice geral, tornando o conteúdo do aplicativo o mais acessível possível para a pesquisa.

Indexação automática via Google Play Services

Google Play Services indexa automaticamente o conteúdo de aplicativos instalados no Android se o aplicativo usar esquemas URI e intent-filter corretos. O mecanismo escaneia o aplicativo em busca de intent-filter com ação VIEW e coleta os URIs usados no aplicativo. Este processo é totalmente automático e não requer código adicional do desenvolvedor — basta configurar corretamente os links profundos no manifesto.

Quais URIs são indexados automaticamente

O Google indexa automaticamente URIs que atendem a certos critérios: o URI deve estar acessível via intent-filter com ação VIEW, o esquema deve ser HTTP/HTTPS para Android App Links. URIs com esquemas personalizados (myapp://) também são indexados, mas apenas quando o aplicativo está instalado. A indexação automática não se aplica a URIs que levam a páginas de autenticação ou dados pessoais do usuário.

Limitações da indexação automática

A indexação automática tem várias limitações: o índice não é atualizado instantaneamente, mas com um atraso de várias horas a dias. Nível de API do aplicativo — a indexação automática requer minSdkVersion 23 ou superior. URIs sem esquema HTTP/HTTPS são indexados apenas em dispositivos com o aplicativo instalado. Para acelerar a indexação e adicionar conteúdo sem equivalentes na web, recomenda-se usar o Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API é uma API HTTP do Google que permite ao desenvolvedor gerenciar programaticamente o conteúdo indexado do aplicativo. A API aceita requisições para adicionar, atualizar e remover páginas URI do índice do Google. Ao contrário da indexação automática, a API funciona instantaneamente: após uma chamada, o Google começa a considerar novos URIs nos resultados de pesquisa em questão de minutos.

Formato de requisição do Firebase App Indexing API

Uma requisição ao Firebase App Indexing API contém um objeto de página com seu URI, título, descrição e imagens opcionais. Cada URI é processado como uma página separada que pode ser encontrada através da pesquisa do Google. A API usa autenticação OAuth 2.0 através de uma conta de serviço do Firebase. Para adição em massa de URIs, é suportado processamento em lote de até 1000 páginas em uma única requisição.

import com.google.firebase.appindexing.FirebaseAppIndex;
import com.google.firebase.appindexing.Indexable;
import com.google.firebase.appindexing.builders.Indexables;

public class AppIndexingHelper {
    public static void indexProduct(String productId,
            String name, String price) {
        Indexable product = Indexables.newSimpleBuilder(name)
            .setUrl("myapp://product/" + productId)
            .setDescription("Preço: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("Índice", "OK"))
            .addOnFailureListener(e ->
                Log.e("Índice", "Erro", e));
    }

    public static void removeProduct(String productId) {
        FirebaseAppIndex.getInstance()
            .remove("myapp://product/" + productId);
    }
}

Atualização e remoção de conteúdo

Quando o conteúdo do aplicativo muda, é necessário atualizar o índice do Google através do Firebase App Indexing API. A remoção de conteúdo obsoleto também é importante: se um URI não existe mais ou leva a um 404, ele deve ser removido do índice. O Firebase App Indexing não remove conteúdo automaticamente quando ele muda no aplicativo — o desenvolvedor é responsável por sincronizar o índice com o estado atual do conteúdo. Recomenda-se chamar a API a cada alteração de dados: adicionar, editar ou excluir produtos, artigos, perfis.

Configuração do App Indexing no Android

A configuração do Firebase App Indexing no Android inclui várias etapas: adicionar o Firebase SDK, adicionar dependências do app-indexing no build.gradle, configurar Android App Links e criar um serviço para lidar com URIs. A versão mínima de API para Firebase App Indexing é 23. Após a configuração do SDK, o aplicativo começa automaticamente a enviar dados para indexação ao Google através do Google Play Services.

Adição de dependências e configuração

Para Firebase App Indexing, você precisa adicionar a dependência com.google.firebase:firebase-appindexing e o plugin google-services ao build.gradle do módulo do aplicativo. O Firebase processa automaticamente os dados de indexação através do Google Play Services se o aplicativo atender aos requisitos: minSdkVersion 23+, presença de intent-filter com esquemas HTTP/HTTPS e uso de Android App Links para verificação. Para URIs com esquemas personalizados, é necessária configuração adicional.

// build.gradle (Módulo: app)
plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}

android {
    defaultConfig { minSdkVersion 24 }
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0')
    implementation 'com.google.firebase:firebase-appindexing'
}

Android App Links e verificação

Android App Links são links HTTP/HTTPS que o Google verifica como pertencentes ao seu aplicativo. A verificação é feita através de Digital Asset Links: o arquivo assetlinks.json é carregado no seu site. Após a verificação, o Android lida automaticamente com todos os links do seu domínio como App Links, sem perguntar ao usuário em qual aplicativo abrir o link. Esta é uma condição necessária para a correta indexação do conteúdo do aplicativo.

Verificação de indexação

Após a configuração, é necessário verificar se o conteúdo do aplicativo está realmente sendo indexado. O Firebase Console na seção App Indexing mostra estatísticas: número de URIs indexados, número de impressões na pesquisa e cliques. Para verificação detalhada, use o Google Search Console, onde são exibidos erros de indexação e recomendações. Você também pode pesquisar site:https://your-app.page.link no Google para ver as páginas indexadas do aplicativo.

Melhores práticas de indexação

A indexação eficaz do aplicativo requer seguir várias práticas essenciais. Todos os URIs que você deseja indexar devem levar a conteúdo real — sem placeholders, telas vazias ou páginas de erro. Recomenda-se indexar apenas conteúdo público e não indexar páginas que exigem autenticação. Cada URI deve ter um nome e descrição legíveis no idioma do usuário.

O que indexar

Indexe o conteúdo que os usuários pesquisam no Google: fichas de produtos, artigos, perfis, categorias de menu, receitas, eventos. Não indexe páginas com dados pessoais, configurações, carrinho de compras, histórico de pedidos ou qualquer outro dado privado. Para conteúdo dinâmico (feed de notícias, seleções personalizadas), use o Firebase App Indexing API para adicionar novos URIs à medida que são criados e removê-los quando excluídos.

Otimização para pesquisa

Cada URI indexado deve ter um título, descrição e imagem de pré-visualização significativos para os resultados de pesquisa. Use palavras-chave no título e na descrição que correspondam às consultas de pesquisa reais dos usuários. Para imagens, use formato quadrado de 1200x1200 px e certifique-se de que estejam acessíveis através de URLs públicas. Atualize o conteúdo regularmente: o Google mostra páginas recentes com mais frequência na pesquisa.