Firebase App Indexing — esensi pengindeksan konten aplikasi dan prinsip kerja

Apa itu Firebase App Indexing

Firebase App Indexing adalah teknologi Google yang membuat konten aplikasi mobile tersedia untuk robot pencarian Google, memungkinkan pengindeksan layar aplikasi seperti Google mengindeks halaman web. Ketika konten aplikasi diindeks, pengguna dapat menemukannya di Google Search, Google Assistant, atau Google Lens dan langsung menuju layar aplikasi yang diinginkan dengan satu klik, melewati halaman web.

Prinsip pengindeksan konten mobile

Google mengindeks aplikasi melalui dua mekanisme: pengindeksan otomatis dan Firebase App Indexing API. Pengindeksan otomatis bekerja di Android melalui Google Play Services: jika aplikasi terinstal, Google secara otomatis mengindeks konten yang memiliki tautan dalam. Pengindeksan API memungkinkan pengembang mengelola secara terprogram konten apa yang terlihat di pencarian, menggunakan Firebase App Indexing API untuk memperbarui atau menghapus halaman yang diindeks.

Mengapa pengindeksan aplikasi diperlukan

Pengindeksan aplikasi menyelesaikan beberapa tugas: menarik pengguna baru dari pencarian Google (hasil pencarian menampilkan konten dari aplikasi dalam kartu). Meningkatkan keterlibatan — pengguna yang ada menemukan konten yang diinginkan lebih cepat melalui pencarian di perangkat. Meningkatkan pemasangan — pencarian Google menampilkan tautan dalam ke konten, dan jika aplikasi tidak terinstal, Google menampilkan tautan pemasangan. App Indexing juga meningkatkan visibilitas aplikasi di Google Assistant, yang dapat menyarankan membuka aplikasi saat pencarian suara.

Cara kerja pengindeksan konten aplikasi

