Firebase App Indexing — суть, индексация контента приложений и принцип работы

Что такое Firebase App Indexing

Firebase App Indexing — это технология Google, которая делает контент мобильного приложения доступным для поискового робота Google, позволяя индексировать экраны приложения так же, как Google индексирует веб-страницы. Когда контент приложения проиндексирован, пользователь может найти его в Google Search, Google Assistant или Google Lens и перейти непосредственно в нужный экран приложения одним нажатием, минуя веб-страницу.

Принцип индексации мобильного контента

Google индексирует приложения через два механизма: автоматическая индексация и Firebase App Indexing API. Автоматическая индексация работает на Android через Google Play Services: если приложение установлено, Google автоматически индексирует контент, к которому есть глубокие ссылки. API-индексация позволяет разработчику программно управлять тем, какой контент виден в поиске, используя Firebase App Indexing API для обновления или удаления индексированных страниц.

Зачем нужна индексация приложений

Индексация приложения решает несколько задач: привлечение новых пользователей из поиска Google (результаты поиска показывают контент из приложения в карточках). Повышение вовлечённости — существующие пользователи быстрее находят нужный контент через поиск на устройстве. Увеличение установок — поиск Google показывает глубинные ссылки на контент, и если приложение не установлено, Google отображает ссылку на установку. App Indexing также улучшает видимость приложения в Google Assistant, который может предлагать открыть приложение при голосовом поиске.

Как работает индексация контента приложений

Процесс индексации начинается с того, что Google обнаруживает URI-схемы вашего приложения. Для Android Google использует информацию из Google Play Store (API уровень, intent-filter, URI-схемы) для построения карты приложения. Для iOS индексация выполняется через Spotlight Integration и CSSearchableIndex. Когда Google индексирует контент приложения, он связывает URI (например, myapp://product/123) с веб-URL, если он существует, и сохраняет эту пару в поисковом индексе.

Связывание приложения и веб-сайта

Для корректной индексации Google должен понимать связь между вашим приложением и веб-сайтом. Digital Asset Links — это JSON-файл, который загружается на ваш веб-сайт и подтверждает, что мобильное приложение принадлежит владельцу сайта. Файл assetlinks.json размещается в корне домена и содержит SHA256 fingerprint сертификата подписи приложения. Google проверяет эту связь, прежде чем показывать кнопку открытия приложения в результатах поиска.

// 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:..."
            ]
        }
    }
]

Источники индексации

Google получает контент для индексации из нескольких источников: Google Play Store (список опубликованных приложений с их URI-схемами), Android App Links (верифицированные HTTP-схемы в Android 6.0+), Firebase App Indexing API (программное обновление индекса) и автоматическая индексация через Google Play Services на устройствах с установленным приложением. Каждый источник дополняет общий индекс, делая контент приложения максимально доступным для поиска.

Автоматическая индексация через Google Play Services

Google Play Services автоматически индексирует контент установленных приложений на Android, если приложение использует корректные URI-схемы и intent-filter. Механизм сканирует приложение на предмет intent-filter для действия VIEW и собирает URI, которые используются в приложении. Этот процесс полностью автоматический и не требует дополнительного кода со стороны разработчика — достаточно правильно настроить deep links в манифесте.

Какие URI индексируются автоматически

