Yandex Arama İndekslemesi için IndexNow Yük Yapısının Doğrulanması

Bir IndexNow API yükü, yeni veya güncellenmiş sayfaların anında taranmasını tetiklemek için Yandex’e POST isteği yoluyla gönderilen yapılandırılmış bir JSON nesnesidir. Bu yük, host alan adını, bir doğrulama anahtarını ve yeniden indekslenmesi gereken URL dizisini içermelidir. Web yöneticileri, tam biçimlendirme gereksinimlerine uyarak arama motorunun bu güncellemeleri doğru bir şekilde işlemesini sağlar ve standart site tarama programlarıyla ilişkili geleneksel bekleme sürelerini atlar.

Bir IndexNow API yükünün zorunlu bileşenleri nelerdir?

Başarılı bir bildirim için JSON nesnesi, Yandex sunucusunun beklediği belirli alanları içermelidir. Bu alanlardan herhangi biri eksik veya yanlış biçimlendirilmişse, istek bir hata kodu döndürür ve URL’ler tarama kuyruğuna eklenmez. Yapı, hem veriyi hem de sahiplik kanıtını tek bir iletimde gerektiren, basit ancak güvenli olacak şekilde tasarlanmıştır.

• host: URL’lerin bulunduğu alan adı (örneğin, example.com).
• key: Kimlik doğrulama için kullanılan 8 ila 128 onaltılık karakterden oluşan bir dize.
• keyLocation: Anahtar dosyasının konumunu gösteren isteğe bağlı ancak önerilen bir URL.
• urlList: Güncellenen veya oluşturulan tam URL’leri içeren bir dizi.

Host alanı, o belirli uç nokta için uygulama kılavuzunda belirtilmedikçe protokolü (http veya https) içermemelidir. Anahtar, sunucunuzda barındırılan metin dosyasının içeriğiyle eşleşmelidir. Bu dosya, web siteniz ile Yandex robotu arasında bir el sıkışma görevi görür ve belirtilen alan adı için indeksleme talep etme yetkiniz olduğunu doğrular.

Yandex için JSON isteği nasıl biçimlendirilir?

IndexNow API yükünü göndermek için Yandex uç noktasına yönlendirilen POST yöntemini kullanmalısınız. İstek başlıkları, gövde kadar hayati öneme sahiptir. ‘Content-Type’ı ‘application/json; charset=utf-8’ olarak ayarlamalısınız. Bu, özellikle URL’leriniz özel karakterler veya Latin olmayan betikler içeriyorsa, sunucunun verileri doğru bir şekilde yorumlamasını sağlar.

Yük yapısını doğrulamak teknik SEO’da temel bir adımdır çünkü eksik tek bir tırnak işareti veya yanlış bir karakter kodlaması bile güncellemelerinizin arama dizinine ulaşmasını engelleyebilir.

Alien Road SEO ekibi

urlList tek bir istekte 10.000’e kadar URL içerebilir. Her URL, protokolle başlayan mutlak bir yol olmalıdır. Örneğin, ‘https://example.com/new-page’ geçerlidir, ancak ‘/new-page’ değildir. Toplu bir istek gönderirken, sunucu listeyi işler ve toplu işlemin işlenmek üzere kabul edilip edilmediğini belirten bir yanıt kodu döndürür.

Yük doğrulaması sırasında hangi yaygın hatalar oluşur?

Doğrulama işlemi sırasındaki çoğu başarısızlık, küçük sözdizimi hatalarından veya yapılandırma uyuşmazlıklarından kaynaklanır. Yaygın bir sorun, JSON’da sağlanan anahtar ile sunucudaki .txt dosyasında bulunan anahtar arasındaki uyuşmazlıktır. Bunlar mükemmel bir şekilde eşleşmezse, Yandex sunucusu isteği 403 Forbidden durumuyla reddeder. Sık görülen bir diğer hata, yükte belirtilenden farklı bir hosttan URL’lerin dahil edilmesidir.

Karakter kodlaması da önemli bir rol oynar. URL’leriniz Kiril veya diğer özel karakterleri içeriyorsa, bunlar uygun şekilde yüzde kodlamalı olmalıdır. JSON’un kendisi UTF-8 kodlamalı olmalıdır. Bunu yapmamak, sunucunun URL yollarını yanlış okumasına ve 400 Bad Request hatalarına yol açabilir. Ayrıca, değişmeyen URL’leri göndermekten kaçınmak hayati önem taşır, çünkü aşırı gürültü hız sınırlamasına yol açabilir.

Alien Road, IndexNow mantığını nasıl uygular?

Alien Road’da, IndexNow’u İstanbul’daki müşterilerimizin içerik yönetimi iş akışlarına doğrudan entegre ediyoruz. Hangi eylemlerin bir bildirimi tetiklemesi gerektiğini belirlemek için teknik bir denetimle başlıyoruz. Büyük bir e-ticaret sitesi gibi tipik bir hesap için, ürün kullanılabilirliğini ve fiyat değişikliklerini izleyen otomatik komut dosyaları kuruyoruz. Bu, IndexNow API yükünün bir ürün stokta kalmadığı anda gönderilmesini sağlar.

