Firebase App Indexing — esensya ng pag-index ng nilalaman ng app at prinsipyo ng paggana

Ano ang Firebase App Indexing

Firebase App Indexing ay isang teknolohiya ng Google na ginagawang accessible ang nilalaman ng mobile app sa robot ng paghahanap ng Google, na nagpapahintulot sa pag-index ng mga screen ng app tulad ng pag-index ng Google sa mga web page. Kapag ang nilalaman ng app ay nai-index, mahahanap ito ng user sa Google Search, Google Assistant, o Google Lens at direktang pumunta sa nais na screen ng app sa isang click, na lumalampas sa web page.

Prinsipyo ng pag-index ng mobile na nilalaman

Ini-index ng Google ang mga app sa pamamagitan ng dalawang mekanismo: awtomatikong pag-index at Firebase App Indexing API. Awtomatikong pag-index ay gumagana sa Android sa pamamagitan ng Google Play Services: kung naka-install ang app, awtomatikong ini-index ng Google ang nilalaman kung saan may malalalim na link. Ang pag-index ng API ay nagpapahintulot sa developer na programmatically na pamahalaan kung anong nilalaman ang nakikita sa paghahanap, gamit ang Firebase App Indexing API para sa pag-update o pagtanggal ng mga nai-index na pahina.

Bakit kailangan ang pag-index ng app

Ang pag-index ng app ay lumulutas ng ilang mga gawain: pag-akit ng mga bagong user mula sa paghahanap ng Google (ipinapakita ng mga resulta ng paghahanap ang nilalaman mula sa app sa mga card). Pagtaas ng engagement — mas mabilis na nahahanap ng mga kasalukuyang user ang nais na nilalaman sa pamamagitan ng paghahanap sa device. Pagtaas ng mga pag-install — ipinapakita ng paghahanap ng Google ang malalalim na link sa nilalaman, at kung hindi naka-install ang app, nagpapakita ang Google ng link sa pag-install. Pinapabuti rin ng App Indexing ang visibility ng app sa Google Assistant, na maaaring magmungkahi ng pagbukas ng app sa voice search.

Paano gumagana ang pag-index ng nilalaman ng app