Google автоматически индексирует URI, которые соответствуют определённым критериям: URI должен быть доступен через intent-filter с действием VIEW, схема должна быть HTTP/HTTPS для Android App Links. URI с кастомными схемами (myapp://) также индексируются, но только при установленном приложении. Автоматическая индексация не распространяется на URI, которые ведут на страницы с авторизацией или персональными данными пользователя.

Ограничения автоматической индексации

Автоматическая индексация имеет несколько ограничений: индекс обновляется не мгновенно, а с задержкой от нескольких часов до дней. API уровень приложения — для автоматической индексации требуется minSdkVersion 23 или выше. URI без HTTP/HTTPS схемы индексируются только на устройствах с установленным приложением. Для ускорения индексации и добавления контента без веб-аналогов рекомендуется использовать Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API — это HTTP API Google, который позволяет разработчику программно управлять индексированным контентом приложения. API принимает запросы на добавление, обновление и удаление URI-страниц в индексе Google. В отличие от автоматической индексации, API работает мгновенно: после вызова Google начинает учитывать новые URI в поисковой выдаче в течение нескольких минут.

Формат запроса Firebase App Indexing API

Запрос к Firebase App Indexing API содержит объект страницы с её URI, заголовком, описанием и опциональными изображениями. Каждый URI обрабатывается как отдельная страница, которая может быть найдена через поиск Google. API использует OAuth 2.0 аутентификацию через Firebase Service Account. Для массового добавления URI поддерживается пакетная обработка до 1000 страниц в одном запросе.

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("Цена: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("Index", "OK"))
            .addOnFailureListener(e ->
                Log.e("Index", "Ошибка", e));
    }

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

Обновление и удаление контента

Когда контент в приложении меняется, необходимо обновлять индекс Google через Firebase App Indexing API. Удаление устаревшего контента также важно: если URI больше не существует или ведёт на 404, его нужно удалить из индекса. Firebase App Indexing не удаляет контент автоматически при его изменении в приложении — разработчик отвечает за синхронизацию индекса с актуальным состоянием контента. Рекомендуется вызывать API при каждом изменении данных: добавлении, редактировании или удалении товаров, статей, профилей.

Настройка App Indexing в Android

Настройка Firebase App Indexing в Android включает несколько шагов: подключение Firebase SDK, добавление зависимостей app-indexing в build.gradle, настройка Android App Links и создание сервиса для обработки URI. Минимальная версия API для работы Firebase App Indexing — 23. После настройки SDK приложение автоматически начинает отправлять данные для индексации в Google через Google Play Services.

Добавление зависимостей и конфигурация

Для Firebase App Indexing необходимо добавить в build.gradle модуля приложения зависимость com.google.firebase:firebase-appindexing и плагин google-services. Firebase автоматически обрабатывает данные индексации через Google Play Services, если приложение соответствует требованиям: minSdkVersion 23+, наличие intent-filter с HTTP/HTTPS схемами и использование Android App Links для верификации. Для URI с кастомными схемами требуется дополнительная настройка.

// build.gradle (Module: 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 и верификация

Android App Links — это HTTP/HTTPS ссылки, которые Google верифицирует как принадлежащие вашему приложению. Верификация выполняется через Digital Asset Links: файл assetlinks.json загружается на ваш веб-сайт. После верификации Android автоматически обрабатывает все ссылки с вашего домена как App Links, не запрашивая пользователя, в каком приложении открыть ссылку. Это необходимое условие для корректной индексации контента приложения.

Проверка индексации

После настройки необходимо проверить, что контент приложения действительно индексируется. Firebase Console в разделе App Indexing показывает статистику: количество индексированных URI, количество показов в поиске и кликов. Для детальной проверки используйте Search Console Google, где отображаются ошибки индексации и рекомендации. Также можно выполнить поиск по запросу site:https://your-app.page.link в Google, чтобы увидеть проиндексированные страницы приложения.

Лучшие практики индексации

Эффективная индексация приложения требует соблюдения нескольких ключевых практик. Все URI, которые вы хотите индексировать, должны вести на реальный контент — никаких заглушек, пустых экранов или страниц с ошибками. Рекомендуется индексировать только публичный контент и не индексировать страницы, требующие авторизации. Каждый URI должен иметь читаемое название и описание на языке пользователя.

Что индексировать

Индексируйте контент, который пользователи ищут в Google: карточки товаров, статьи, профили, категории меню, рецепты, события. Не индексируйте страницы с персональными данными, настройками, корзиной, историей заказов или любыми другими приватными данными. Для динамического контента (лента новостей, персонализированные подборки) используйте Firebase App Indexing API для добавления новых URI по мере их создания и удаления при удалении.

Оптимизация для поиска

Каждый индексируемый URI должен иметь осмысленный заголовок, описание и изображение для превью в результатах поиска. Используйте ключевые слова в заголовке и описании, соответствующие реальным поисковым запросам пользователей. Для изображений используйте квадратный формат 1200x1200 px и убедитесь, что они доступны по публичным URL. Регулярно обновляйте контент: Google чаще показывает в поиске свежие страницы.