Sürecimiz, müşteri için benzersiz bir anahtar oluşturmayı ve bunu kök dizine yerleştirmeyi içerir. Daha sonra URL’leri gruplandırmak ve verimliliği korumak için 500 ila 1.000’lik gruplar halinde Yandex’e göndermek için Python tabanlı bir ara yazılım kullanıyoruz. Bu pinglerin başarı oranını izlemek için Yandex Webmaster panelini takip ediyoruz. Örneğin, bir müşteri tüm kataloğunu güncellerse, tanı raporlarında tarama sıklığının neredeyse anında arttığını görebiliriz.

IndexNow verimli olsa da, iyi yapılandırılmış bir site haritasının yerini tutmaz. Bunu, en taze içeriğin her zaman görünür olmasını sağlamak için geleneksel keşif yöntemlerinin üzerinde oturan aktif bir bildirim katmanı olarak görüyoruz.

Alien Road SEO ekibi

IndexNow için HTTP durum kodlarını anlama

Yükünüzü gönderdiğinizde, Yandex sunucusu HTTP durum kodları aracılığıyla anında geri bildirim sağlar. Bu kodları izlemek, uygulamanızın amaçlandığı gibi çalıştığını doğrulamanın en etkili yoludur. Başarı kodu indekslemeyi garanti etmez, ancak arama motorunun bildiriminizi aldığını ve URL’leri işleme kuyruğuna eklediğini doğrular.

• 200 OK: İstek başarıyla işlendi.
• 202 Accepted: İstek kabul edildi ve URL’ler taranmak üzere kuyruğa alındı.
• 400 Bad Request: JSON yapısı geçersiz veya biçim yanlış.
• 403 Forbidden: Anahtar geçersiz veya anahtar dosyası belirtilen konumda bulunamadı.
• 422 Unprocessable Entity: URL’ler geçersiz veya sağlanan host ile eşleşmiyor.
• 429 Too Many Requests: Gönderimler için günlük limiti aştınız.

keyLocation alanı neden önerilir?

keyLocation alanı, arama motoruna doğrulama dosyasının sunucunuzda tam olarak nerede olduğunu söyler. Protokol genellikle varsayılan olarak anahtarı hostun kökünde arasa da, belirli yolu sağlamak işlem süresini azaltır ve olası 403 hatalarını önler. Bu, karmaşık alt klasör yapıları kullanan veya tek bir ana anahtar altında birden fazla alt alan adını yöneten siteler için özellikle yararlıdır.

Bu alanı dahil ederek, Yandex robotunun takip etmesi için sağlam bir iz sağlarsınız. Anahtar dosyanızı taşırsanız veya güvenlik nedenleriyle özel bir dizin kullanırsanız, keyLocation alanı el sıkışmanın bozulmamasını sağlar. IndexNow API yüküne yönelik bu ayrıntılı yaklaşım, site geçişleri veya sunucu güncellemeleri sırasında bildirim sisteminin bozulmasını önler.

URL listesi yönetimi için en iyi uygulamalar

urlList’i yönetmek stratejik bir yaklaşım gerektirir. Yalnızca önemli değişikliklere uğramış veya tamamen yeni olan URL’leri dahil etmelisiniz. Değişmeyen sayfalar için binlerce aynı ping’i göndermek, tarama bütçesinin verimsiz kullanımıdır. Ayrıca, listedeki URL’lerin robots.txt tarafından engellenmediğinden veya ‘noindex’ olarak ayarlanmadığından emin olmalısınız, çünkü Yandex yine de onları ziyaret etmeye çalışacak ve kaynakları boşa harcayacaktır.

Güncellemelerinizi gruplandırmak da faydalıdır. Sisteminiz dakikada yüzlerce güncelleme oluşturuyorsa, bekleyin ve bunları on dakikada bir tek bir POST isteğiyle gönderin. Bu, sunucunuzun açması gereken bağlantı sayısını azaltır ve süreci daha güvenilir hale getirir. Çoğu modern sunucu bu JSON iletimlerini kolayca işleyebilir, ancak temiz ve doğru bir liste tutmak güçlü bir teknik SEO kurulumunun işaretidir.

Önümüzdeki hafta için adımlar

Bu teknolojiyi kullanmaya başlamak için önce benzersiz API anahtarınızı oluşturun ve ilgili metin dosyasını sitenizin kök dizininde barındırın. Dosya erişilebilir olduğunda, tek bir URL’yi Yandex uç noktasına göndermek için cURL veya bir POSTMAN koleksiyonu gibi bir araç kullanarak manuel bir test gerçekleştirin. 200 veya 202 durum kodu döndürdüğünden emin olmak için yanıt kodunu kontrol edin. Başarılı bir manuel testten sonra, gelecekteki içerik güncellemelerini otomatik olarak işlemek için CMS’niz veya arka uç mantığınız içindeki yük oluşturmayı otomatikleştirmeye geçebilirsiniz.