Google Indexing API sorun giderme işlemleri, kota limitlerinizi kontrol etmenizi ve JSON veri yapınızı standart gereksinimlere göre doğrulamanızı gerektirir. Yüksek hacimli siteler indeksleme gecikmeleri yaşadığında, birincil neden genellikle gönderilen içerik türü ile iş ilanları veya yayın etkinlikleri için belirlenen özel dokümantasyon yönergeleri arasındaki uyumsuzluktur. API yanıt kodlarını sistematik olarak doğrulayarak ve uygun hizmet hesabı yapılandırmasını sağlayarak teknik ekipler, büyük ölçekli dinamik içerikler için tutarlı tarama kapsamını yeniden oluşturabilir.
Indexing API isteğim neden bir hata döndürüyor?
Çoğu API hatası kimlik doğrulama sorunlarından, yanlış uç nokta yapılandırmasından veya günlük istek limitlerinin aşılmasından kaynaklanır. Kodunuzda hata ayıklama yapmadan önce hizmet hesabınızın Google Cloud Console içinde doğru izinlere sahip olduğundan ve Search Console mülkünün düzgün bir şekilde bağlandığından emin olun. Yaygın bir gözden kaçırma, Search Console kontrol panelinde sahip düzeyinde erişimi eksik olan yanlış bir hizmet hesabı e-posta adresinin kullanılmasını içerir.
Yüksek hacimli ortamlarla çalışırken, ağ zaman aşımı süreleri veya sunucu tarafı kısıtlamaları da süreci kesintiye uğratabilir. API uç noktasına ulaşan isteklerin doğru şekilde biçimlendirildiğinden ve yetkilendirildiğinden emin olmak için her zaman sunucu günlüklerinizi kontrol edin. Sunucunuz güvenlik duvarı kuralları nedeniyle API isteğini dahili olarak engelliyorsa, kimlik doğrulama durumunuz ne olursa olsun API güncelleştirmeyi işleyemeyecektir.
Hata ayıklama, değişkenin izole edilmesini gerektirir. Bir komut dosyası başarısız olursa, sorunun uygulama mantığınızda mı yoksa bulut ortamında mı olduğunu belirlemek için manuel olarak tek bir CURL isteği göndermeyi deneyin. Birçok geliştirici, OAuth token’ını yenilemenin veya Google Cloud proje ilişkisini kontrol etmenin, büyük ölçekli kurumsal dağıtımları sıklıkla rahatsız eden yinelenen kimlik doğrulama hatalarını çözdüğünü görmektedir.
- 401 Yetkisiz: OAuth2 token’ınızın süresinin dolup dolmadığını veya yanlış oluşturulup oluşturulmadığını kontrol edin.
- 403 Yasak: Hizmet hesabının Search Console’da sahip veya tam erişim izinlerine sahip olduğunu doğrulayın.
- 429 Çok Fazla İstek: Mülkünüz için günlük kotayı aştınız.
- 404 Bulunamadı: İndekslemeye çalıştığınız URL mevcut değil veya Search Console hesabınızda doğrulanmamış.
URL’lerimin API için uygun olup olmadığını nasıl doğrulayabilirim?
Indexing API tüm web sayfaları için tasarlanmamıştır. Belirli JobPosting veya BroadcastEvent yapılandırılmış verilerini içeren sayfalarla sınırlıdır. Standart blog gönderileri veya kategori sayfaları göndermeye çalışırsanız, bu sayfalar anında indeksleme bildirimleri için desteklenen kriterler kapsamına girmediğinden API isteği bir hatayla reddedecektir.
Uygunluğu sağlamak için sayfa şablonlarınızda bir doğrulama kontrolü gerçekleştirmelisiniz. Yapılandırılmış verilerinizin doğru şekilde uygulandığını doğrulamak için Search Console’daki Zengin Sonuçlar Testi aracını veya URL İnceleme aracını kullanın. Şema eksik veya geçersizse, API taramayı tetiklemez ve gönderim denemelerinizi etkisiz hale getirir.
Bir sayfa şablonu güncellendiğinde, JSON-LD’nin tüm dinamik varyasyonlar boyunca geçerli kalmasını sağlayın. Büyük siteler için, şablonların belirli uç durumlar için bozuk biçimlendirme ürettiğini sıklıkla gözlemliyoruz. API belgelerinin önerdiği araçlar aracılığıyla bir URL örneğini doğrulamak, boşa harcanan tarama bütçesini önler ve Google’a gönderilen her bildirimin eyleme geçirilebilir olmasını sağlar.
Öne çıkan snippet’ler (featured snippets) için içeriği optimize etmek, kullanıcı sorgularına doğrudan, kısa bir şekilde ve arama motorlarının kolayca ayrıştırabileceği yapılandırılmış bir biçimle yanıt vermeyi gerektirir.
Google Search Central
Alien Road bu teknolojiyi nasıl uygular
Alien Road olarak, içerik tazeliğinin rekabetçi bir zorunluluk olduğu büyük e-ticaret kataloglarına veya haber akışlarına güncellemeleri bildirmek için Indexing API’yi kullanıyoruz. Herhangi bir API çağrısı yürütülmeden önce gönderilen her URL’nin gerekli şema tanımlarını karşıladığından emin olmak için sitenin yapılandırılmış veri uygulamasını denetleyerek sürece başlıyoruz.
Tipik bir müşteri projesi için, her API yanıt kodunu günlüğe kaydeden bir izleme komut dosyası oluşturuyoruz. 403 hatalarında bir artış görürsek, ekibimiz derhal hizmet hesabı kimlik bilgilerini yeniler ve Search Console erişim ayarlarını gözden geçirir. Bu, uzun vadeli tarama boşluklarını önler ve arama indeksini site güncellemeleriyle senkronize tutarak yeni içeriğin canlıya geçer geçermez kullanıcılara görünmesini sağlar.
Ayrıca kalıpları belirlemek için gönderim günlüklerinin periyodik denetimlerini gerçekleştiriyoruz. Örneğin, bir sitenin belirli bir bölümü sürekli olarak bir indeks güncellemesini tetiklemekte başarısız olursa, temel sayfa oluşturma (rendering) sürecini araştırırız. Sunucu tarafı oluşturmanın (SSR) hem kullanıcılar hem de arama botları için tutarlı olmasını sağlayarak indeksleme işlem hattının bütünlüğünü koruyoruz.
Yüksek hacimli siteler için en iyi uygulamalar nelerdir?
Sağlıklı bir indeksleme işlem hattını sürdürmek, sadece istek göndermekten daha fazlasını gerektirir. Kota tükenmesine yol açabilecek tüm site haritasını günlük olarak göndermek yerine, önemli değişikliklere uğramış URL’lere öncelik vermelisiniz. Kademeli bir gönderim stratejisi uygulamak, günlük limitinizi verimli bir şekilde yönetmenize yardımcı olur.
Ayrıca sunucunuz için tarama bütçesi çıkarımlarını göz önünde bulundurun. API, Google’ı güncellemeler hakkında bilgilendirirken, Googlebot’un yine de içeriği indirmesi gerekir. Sunucunuzun sonraki tarama isteklerini performans düşüşü olmadan işleyebilmesini sağlamak, uzun vadeli site kararlılığı için hayati önem taşır.
Altyapınız eşzamanlı yükü kaldıramıyorsa binlerce isteği aynı anda toplu olarak göndermekten kaçının. API çağrılarınızı makul bir zaman aralığına yaymak, Googlebot’un yeni verilerin alınmasını yönetmesine yardımcı olur. Bu patlamalar sırasında sunucu yanıt sürelerini izlemek, arama motoru güncellemelerinizi işlerken altyapınızın kararlı kaldığını doğrulamak için standart bir yöntemdir.
- Kota kullanımını en üst düzeye çıkarmak için kritik içerik güncellemeleri için öncelikli bir kuyruk uygulayın.
- Kota tüketimini gerçek zamanlı olarak izlemek için Google Cloud’daki API kullanım kontrol panelinizi izleyin.
- Şema doğrulama hatalarını önlemek için yapılandırılmış verilerinizi düzenli olarak denetleyin.
- Sitenizin Googlebot’un gönderilen URL’leri kısıtlama olmaksızın getirmesine izin verdiğinden emin olmak için robots.txt kullanın.
Sayfalarım neden hala aramalarda görünmüyor?
Indexing API bir bildirim hizmetidir, sıralama veya anında indeksleme garantisi değildir. API isteğinizi başarıyla aldığında bile, içeriğin Google’ın kalite ve alaka düzeyi değerlendirmelerinden geçmesi gerekir. Sayfanız düşük değer sunuyorsa veya mevcut içeriği yineliyorsa, başarılı bir API gönderimine rağmen arama indeksine dahil edilmeyebilir.
Bir sayfanın ‘Keşfedildi – şu anda dizine eklenmedi’ durumunda olup olmadığını görmek için Search Console’daki URL İnceleme aracını kontrol edin. Bu durum genellikle URL bilindiği halde sistemin anında işleme için bir öncelik olmadığını belirlediğini gösterir. Dahili bağlantı yapısını ve sayfanın genel kalitesini iyileştirmek, bu indeksleme engellerini aşmaya yardımcı olabilir.
Son olarak, sayfa deneyimini değerlendirin. İçerik teknik olarak uygunsa ancak sayfa zayıf Core Web Vitals veya yüksek LCP ölçümleri sergiliyorsa, arama motoru dizindeki diğer, daha performanslı sayfalara öncelik verebilir. API aracılığıyla elde etmeye çalıştığınız görünürlüğü teknik temelinizin desteklediğinden emin olmak için Sayfa Deneyimi raporunu kullanın.
Bu hafta nereden başlamalı
Şu anda ‘Keşfedildi – şu anda dizine eklenmedi’ durumunda olan sayfaları belirlemek için Search Console ‘Dizin Oluşturma’ raporunuzu gözden geçirerek başlayın. Bu sayfalar API için uygunluk kriterlerini karşılıyorsa, JSON verilerinizi hazırlayın ve 10 URL’lik küçük bir grup için bir test çalıştırın. İstek hacminizi tüm sitenize ölçeklendirmeden önce API yanıtındaki başarı durumunu onaylayın.