Ang proseso ng pag-index ay nagsisimula kapag natuklasan ng Google ang mga URI scheme ng iyong app. Para sa Android, ginagamit ng Google ang impormasyon mula sa Google Play Store (antas ng API, intent-filter, mga URI scheme) upang bumuo ng mapa ng app. Para sa iOS, ang pag-index ay isinasagawa sa pamamagitan ng Spotlight Integration at CSSearchableIndex. Kapag ini-index ng Google ang nilalaman ng app, iniuugnay nito ang isang URI (hal., myapp://product/123) sa isang web URL, kung mayroon, at iniimbak ang pares na ito sa index ng paghahanap.

Pag-uugnay ng app at website

Para sa tamang pag-index, dapat maunawaan ng Google ang relasyon sa pagitan ng iyong app at website. Digital Asset Links ay isang JSON file na na-upload sa iyong website at nagkukumpirma na ang mobile app ay pag-aari ng may-ari ng site. Ang file na assetlinks.json ay inilalagay sa root ng domain at naglalaman ng SHA256 fingerprint ng sertipiko ng pag-sign ng app. Sinusuri ng Google ang ugnayang ito bago ipakita ang button na buksan ang app sa mga resulta ng paghahanap.

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

Mga pinagmumulan ng pag-index

Kumukuha ang Google ng nilalaman para sa pag-index mula sa ilang mga pinagmumulan: Google Play Store (listahan ng mga nai-publish na app na may kanilang mga URI scheme), Android App Links (na-verify na HTTP scheme sa Android 6.0+), Firebase App Indexing API (programmatic na pag-update ng index), at awtomatikong pag-index sa pamamagitan ng Google Play Services sa mga device na may naka-install na app. Bawat pinagmumulan ay bumubuo sa pangkalahatang index, na ginagawang maximum na accessible ang nilalaman ng app para sa paghahanap.

Awtomatikong pag-index sa pamamagitan ng Google Play Services

Google Play Services ay awtomatikong nag-i-index ng nilalaman ng mga naka-install na app sa Android, kung ang app ay gumagamit ng tamang URI scheme at intent-filter. Ang mekanismo ay nag-scan sa app para sa intent-filter para sa aksyong VIEW at kinokolekta ang mga URI na ginagamit sa app. Ang prosesong ito ay ganap na awtomatiko at hindi nangangailangan ng karagdagang code mula sa developer — sapat na upang i-configure nang tama ang mga deep link sa manifest.

Aling mga URI ang awtomatikong nai-index

Awtomatikong ini-index ng Google ang mga URI na nakakatugon sa ilang pamantayan: ang URI ay dapat na accessible sa pamamagitan ng intent-filter na may aksyong VIEW, ang scheme ay dapat HTTP/HTTPS para sa Android App Links. Ang mga URI na may custom na scheme (myapp://) ay nai-index din, ngunit lamang sa naka-install na app. Ang awtomatikong pag-index ay hindi nalalapat sa mga URI na tumuturo sa mga pahina na nangangailangan ng pagpapatotoo o naglalaman ng personal na data ng user.

Mga limitasyon ng awtomatikong pag-index

Ang awtomatikong pag-index ay may ilang mga limitasyon: ang index ay hindi agad naa-update, kundi may pagkaantala mula sa ilang oras hanggang ilang araw. Antas ng API ng app — para sa awtomatikong pag-index ay kinakailangan ang minSdkVersion 23 o mas mataas. Ang mga URI na walang HTTP/HTTPS scheme ay nai-index lamang sa mga device na may naka-install na app. Para sa mas mabilis na pag-index at pagdaragdag ng nilalaman na walang katumbas na web, inirerekomenda ang paggamit ng Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API ay ang HTTP API ng Google na nagpapahintulot sa developer na programmatically na pamahalaan ang nai-index na nilalaman ng app. Ang API ay tumatanggap ng mga kahilingan para sa pagdaragdag, pag-update, at pagtanggal ng mga URI page sa index ng Google. Hindi tulad ng awtomatikong pag-index, ang API ay gumagana agad: pagkatapos ng tawag, sinisimulan ng Google na isaalang-alang ang mga bagong URI sa mga resulta ng paghahanap sa loob ng ilang minuto.

Format ng kahilingan sa Firebase App Indexing API

Ang isang kahilingan sa Firebase App Indexing API ay naglalaman ng object ng pahina kasama ang URI nito, pamagat, paglalarawan, at opsyonal na mga larawan. Bawat URI ay pinoproseso bilang isang hiwalay na pahina na maaaring matagpuan sa pamamagitan ng paghahanap ng Google. Ang API ay gumagamit ng OAuth 2.0 authentication sa pamamagitan ng Firebase Service Account. Para sa maramihang pagdaragdag ng mga URI, sinusuportahan ang batch processing ng hanggang 1000 pahina sa isang kahilingan.

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("Presyo: " + price)
            .build();

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

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

Pag-update at pagtanggal ng nilalaman

Kapag nagbago ang nilalaman sa app, kailangang i-update ang Google index sa pamamagitan ng Firebase App Indexing API. Ang pagtanggal ng lumang nilalaman ay mahalaga rin: kung ang URI ay wala na o tumuturo sa 404, dapat itong tanggalin mula sa index. Hindi awtomatikong tinatanggal ng Firebase App Indexing ang nilalaman kapag nagbago ito sa app — ang developer ay responsable para sa pag-sync ng index sa kasalukuyang estado ng nilalaman. Inirerekomenda na tawagan ang API sa bawat pagbabago ng data: pagdaragdag, pag-edit, o pagtanggal ng mga produkto, artikulo, profile.

Pag-configure ng App Indexing sa Android

Pag-configure ng Firebase App Indexing sa Android ay may kasamang ilang hakbang: pagkonekta ng Firebase SDK, pagdaragdag ng mga dependency ng app-indexing sa build.gradle, pag-configure ng Android App Links, at paggawa ng serbisyo para sa pagproseso ng URI. Ang minimum na bersyon ng API para sa Firebase App Indexing — 23. Pagkatapos ng pag-configure ng SDK, awtomatikong magsisimula ang app na magpadala ng data para sa pag-index sa Google sa pamamagitan ng Google Play Services.

Pagdaragdag ng mga dependency at configuration

Para sa Firebase App Indexing, kailangang idagdag sa build.gradle ng module ng app ang dependency na com.google.firebase:firebase-appindexing at ang google-services plugin. Firebase ay awtomatikong nagpoproseso ng data ng pag-index sa pamamagitan ng Google Play Services, kung ang app ay nakakatugon sa mga kinakailangan: minSdkVersion 23+, pagkakaroon ng intent-filter na may HTTP/HTTPS scheme, at paggamit ng Android App Links para sa pag-verify. Para sa mga URI na may custom na scheme, kinakailangan ang karagdagang configuration.

// 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 at pag-verify

Ang Android App Links ay mga HTTP/HTTPS link na ni-verify ng Google bilang pag-aari ng iyong app. Ang pag-verify ay isinasagawa sa pamamagitan ng Digital Asset Links: ang file na assetlinks.json ay ina-upload sa iyong website. Pagkatapos ng pag-verify, awtomatikong pinoproseso ng Android ang lahat ng link mula sa iyong domain bilang App Links, nang hindi tinatanong ang user kung saang app bubuksan ang link. Ito ay isang kinakailangang kondisyon para sa tamang pag-index ng nilalaman ng app.

Pagsusuri ng pag-index

Pagkatapos ng configuration, kailangang suriin kung ang nilalaman ng app ay talagang nai-index. Firebase Console sa seksyong App Indexing ay nagpapakita ng mga istatistika: bilang ng mga nai-index na URI, bilang ng mga pagpapakita sa paghahanap at click. Para sa detalyadong pagsusuri, gamitin ang Search Console Google, kung saan ipinapakita ang mga error sa pag-index at mga rekomendasyon. Maaari ka ring magsagawa ng paghahanap ayon sa site:https://your-app.page.link sa Google upang makita ang mga nai-index na pahina ng app.

Pinakamahuhusay na kasanayan sa pag-index

Epektibong pag-index ng app ay nangangailangan ng pagsunod sa ilang pangunahing kasanayan. Ang lahat ng URI na nais mong i-index ay dapat tumuro sa tunay na nilalaman — walang placeholder na pahina, walang laman na screen, o pahina ng error. Inirerekomenda na i-index lamang ang pampublikong nilalaman at huwag i-index ang mga pahina na nangangailangan ng pagpapatotoo. Bawat URI ay dapat magkaroon ng nababasang pangalan at paglalarawan sa wika ng user.

Ano ang dapat i-index

I-index ang nilalaman na hinahanap ng mga user sa Google: mga card ng produkto, artikulo, profile, kategorya ng menu, recipe, kaganapan. Huwag i-index ang mga pahina na may personal na data, setting, cart, kasaysayan ng order, o anumang iba pang pribadong data. Para sa dynamic na nilalaman (feed ng balita, personalized na mga seleksyon), gamitin ang Firebase App Indexing API para magdagdag ng mga bagong URI habang ginagawa ang mga ito at tanggalin ang mga ito kapag tinanggal.

Pag-optimize para sa paghahanap

Bawat nai-index na URI ay dapat magkaroon ng makabuluhang pamagat, paglalarawan, at larawan para sa preview sa mga resulta ng paghahanap. Gumamit ng mga keyword sa pamagat at paglalarawan na tumutugma sa mga tunay na query sa paghahanap ng mga user. Para sa mga larawan, gamitin ang square format na 1200x1200 px at tiyaking accessible ang mga ito sa pamamagitan ng pampublikong URL. Regular na i-update ang nilalaman: mas madalas na ipinapakita ng Google ang mga sariwang pahina sa paghahanap.