Firebase App Indexing — uygulama içerik indekslemesinin özü ve çalışma prensibi

Firebase App Indexing Nedir

Firebase App Indexing, mobil uygulama içeriğini Google arama tarayıcısı için erişilebilir kılan bir Google teknolojisidir. Uygulama ekranlarının, Google’ın web sayfalarını indekslemesi gibi indekslenmesini sağlar. Uygulama içeriği indekslendiğinde, kullanıcılar bunu Google Search, Google Assistant veya Google Lens’te bulabilir ve web sayfasını atlayarak tek tıklamayla doğrudan istenen uygulama ekranına gidebilir.

Mobil İçerik İndeksleme Prensibi

Google, uygulamaları iki mekanizma aracılığıyla indeksler: otomatik indeksleme ve Firebase App Indexing API. Otomatik indeksleme, Android’de Google Play Services aracılığıyla çalışır: uygulama yüklüyse, Google derin bağlantıları olan içeriği otomatik olarak indeksler. API indekslemesi, geliştiricinin Firebase App Indexing API’sini kullanarak indekslenen sayfaları güncellemesine veya kaldırmasına, aramada hangi içeriğin görüneceğini programatik olarak kontrol etmesine olanak tanır.

Uygulama İndekslemesi Neden Gereklidir

Uygulama indekslemesi birkaç görevi çözer: Google aramasından yeni kullanıcılar çekmek (arama sonuçları kartlarda uygulama içeriğini gösterir). Artırılmış etkileşim — mevcut kullanıcılar cihaz üzerinde arama yoluyla istenen içeriği daha hızlı bulur. Artan yüklemeler — Google araması içeriğe derin bağlantılar gösterir ve uygulama yüklü değilse, Google bir yükleme bağlantısı görüntüler. App Indexing ayrıca Google Assistant’ta uygulama görünürlüğünü iyileştirir ve sesli arama sırasında uygulamayı açmayı önerebilir.

Uygulama İçerik İndekslemesi Nasıl Çalışır

İndeksleme süreci, Google’ın uygulamanızın URI şemalarını keşfetmesiyle başlar. Android için Google, bir uygulama haritası oluşturmak üzere Google Play Store’dan (API seviyesi, intent-filter, URI şemaları) bilgi kullanır. iOS için indeksleme, Spotlight Integration ve CSSearchableIndex aracılığıyla yapılır. Google uygulama içeriğini indekslerken, URI’yi (örn. myapp://product/123) varsa bir web URL’siyle ilişkilendirir ve bu çifti arama indeksinde saklar.

Uygulama ve Web Sitesini Bağlama

Doğru indeksleme için Google, uygulamanız ile web siteniz arasındaki ilişkiyi anlamalıdır. Digital Asset Links, web sitenize yüklenen ve mobil uygulamanın site sahibine ait olduğunu onaylayan bir JSON dosyasıdır. assetlinks.json dosyası alan adı köküne yerleştirilir ve uygulamanın imza sertifikasının SHA256 parmak izini içerir. Google, arama sonuçlarında uygulama açma düğmesini göstermeden önce bu bağlantıyı doğrular.

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

İndeksleme Kaynakları

Google, indeksleme için içeriği birkaç kaynaktan alır: Google Play Store (URI şemalarıyla yayınlanan uygulamaların listesi), Android App Links (Android 6.0+’da doğrulanmış HTTP şeması), Firebase App Indexing API (programatik indeks güncellemesi) ve uygulama yüklü cihazlarda Google Play Services aracılığıyla otomatik indeksleme. Her kaynak genel indeksi tamamlayarak uygulama içeriğini arama için mümkün olduğunca erişilebilir hale getirir.

Google Play Services Aracılığıyla Otomatik İndeksleme

Google Play Services, uygulama doğru URI şeması ve intent-filter kullanıyorsa Android’de yüklü uygulamaların içeriğini otomatik olarak indeksler. Mekanizma, VIEW eylemi için intent-filter’ları tarar ve uygulamada kullanılan URI’leri toplar. Bu süreç tamamen otomatiktir ve geliştiriciden ek kod gerektirmez — manifestte derin bağlantıları doğru yapılandırmak yeterlidir.

Hangi URI’ler Otomatik Olarak İndekslenir

Google, belirli kriterleri karşılayan URI’leri otomatik olarak indeksler: URI, VIEW eylemiyle intent-filter aracılığıyla erişilebilir olmalı, Android App Links için şema HTTP/HTTPS olmalıdır. Özel şemalara sahip URI’ler (myapp://) da indekslenir, ancak yalnızca uygulama yüklüyken. Otomatik indeksleme, kimlik doğrulama sayfalarına veya kullanıcının kişisel verilerine yönlendiren URI’ler için geçerli değildir.

Otomatik İndekslemenin Sınırlamaları

Otomatik indekslemenin birkaç sınırlaması vardır: indeks anında güncellenmez, birkaç saatten günlere kadar gecikmeyle güncellenir. Uygulama API seviyesi — otomatik indeksleme, minSdkVersion 23 veya üstünü gerektirir. HTTP/HTTPS şeması olmayan URI’ler yalnızca uygulama yüklü cihazlarda indekslenir. İndekslemeyi hızlandırmak ve web benzeri olmayan içerik eklemek için Firebase App Indexing API’sinin kullanılması önerilir.

Firebase App Indexing API

Firebase App Indexing API, geliştiricinin uygulamanın indekslenmiş içeriğini programatik olarak yönetmesini sağlayan bir Google HTTP API’sidir. API, Google indeksinden URI sayfalarını ekleme, güncelleme ve kaldırma isteklerini kabul eder. Otomatik indekslemenin aksine, API anında çalışır: bir çağrıdan sonra Google, dakikalar içinde arama sonuçlarında yeni URI’leri dikkate almaya başlar.

Firebase App Indexing API İstek Formatı

Firebase App Indexing API’sine yapılan bir istek, URI’si, başlığı, açıklaması ve isteğe bağlı görselleriyle bir sayfa nesnesi içerir. Her URI, Google aramasıyla bulunabilen ayrı bir sayfa olarak işlenir. API, bir Firebase Servis Hesabı aracılığıyla OAuth 2.0 kimlik doğrulaması kullanır. URI’lerin toplu eklenmesi için tek bir istekte 1000 sayfaya kadar toplu işleme desteklenir.

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

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("Dizin", "Tamam"))
            .addOnFailureListener(e ->
                Log.e("Dizin", "Hata", e));
    }

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

