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, които се използват в приложението. Този процес е напълно автоматичен и не изисква допълнителен код от разработчика — достатъчно е правилно да настроите задълбочените връзки в манифеста.

Кои 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, брой показвания в търсенето и кликвания. За подробна проверка използвайте Search Console Google, където се показват грешки при индексиране и препоръки. Можете също да извършите търсене по site:https://your-app.page.link в Google, за да видите индексираните страници на приложението.

Най-добри практики за индексиране

Ефективно индексиране на приложението изисква спазване на няколко ключови практики. Всички URI, които искате да индексирате, трябва да водят до реално съдържание — без страници-заглушки, празни екрани или страници с грешки. Препоръчва се индексиране само на публично съдържание и неиндексиране на страници, изискващи оторизация. Всеки URI трябва да има четливо име и описание на езика на потребителя.

Какво да индексирате

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

Оптимизация за търсене

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