Programatik SEO ve yapay zekâ sorun giderme
8 dk okuma
Önce Programmatic SEO ekranındaki görev kartından (durum, sayaçlar, bildirim), ardından görevin SEO health kartından (Pages ekranında), sonra günlüğe kaydedilen hatalar için Massbase › Settings › Health bölümünden başlayın. Bu sayfa olağan belirtileri listeler.
Sayfalar
Oluşturulan bir URL 404 gösteriyor
Bu listeyi sırayla izleyin:
Denetim | Nasıl |
|---|---|
Sayfa var mı? | Task › Pages, URL'yi arayın. Satır yoksa çalıştırma onu oluşturmamıştır (duraklatılmış görev, filtre, kural veya sınır; bkz. "Fewer pages than rows"). |
Durum Hidden | Gizli sayfalar 404 yanıtlar. Show düğmesine tıklayın. |
Durum Removed | Satırı kalmamış veya filtrelenmiş; kaldırılan sayfalar 410 yanıtlar (veya yönlendirir). |
Durum URL in use | URL'yi gerçek bir içerik kullanıyor ve onun yerine o gösteriliyor (Serving pages). |
Yol beklediğinizden farklı | URL adımındaki Preview ile karşılaştırın. Verideki aksanlar, büyük/küçük harf, boşluklar ve |
Kalıcı bağlantılar | Oluşturulan sayfalar, Plain dışında bir kalıcı bağlantı yapısı gerektirir. |
Lisans | Süresi dolmuş bir lisansın 14 günlük ek süresinden sonra veya bir denemeden sonra sayfalar artık sunulmaz (Limits and plans). |
Eklenti devre dışı | Eklenti kapalıyken sunum durur; etkinleştirildiğinde sayfalar geri gelir. |
Sayfa önbelleği | Eski bir 404 veya eski bir sayfa önbellekte olabilir; önbelleği temizleyin (Freshness and caches). |
Bir | Sayfalanmış istekler asla sunulmaz. |
Sayfa şablondan farklı görünüyor (eksik stiller)
Oluşturulan sayfalar temanızı ve şablonun içeriğini kullanır. Sayfa oluşturucu CSS ve betikleri Elementor ve Avada için yüklenir; diğer oluşturucuların gerçek bir yazıya bağlı "yazı kimliğine göre işle" özelliklerine ihtiyacı olabilir (sayfa şablonun yazı kimliğini kullanır). Oluşturulan bir sayfayı açıp kaynağı görüntüleyin: şablonun CSS dosyası yoksa şablonu oluşturucuda bir kez düzenleyip kaydedin (bu önbellekleri de temizler), ardından önbelleğinizi temizleyin. Hâlâ başarısız olan oluşturucuları bildirin.
Sayfada {{ pseo.src.… }} görüyorum
- Ham yer tutucuları gösteren şablon sayfasının kendisine bakıyorsunuz. Bunları yalnızca oluşturulan URL'ler çözümler.
- Sorun: kaynak anahtarı veya sütun adı yanlış: tam olarak eşleşmelidir (
, küçük harf, addan boşluk yok). Yanlış bir ad metne değil, hiçbir şeye çözümlenir. Değişken çiplerini kullanın. - Süslü parantezleri kaçıran bir oluşturucu widget'ıyla yazılan değişkenler: widget'ın dinamik içerik ayarını kontrol edin veya bir metin/HTML bloğu kullanın.
- Metin, süslü parantezlerin çözümlenmeyen bir yerde elle ayarlandığı bir alan değerinden geliyor (sayfada düzenlediğiniz düz bir alan, bir yazı başlığı). Değişkenler şablon içeriğinde, şablon alan değerlerinde ve görevin kalıplarında çözümlenir.
Bölümler boş veya yanlış değerler gösteriyor
- Bir sayı sütunu sondaki sıfırlar olmadan yazdırılır (
165,165.000000değil); sabit sayıda ondalık zorlamak için| number(2)kullanın. - Bir işlev, başında
fn.olmadan hiçbir şey yazdırmaz:{{ fn.year() }}doğrudur,{{ year() }}değildir. ({{ fn.now() | date("Y") }}yılı yazdırır.) - Bir bilinmeyen filtre adı hiçbir şey yapmaz:
number_formatbir filtre değildir,number(2)filtredir. - Bir sütun, WordPress'in yazılarda izin vermediği etiketler içeren HTML tutuyor: bu etiketler kaldırılır.
- Sayfa benimkinin yerine şablonun alan değerini gösteriyor: alanın şablonun metnine yazılmadan shortcode veya blok üzerinden okunduğunu kontrol edin. Elle ayarlanan değerler önce, sonra AI değerleri, ardından şablonun kendi değeri gelir (Templates and field values).
Satırlardan daha az sayfa
Kartın son çalıştırmasını açın: created, updated, removed, conflicts, shadowed, limited. Ardından:
Neden | Belirti | Çözüm |
|---|---|---|
Filtreler satırları dışarıda bırakıyor | Preview toplamı daha düşük | Koşulları gözden geçirin (Data sources) |
Bir kalite kuralı "sayfa oluşturma" diyor | Boş değerli satırlar eksik | Kuralı değiştirin veya kaldırın (SEO plugins and meta) |
URL hiçbir şeye çözümlenmiyor | URL'de kullanılan sütunu boş olan satırlar | Veriyi doldurun veya şunu kullanın: |
Yinelenen URL'ler (conflicts) | "%s row skipped: another generated page uses its URL." | URL'yi benzersiz yapın |
URL kullanımda (shadowed) | "%s page offline: WordPress content uses its URL." | Kalıbı veya gerçek slug'ı değiştirin |
Sayfa sınırı | "%s page waits for the page limit." | Sayfaları silin veya yükseltin |
Günlük sınır | Waiting, "Daily page limit reached. New pages follow tomorrow." | Bekleyin veya şunu yükseltin: New pages per day |
Şu ayarlı diller: Skip the page in that language | Çevirisi olmayan satırlar için dil sayfaları eksik | Şu sütunları doldurun: |
Satır modu tek bir kaynak tutar | İkinci bir kaynak yok sayıldı | Kombinasyon modunu kullanın (Business) |
Görevi kaydettiğimde sayfalar silindi
Bir görevi farklı kaynaklarla veya başka bir modla kaydetmek sayfalarını sıfırlar (düzenleyici uyarır). Filtrelerde, kalıplarda veya SEO'daki değişiklikler sıfırlamaz.
Yeniden adlandırılan sayfaların eski URL'leri hâlâ bir şey gösteriyor
Bilerek yeni URL'ye yönlendirilir (301). Dönüştürülen bir sayfa kendi yazısına yönlendirir.
Bir URL %cc%87 veya fazladan bir klasör içeriyor
İstanbul | lower kodlanmış bir birleştirici nokta bırakır ve verideki / fazladan yol bölümleri oluşturur. | slug veya düz değeri kullanın (URL and title patterns).
Çalıştırma
Çalıştırma hiç başlamıyor ("Waiting for the background runner to start…", görev ilerlemeden Generating durumunda kalıyor)
Arka plan işlerinin WordPress'i tetikleyecek bir şeye ihtiyacı vardır. Siteyi ziyaret edin (WP-Cron ziyaretlerde çalışır), kuyruğu wp action-scheduler run --group=wpmcf ile çalıştırın veya bir sistem cron'u kurun (bkz. Background tasks ve WP-CLI). DISABLE_WP_CRON tanımlıysa sistem cron'u gerekir. Bir güvenlik eklentisi ya da wp-cron.php dosyasını engelleyen bir barındırıcı aynı etkiyi yaratır. Şu bölümde: Tools › Scheduled Actions altında bekleyen wpmcf eylemleri olup olmadığını kontrol edin.
Görev şunu gösteriyor: Failed
Kart hatayı gösterir. Nedeni düzeltin (şablon silindi, kaynak silindi, veritabanı hatası) ve Run now düğmesine tıklayın. Art arda üç başarısızlıktan sonra görev kendiliğinden durur (Background tasks).
Görev şunu gösteriyor: Waiting
Tamamlandı ve bir bildirimi var (sınıra ulaşıldı, gölgelenen sayfalar, eksik bir eklenti). Kart hangisi olduğunu söyler; bkz. Running and scheduling.
Veri değişti ama sayfalar değişmedi
- Görev duraklatılmış (duraklatılmış görevler veri değişikliklerinden asla çalışmaz).
- Update pages when the data changes kapalı.
- Kaynak bir alan grubu tablosu (otomatik güncelleme yok).
- Değişiklik, eklentinin dinlediği olayları atlayan SQL ile doğrudan veritabanında yapıldı; Run now düğmesine tıklayın.
- Bir sayfa önbelleği eski sayfayı sunuyor.
Programmatic SEO menüsü eksik veya "Your license has expired" gösteriyor
Pro olmadan ekran yoktur (bunun yerine Pro sayfası). Süresi dolmuş bir lisansla ekran, Renew license ve Convert pages to posts içeren süre bitimi ekranıyla değiştirilir (Limits and plans).
Arama motorları ve SEO eklentileri
Her sayfanın başlığı veya açıklaması şablonla aynı
Bir SEO eklentisi desteklenmiyorsa (SEOPress, The SEO Framework, Slim SEO…) şablonun değerleri yazdırılır; SEO health "Your SEO plugin is not supported for generated pages…" der. Yoast SEO, Rank Math veya All in One SEO kullanın ya da hiç SEO eklentisi kullanmayın (SEO plugins and meta).
Yoast, Rank Math veya AIOSEO çıktısı benim değerlerimi göstermiyor
Bu entegrasyonlar eklentilerin herkese açık hook'larını kullanır ve bu belge için canlı kurulumlarda doğrulanmadı. Şunları kontrol edin: eklenti güncel mi, sayfalarınızın yazı türü için başlık ve açıklama şablonları, başka hiçbir eklentinin çıktısını geçersiz kılmadığı. Yoast'ta başlık biçimi, eklentinin yazı türü şablonudur; Use the SEO title exactly as written ile SEO başlığı olduğu gibi kullanılır.
Sayfalar dizinleniyor ama dizinlenmemeli ya da tersi
- Görevin Show pages in search results, quality rules ve bir sayfanın kendi Show this page in search results ayarı noindex kararını verir. Elle yapılan ayarlar önceliklidir.
- Robots kararı çalıştırma sırasında saklanır: dizinleme ayarlarını değiştirdikten sonra görevi çalıştırın.
- Discourage search engines from indexing this site (Settings › Reading): oluşturulan sayfalar, görev veya sayfa ne derse desin, normal sayfalar gibi WordPress'in
noindex, nofollowdeğerini taşır. Site yayına girdiğinde ayarı kapatın.
Sayfalar site haritasında yok
Yalnızca List pages in the sitemap açık görevlerin yayındaki, dizinlenebilir sayfaları ve lisans oluşturmaya izin verdiği sürece listelenir; gölgelenen sayfalar dışarıda bırakılır (Sitemaps). /wp-sitemap.xml içinde wp-sitemap-pseo-1.xml dosyasını kontrol edin. Bir SEO eklentisi çekirdek site haritasını devre dışı bıraktıysa onun kendi site haritası dizinine bakın (Yoast: pseo-sitemap.xml).
Yapılandırılmış veri eksik
- Adım Structured data kapalı veya hiçbir tür eklenmemiş.
- Geçersiz JSON içeren bir JSON-LD şablonu hiçbir şey yazdırmaz (Settings › Health içinde "The structured data template of “…” is not valid JSON").
- Zorunlu özellikler boş: önizleme bunları bildirir.
- SEO eklentisi grafiği işaretlemenin yerini aldı: Replace the SEO plugin’s article markup ayarını açık bırakın.
Birden fazla hreflang kümesi veya yanlış dil değiştirici bağlantıları
Çok dilli görevlerde eklenti, oluşturulan sayfalar için WPML ve Polylang'ın kendi hreflang çıktısını bastırır. Yine de yinelenenler görüyorsanız bir SEO eklentisi kendi çıktısını yazdırıyordur; Multilingual pages içindeki kontrol listesine bakın.
AI
"Add an API key in Settings › AI" veya No API key yet
Anahtar seçilen sağlayıcı için eksik. Anahtarlar sağlayıcı başınadır: önce sağlayıcıyı seçin, sonra anahtarını kaydedin (AI setup).
Bağlantı başarısız oldu
Sağlayıcının iletisini okuyun: yanlış anahtar, kredi yok, hız sınırı, modelin hesabınız için kullanılamaması (Refresh list kullanın). Test etmeden önce sağlayıcıyı ve modeli kaydedin.
"The saved key can no longer be read"
Anahtar kaydedildikten sonra sitenin güvenlik tuzları (salts) değişti. Anahtarı yeniden girin veya wp-config.php içinde tanımlayın.
Çalıştırma hemen duruyor
Panelin bildirimine bakın. Tipik nedenler: anahtar reddedildi, kota tükendi veya "There is nothing for AI to write: assign a field group to the template, or map SEO or structured data values to AI." (Write field content with AI kapalı ya da hiçbir alan grubu şablonla eşleşmiyor veya her alanda Write this field kapalı ve SEO ile yapılandırılmış veri AI'ı kapalı).
AI içeriği yazıldı ama görünmüyor
- Şablon alanı yazdırmıyor (
[wpmcf_field], blok veya bir oluşturucu etiketi). Sayfa alanı yalnızca şablonun okuduğu yerde gösterir. - Değer Waiting for AI veya AI failed: sayfa düzenleyiciye bakın.
- SEO başlığı veya açıklaması: görevin Let AI write … anahtarı kapalı (değer var ama yok sayılıyor) veya elle ayarlanmış bir değer öncelikli.
- Önbellekler: temizleyin.
"The AI answer was cut off at the maximum answer length"
Settings › AI içinde Maximum answer length (tokens) değerini yükseltin veya sayfa başına alan sayısını azaltın. Kesilen yanıtlar aynı çalıştırmada yeniden istenmez.
Kendi AI çalışanı siteye veya modele ulaşamıyor
- Ollama çalışan sayfasını reddediyor (CORS). Ollama'yı
OLLAMA_ORIGINS=*ile başlatın. İndirilenworker.htmldosyası ayarı Windows, macOS ve Linux için açıklar. - Çalışan engellendi. Sürekli yanlış anahtar gönderen bir adres 15 dakika engellenir. Bekleyin veya geçerli bir anahtar kullanın: geçerli bir anahtar yine çalışır.
- Çalışan HTTPS gerektirir. Çalışan API'si yerel siteler dışında HTTPS gerektirir.
- Kuyruk durdu. Art arda 5 kullanılamaz yanıttan sonra kuyruk tüm site için duraklar. Çalışanı düzeltin, ardından yönetici olarak devam ettirin.
Bir hız sınırı çalıştırmayı sürekli duraklatıyor
Şu değeri indirin: Requests per minute, sağlayıcınızın sınırının altına. Art arda 10 sınırdan sonra çalıştırma durur.
Fatura beklenenden büyük
Değişen brief veya veri değerleri eskitir ve sonraki çalıştırma bunları yeniden yazar; Rewrite all… her şeyi yeniden yazar. Bkz. AI privacy and costs.
Dönüştürme
Sorun | Neden ve çözüm |
|---|---|
Kartta Convert düğmesi yok | Kartın altındaki iletiyi okuyun: yazı türü kalmadı, yayında sayfa yok veya sınırın üstünde |
"Your plan allows converting %d more pages…" | Dönüştürme üst sınırı şimdiye kadar dönüştürülen tüm sayfaları sayar. Daha az sayfa dönüştürün (bazılarını gizleyin) veya yükseltin. |
Eski URL yönlendirmiyor | Yalnızca kalıcı bağlantısı değişen sayfalar yönlendirir; aynı URL'ye sahip bir sayfa doğrudan yazının kendisidir |
Yazılarda şablonun yerleşimi var ama AI değerleri yok | AI değerleri yalnızca dönüştürmeden önce varsa dönüştürülür; önce AI'ı çalıştırın |
Yanlışlıkla yeniden dönüştürüldü | Dönüştürme asla çoğaltmaz: dönüştürülen bir sayfa yazısına bağlı kalır |
Hâlâ takıldınız mı?
Görevin son çalıştırma sayaçlarını, SEO health sonucunu, Settings › Health içindeki girdiyi ve tam URL'yi toplayın ve eklentinin Support bağlantısından desteğe ulaşın.
Hâlâ takıldınız mı? Destek ile iletişime geçin