İçerik Güncelleme ve Kaldırma

Uygulama içeriği değiştiğinde, Firebase App Indexing API aracılığıyla Google indeksini güncellemek gerekir. Eski içeriği kaldırmak da önemlidir: bir URI artık mevcut değilse veya 404’e yönlendiriyorsa, indeksten kaldırılmalıdır. Firebase App Indexing, uygulamada değiştiğinde içeriği otomatik olarak kaldırmaz — geliştirici, indeksi mevcut içerik durumuyla senkronize etmekten sorumludur. Her veri değişikliğinde (ürün, makale, profil ekleme, düzenleme veya silme) API’nin çağrılması önerilir.

Android’de App Indexing Yapılandırması

Android’de Firebase App Indexing yapılandırması birkaç adım içerir: Firebase SDK’sını ekleme, build.gradle’a app-indexing bağımlılıklarını ekleme, Android App Links’i yapılandırma ve URI’leri işlemek için bir hizmet oluşturma. Firebase App Indexing için minimum API sürümü 23’tür. SDK yapılandırmasından sonra uygulama, Google Play Services aracılığıyla Google’a otomatik olarak indeksleme verileri göndermeye başlar.

Bağımlılıkları ve Yapılandırmayı Ekleme

Firebase App Indexing için, uygulama modülünün build.gradle’ına com.google.firebase:firebase-appindexing bağımlılığını ve google-services eklentisini eklemeniz gerekir. Firebase, uygulama gereksinimleri karşılıyorsa (minSdkVersion 23+, HTTP/HTTPS şemasına sahip intent-filter varlığı ve doğrulama için Android App Links kullanımı) Google Play Services aracılığıyla indeksleme verilerini otomatik olarak işler. Özel şemaya sahip URI’ler için ek yapılandırma gerekir.

// build.gradle (Modül: 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 ve Doğrulama

Android App Links, Google’ın uygulamanıza ait olarak doğruladığı HTTP/HTTPS bağlantılarıdır. Doğrulama, Digital Asset Links aracılığıyla yapılır: assetlinks.json dosyası web sitenize yüklenir. Doğrulamadan sonra Android, alan adınızdaki tüm bağlantıları otomatik olarak App Links olarak işler ve kullanıcıya bağlantıyı hangi uygulamada açacağını sormaz. Bu, doğru uygulama içeriği indekslemesi için gerekli bir koşuldur.

İndeksleme Doğrulaması

Yapılandırmadan sonra, uygulama içeriğinin gerçekten indekslenip indekslenmediğini doğrulamanız gerekir. Firebase Console’un App Indexing bölümü istatistikleri gösterir: indekslenen URI sayısı, arama gösterim sayısı ve tıklamalar. Ayrıntılı doğrulama için, indeksleme hatalarını ve önerileri görüntüleyen Google Search Console’u kullanın. Google’da site:https://your-app.page.link araması yaparak uygulamanın indekslenen sayfalarını da görebilirsiniz.

İndeksleme En İyi Uygulamaları

Etkili uygulama indekslemesi birkaç temel uygulamayı takip etmeyi gerektirir. İndekslemek istediğiniz tüm URI’ler gerçek içeriğe yönlendirmelidir — yer tutucu, boş ekran veya hata sayfası olmamalıdır. Yalnızca herkese açık içeriğin indekslenmesi ve kimlik doğrulama gerektiren sayfaların indekslenmemesi önerilir. Her URI, kullanıcının dilinde okunabilir bir ada ve açıklamaya sahip olmalıdır.

Ne İndekslenmeli

Kullanıcıların Google’da aradığı içeriği indeksleyin: ürün kartları, makaleler, profiller, menü kategorileri, tarifler, etkinlikler. Kişisel veri, ayarlar, alışveriş sepeti, sipariş geçmişi veya diğer özel veriler içeren sayfaları indekslemeyin. Dinamik içerik (haber akışı, kişiselleştirilmiş seçimler) için, oluşturuldukça yeni URI’ler eklemek ve silindikçe kaldırmak üzere Firebase App Indexing API’sini kullanın.

Arama Optimizasyonu

İndekslenen her URI, arama sonuçları için anlamlı bir başlığa, açıklamaya ve önizleme görseline sahip olmalıdır. Başlık ve açıklamada, gerçek kullanıcı arama sorgularıyla eşleşen anahtar kelimeler kullanın. Görseller için 1200x1200 px kare formatı kullanın ve herkese açık URL’ler aracılığıyla erişilebilir olduklarından emin olun. İçeriği düzenli olarak güncelleyin: Google aramada taze sayfaları daha sık gösterir.