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 је Google-ов HTTP API који омогућава програмеру да програмски управља индексираним садржајем апликације. 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 чешће приказује у претрази свеже странице.