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 відбиток сертифіката підпису додатка. 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("Індекс", "OK"))
            .addOnFailureListener(e ->
                Log.e("Індекс", "Помилка", 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 (Модуль: 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, кількість показів у пошуку та кліків. Для детальної перевірки використовуйте Google Search Console, де відображаються помилки індексації та рекомендації. Також можна виконати пошук за запитом site:https://your-app.page.link у Google, щоб побачити проіндексовані сторінки додатка.

Кращі практики індексації

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

Що індексувати

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

Оптимізація для пошуку

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