Yandex Webmaster-də IndexNow API sorğu xətaları çox vaxt yanlış açar yerləşdirilməsi, səhv şərh edilmiş status kodları və ya məhdudlaşdırıcı əhatə dairəsi tərifləri kimi konfiqurasiya xətalarından qaynaqlanır. API çağırışı xəta qaytardıqda, diaqnostika prosesi serverin yoxlama faylını təqdim etmək qabiliyyətini yoxlamağı və JSON yükünün tələb olunan struktura uyğun olmasını təmin etməyi əhatə edir. Bu komponentləri təcrid etməklə, axtarış motoru kommunikasiyasını bərpa edə və səhifələriniz üçün dəqiq indeks statusunu saxlaya bilərsiniz.
Niyə IndexNow açarım yoxlamadan keçə bilmir?
Yoxlama xətaları adətən axtarış motorunun açar faylınızı oxuya bilmədiyini göstərir. Fayl əlavə simvollar, HTML teqləri və ya formatlaşdırma olmadan yalnız açar sətirini ehtiva etməlidir. Əgər serveriniz açar fayl yoluna daxil olarkən 404 xətası qaytarırsa, API sorğusu yükdən asılı olmayaraq dərhal uğursuz olacaq. Faylın text/plain məzmun növü ilə təqdim olunduğundan əmin olmaq üçün serverin cavab başlıqlarını yoxlamağı tövsiyə edirik.
Bundan əlavə, simvol kodlaşdırması uğurlu yoxlamada mühüm rol oynayır. Fayl UTF-8 kodlaşdırması ilə saxlanmalıdır. Əgər serveriniz Byte Order Mark (BOM) və ya gizli boşluq simvolları əlavə edirsə, açar sətiri gözlənilən dəyərlə uyğun gəlməyə bilər. Çıxışın tam olaraq gözlədiyiniz kimi olduğundan əmin olmaq üçün faylı həmişə brauzer və ya curl kimi komanda xətti aləti vasitəsilə əllə yoxlayın.
- Faylın UTF-8 ilə kodlaşdırıldığını və yalnız açar sətirini ehtiva etdiyini yoxlayın.
- Fayl adının açar sətiri ilə tam uyğun olduğundan əmin olun (məsələn, key-123.txt).
- Faylın müəyyən edilmiş keyLocation-da ictimaiyyətə açıq olduğunu təsdiqləyin.
- Açar uzunluğunun 8 ilə 128 simvol arasında olduğunu yoxlayın.
- Fayl çıxışından hər hansı HTML örtüklərini və ya server tərəfi bannerlərini silin.
API-dən HTTP status kodlarını necə şərh etmək olar?
HTTP cavab kodları API sorğularınız üçün əsas rəy dövrəsi kimi çıxış edir. 202 Accepted cavabı xəta deyil; bu, sorğunun etibarlı olduğunu və hazırda açar yoxlamasını gözlədiyini göstərir. Bu kodu alırsınızsa, sadəcə gözləyin və URL-lərinizi göndərməyə davam edin. 200 OK cavabı açarın yoxlandığını və URL-lərin emal növbəsinə qəbul edildiyini təsdiqləyir.
400 və ya 403 kimi xətalar dərhal diqqət tələb edir. 400 xətası adətən səhv formatlanmış JSON gövdəsinə və ya etibarsız keyLocation parametrini göstərir. 403 xətası çox vaxt təqdim olunan açarın xüsusi host və ya qovluq üçün URL-lər göndərmək icazəsinin olmadığını göstərir. Bu cavabları xüsusi skriptinizdə qeyd etməklə, saytınızın indeksləşdirmə performansına təsir etməzdən əvvəl problemləri tuta bilərsiniz.
Alien Road bunu necə tətbiq edir
Alien Road-da biz qara qutu CMS plaginlərinin məhdudiyyətlərindən qaçmaq üçün birbaşa API inteqrasiyasına üstünlük veririk. Biz müştərinin nəşriyyat xəttində yalnız səhifə yaradıldıqda, yeniləndikdə və ya silindikdə tək bir POST sorğusunu işə salan xüsusi qarmaqlar qururuq. Bu, resursları israf edə biləcək dəyişdirilməmiş URL-ləri göndərmək riskindən qaçarkən səmərəlilik standartlarına riayət etməyimizi təmin edir.
Biz həmçinin API cavablarını mərkəzləşdirilmiş loq sistemi vasitəsilə izləyirik. Əgər bir sıra 403 xətası aşkar etsək, skriptimiz açar fayl icazələrini yoxlamaq üçün texniki komandamıza avtomatik xəbərdarlıq edir. Məsələn, son layihələrin birində biz serverin açar faylın köhnəlmiş versiyasını təqdim etdiyi və bir çox alt domenlərdə qeyri-ardıcıl yoxlama nəticələrinə səbəb olan keşləmə problemi aşkar etdik.
Biz tez-tez komandaların HTTP cavab başlıqlarına məhəl qoymayan avtomatlaşdırılmış plaginlərə güvəndikləri üçün çətinlik çəkdiklərini görürük. Öz məntiqimizi quraraq, 202 cavabının düzgün idarə olunmasını təmin edirik və lazımsız yoxlama yenidən başlamalarının qarşısını alırıq.
Alien Road SEO komandası
Bir domendə birdən çox açar ola bilərmi?
Bəli, Yandex bir domendə birdən çox açarın istifadəsini dəstəkləyir. Bu funksiya saytın müxtəlif bölmələrini ayrı sistemlərlə idarə etdiyiniz zaman faydalıdır. Məsələn, ayrıca alt qovluqda yerləşdirilən bloq xüsusi açardan istifadə edə bilər, əsas mağaza isə digərindən istifadə edə bilər. Hər bir API sorğusunun həmin sistem üçün düzgün keyLocation-a dəqiq işarə etdiyinə əmin olmalısınız.
Birdən çox açardan istifadə edərkən, qovluq səviyyəsində münaqişələrin qarşısını almaq üçün onları saytın kökündə saxlayın. Əgər bir sistem açarı tərəfindən icazə verilən əhatə dairəsindən kənara düşən URL-ləri göndərməyə cəhd edərsə, sorğu əhatə dairəsi pozuntusu ilə uğursuz olacaq. Təsadüfi əvəzetmələrin və ya yanlış konfiqurasiyaların qarşısını almaq üçün hansı açarın hansı sistemə təyin edildiyini izləmək üçün layihə deposunda sadə sənədləşdirmə faylı saxlamağı təklif edirik.
Əhatə dairəsi pozuntularını necə həll etmək olar?
Əhatə dairəsi pozuntuları açarın qovluq yeri göndərilən URL-lər üçün çox dar olduqda baş verir. Əgər açar faylınız /catalog/ kimi alt qovluğun içərisində yerləşdirilərsə, o, /blog/ və ya ana səhifə üçün URL göndərişlərini təsdiqləməyəcək. Bunun qarşısını almağın ən etibarlı yolu açar faylını kök qovluğa yerləşdirməkdir ki, bu da açarın bütün sayt strukturunu əhatə etməsinə imkan verir.
Təhlükəsizlik və ya nümayəndəlik üçün məhdudlaşdırılmış əhatə dairələrindən istifadə etməlisinizsə, API sorğularınızın həmin yollara ciddi şəkildə riayət etdiyinə əmin olun. Məsələn, bir komanda yalnız /news/ bölməsini idarə edirsə, onların API inteqrasiyasının yalnız həmin yol üçün konfiqurasiya edildiyinə əmin olun. Bu sərhəddən kənara çıxmaq üçün hər hansı cəhd xətaya səbəb olacaq. Loqlarınızı vaxtaşırı nəzərdən keçirmək, xüsusi bir sistemin icazə verilən əhatə dairəsindən kənara düşən URL-ləri göndərməyə cəhd edib-etmədiyini müəyyən etməyə kömək edəcək.
- Geniş əhatə dairəsi üçün yoxlama açarını kök qovluğa yerləşdirin.
- keyLocation parametrinin faktiki fayl yolu ilə uyğun olduğundan əmin olun.
- Göndərilən URL-lərin açar tərəfindən əhatə olunan domenlə uyğun olduğunu yoxlayın.
- Tamamilə müstəqil alt domenlər üçün ayrı açarlardan istifadə edin.
- Əhatə dairəsi problemləri üçün ümumi olan 403 xətaları üçün loqları nəzərdən keçirin.
Əhatə dairəsi problemləri səssiz performans qatilləridir. İlkin quraşdırma mərhələsində açar yerinizin bütün URL strukturunuzu əhatə edəcək qədər geniş olduğunu həmişə yoxlayın.
Alien Road SEO komandası
Bu həftə haradan başlamaq lazımdır
Bu həftə cari IndexNow quraşdırmanızı audit etməklə başlayın. Açar faylınıza curl sorğusu yerinə yetirmək və onun 200 statusu və düzgün məzmun qaytardığını yoxlamaq üçün sadə komanda xətti skriptindən istifadə edin. Üçüncü tərəf plaginindən istifadə edirsinizsə, onun dəyişdirilməmiş səhifələri göndərib-göndərmədiyini görmək üçün loqlarını yoxlayın, çünki bu, resursların tükənməsinin və potensial API dərəcəsinin məhdudlaşdırılmasının ümumi səbəbidir.
Loqlarınız davamlı xətalar göstərirsə, plaginini birbaşa skriptlə əvəz etməyi düşünün. JSON POST sorğusu göndərən əsas skriptin saxlanması sadədir və proses üzərində tam nəzarəti təmin edir. Üçüncü tərəf asılılıqlarını aradan qaldırmaqla, API kommunikasiyalarınızın aydın mənzərəsini əldə edir və gələcək problemləri minimal səylə həll edə bilərsiniz.