Proses pengindeksan dimulai ketika Google menemukan skema URI aplikasi Anda. Untuk Android, Google menggunakan informasi dari Google Play Store (level API, intent-filter, skema URI) untuk membangun peta aplikasi. Untuk iOS, pengindeksan dilakukan melalui Spotlight Integration dan CSSearchableIndex. Ketika Google mengindeks konten aplikasi, ia menghubungkan URI (misalnya, myapp://product/123) dengan URL web, jika ada, dan menyimpan pasangan ini di indeks pencarian.

Menghubungkan aplikasi dan situs web

Untuk pengindeksan yang benar, Google harus memahami hubungan antara aplikasi Anda dan situs web. Digital Asset Links adalah file JSON yang diunggah ke situs web Anda dan mengonfirmasi bahwa aplikasi mobile milik pemilik situs. File assetlinks.json ditempatkan di root domain dan berisi sidik jari SHA256 dari sertifikat penandatanganan aplikasi. Google memeriksa hubungan ini sebelum menampilkan tombol buka aplikasi di hasil pencarian.

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

Sumber pengindeksan

Google mendapatkan konten untuk pengindeksan dari beberapa sumber: Google Play Store (daftar aplikasi yang dipublikasikan dengan skema URI-nya), Android App Links (skema HTTP yang diverifikasi di Android 6.0+), Firebase App Indexing API (pembaruan indeks secara terprogram), dan pengindeksan otomatis melalui Google Play Services di perangkat dengan aplikasi terinstal. Setiap sumber melengkapi indeks umum, membuat konten aplikasi semaksimal mungkin tersedia untuk pencarian.

Pengindeksan otomatis melalui Google Play Services

Google Play Services secara otomatis mengindeks konten aplikasi yang terinstal di Android, jika aplikasi menggunakan skema URI dan intent-filter yang benar. Mekanisme ini memindai aplikasi untuk intent-filter dengan tindakan VIEW dan mengumpulkan URI yang digunakan dalam aplikasi. Proses ini sepenuhnya otomatis dan tidak memerlukan kode tambahan dari pengembang — cukup konfigurasi deep links dengan benar di manifes.

URI mana yang diindeks secara otomatis

Google secara otomatis mengindeks URI yang memenuhi kriteria tertentu: URI harus dapat diakses melalui intent-filter dengan tindakan VIEW, skema harus HTTP/HTTPS untuk Android App Links. URI dengan skema kustom (myapp://) juga diindeks, tetapi hanya dengan aplikasi terinstal. Pengindeksan otomatis tidak berlaku untuk URI yang menuju ke halaman yang memerlukan otentikasi atau berisi data pribadi pengguna.

Keterbatasan pengindeksan otomatis

Pengindeksan otomatis memiliki beberapa keterbatasan: indeks tidak diperbarui secara instan, melainkan dengan penundaan dari beberapa jam hingga hari. Level API aplikasi — untuk pengindeksan otomatis diperlukan minSdkVersion 23 atau lebih tinggi. URI tanpa skema HTTP/HTTPS hanya diindeks di perangkat dengan aplikasi terinstal. Untuk mempercepat pengindeksan dan menambahkan konten tanpa padanan web, disarankan menggunakan Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API adalah HTTP API Google yang memungkinkan pengembang mengelola konten aplikasi yang diindeks secara terprogram. API menerima permintaan untuk menambah, memperbarui, dan menghapus halaman URI di indeks Google. Tidak seperti pengindeksan otomatis, API bekerja secara instan: setelah dipanggil, Google mulai memperhitungkan URI baru dalam hasil pencarian dalam beberapa menit.

Format permintaan Firebase App Indexing API

Permintaan ke Firebase App Indexing API berisi objek halaman dengan URI, judul, deskripsi, dan gambar opsional. Setiap URI diproses sebagai halaman terpisah yang dapat ditemukan melalui pencarian Google. API menggunakan otentikasi OAuth 2.0 melalui Firebase Service Account. Untuk penambahan URI secara massal, pemrosesan batch hingga 1000 halaman dalam satu permintaan didukung.

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

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

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

Memperbarui dan menghapus konten

Ketika konten dalam aplikasi berubah, indeks Google harus diperbarui melalui Firebase App Indexing API. Menghapus konten usang juga penting: jika URI sudah tidak ada atau mengarah ke 404, URI tersebut harus dihapus dari indeks. Firebase App Indexing tidak menghapus konten secara otomatis saat berubah di aplikasi — pengembang bertanggung jawab untuk menyinkronkan indeks dengan status konten saat ini. Disarankan untuk memanggil API setiap kali data berubah: menambah, mengedit, atau menghapus produk, artikel, profil.

Konfigurasi App Indexing di Android

Konfigurasi Firebase App Indexing di Android mencakup beberapa langkah: menghubungkan Firebase SDK, menambahkan dependensi app-indexing di build.gradle, mengonfigurasi Android App Links, dan membuat layanan untuk pemrosesan URI. Versi API minimum untuk Firebase App Indexing — 23. Setelah konfigurasi SDK, aplikasi secara otomatis mulai mengirim data untuk pengindeksan ke Google melalui Google Play Services.

Menambahkan dependensi dan konfigurasi

Untuk Firebase App Indexing, perlu ditambahkan dependensi com.google.firebase:firebase-appindexing dan plugin google-services di build.gradle modul aplikasi. Firebase secara otomatis memproses data pengindeksan melalui Google Play Services, jika aplikasi memenuhi persyaratan: minSdkVersion 23+, keberadaan intent-filter dengan skema HTTP/HTTPS, dan penggunaan Android App Links untuk verifikasi. Untuk URI dengan skema kustom, diperlukan konfigurasi tambahan.

// build.gradle (Modul: 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 dan verifikasi

Android App Links adalah tautan HTTP/HTTPS yang diverifikasi Google sebagai milik aplikasi Anda. Verifikasi dilakukan melalui Digital Asset Links: file assetlinks.json diunggah ke situs web Anda. Setelah verifikasi, Android secara otomatis memproses semua tautan dari domain Anda sebagai App Links, tanpa menanyakan pengguna di aplikasi mana tautan harus dibuka. Ini adalah kondisi yang diperlukan untuk pengindeksan konten aplikasi yang benar.

Memeriksa pengindeksan

Setelah konfigurasi, perlu diperiksa apakah konten aplikasi benar-benar diindeks. Firebase Console di bagian App Indexing menunjukkan statistik: jumlah URI yang diindeks, jumlah tampilan di pencarian, dan klik. Untuk pemeriksaan detail, gunakan Search Console Google, di mana kesalahan pengindeksan dan rekomendasi ditampilkan. Anda juga dapat melakukan pencarian dengan site:https://your-app.page.link di Google untuk melihat halaman aplikasi yang diindeks.

Praktik terbaik pengindeksan

Pengindeksan yang efektif dari aplikasi memerlukan kepatuhan pada beberapa praktik utama. Semua URI yang ingin Anda indeks harus mengarah ke konten nyata — tidak ada halaman placeholder, layar kosong, atau halaman kesalahan. Disarankan untuk hanya mengindeks konten publik dan tidak mengindeks halaman yang memerlukan otentikasi. Setiap URI harus memiliki nama dan deskripsi yang dapat dibaca dalam bahasa pengguna.

Apa yang harus diindeks

Indeks konten yang dicari pengguna di Google: kartu produk, artikel, profil, kategori menu, resep, acara. Jangan indeks halaman dengan data pribadi, pengaturan, keranjang belanja, riwayat pesanan, atau data pribadi lainnya. Untuk konten dinamis (feed berita, pilihan yang dipersonalisasi), gunakan Firebase App Indexing API untuk menambahkan URI baru saat dibuat dan menghapusnya saat dihapus.

Optimasi untuk pencarian

Setiap URI yang diindeks harus memiliki judul, deskripsi, dan gambar yang bermakna untuk pratinjau di hasil pencarian. Gunakan kata kunci dalam judul dan deskripsi yang sesuai dengan permintaan pencarian nyata pengguna. Untuk gambar, gunakan format persegi 1200x1200 px dan pastikan dapat diakses melalui URL publik. Perbarui konten secara teratur: Google lebih sering menampilkan halaman segar di pencarian.