og:image Görünmüyor mu? Nasıl Düzeltilir?
Bir og:image'in görünmemesi neredeyse her zaman beş nedenden birine dayanır: görsel URL'sinin herkese açık olmaması, görselin çok büyük olması, platformun eski bir sürümü önbelleğe alması, etiketlerin yanlış sayfayı hedeflemesi veya görsel formatının desteklenmemesi. Bu kılavuz, Facebook, X ve LinkedIn'in sağladığı hata ayıklama araçlarıyla her düzeltmeyi adım adım ele alır.
og:image neden görüntülenmiyor?
Çoğu zaman görsel URL'si herkese açık şekilde erişilebilir değildir, dosya platformun sınırlarını aşar veya platform önbelleğe alınmış bir kopyayı gösteriyordur. Sosyal platformlar belirli bir zamanlamayla yeniden tarama yapar ve agresif şekilde önbelleğe alır; bu nedenle yeni bir görsel, hata ayıklama araçlarıyla yenilemeyi zorlamadığınız sürece genellikle "çalışmıyor" gibi görünür.
En yaygın beş neden (ve çözümleri)
1. Görsel URL'si herkese açık değil
Platformlar görseli kimlik doğrulaması olmadan getirmelidir. Oturum açma gerektiren bir URL, localhost veya bir IP adresi başarısız olur.
Çözüm: görseli herkese açık, HTTPS bir URL'de barındırın ve curl -I <image-url> adresinin bir görsel Content-Type ile 200 OK döndürdüğünü doğrulayın.
2. Görsel çok büyük
Çoğu platform OG görsellerini 8 MB ile sınırlar (X yaklaşık 5 MB). Büyük bir PNG sessizce başarısız olur.
Çözüm: dosyayı 5 MB altında tutun; 1200×630'lık bir metin kartı genellikle 200–500 KB'dir. FastOG'da PNG çıktısı zaten bu boyut için ayarlanmıştır.
3. Platform eski bir sürümü önbelleğe aldı
Facebook, X, LinkedIn, Slack ve Discord hepsi agresif şekilde önbelleğe alır. Meta ayrıca görselin kendi kopyasını saklar ve önizlemeyi sayfa URL'sine göre anahtarlar; bu nedenle yalnızca yeni bir görsel URL'si bunu değiştirmez. Görseli değiştirdikten sonra eski kart saatler veya günler boyunca görünmeye devam eder.
Çözüm: platformun aracıyla (aşağıda) bir tarama zorlayın. Değişen görseller için içerikle birlikte değişen bir URL kullanın (FastOG'un imzalı URL'leri bunu otomatik yapar). Programatik yenilemeye izin veren tek platform için bkz. Facebook Open Graph Önbellek Yenilemeyi Zorlama.
4. Yanlış URL veya yanlış sayfa
og:image etiketi eksik, yinelenmiş veya bu etiketi içermeyen bir sayfayı işaret ediyor olabilir.
Çözüm: sayfa kaynağını görüntüleyin ve og:image etiketinin sunucu tarafında render edildiğini ve mutlak olduğunu doğrulayın.
5. Desteklenmeyen format
Bazı platformlar belirli formatları veya animasyonlu görselleri reddeder.
Çözüm: PNG veya JPG kullanın; 1200×630 desteklenen orandır.
Hata ayıklama araçları
| Platform | Araç |
|---|---|
| Facebook / WhatsApp | Sharing Debugger — developers.facebook.com/tools/debug |
| X / Twitter | Card Validator — cards-dev.twitter.com/validator |
Post Inspector — linkedin.com/post-inspector |
URL'yi yapıştırın, ardından en güncel etiketleri çekmek için "Scrape" / "Refresh" düğmesine tıklayın.
FastOG'a özgü detaylar
- FastOG, desteklenen boyut olan 1200×630 PNG üretir; böylece boyut/oran sorunları yaşanmaz.
- İmzalı URL'ler yalnızca ilk işlemeyi (render) sınırlar; önbelleğe alınan görseller geçerli kalır, bu nedenle paylaşılan bir kart çalışmaya devam eder.
- Başlığı değiştirin → URL değişir → yeni bir işleme gerçekleşir. Platform, yeniden tarama (re-scrape) zorladığınızda (eninde sonunda) yeni kartı algılar.
SSS
FastOG, og:image görselimin görünmesini garanti ediyor mu?
FastOG, herkese açık bir URL'den geçerli bir 1200×630 PNG sunar. Platformun bunu gösterip göstermemesi kendi önbelleğine bağlıdır — bir görseli değiştirdikten sonra doğrulayıcı ile yeniden taratın.
Facebook'ta güncelleme yapmama rağmen neden eski görsel görünüyor?
Facebook taramaları önbelleğe alır ve görselin kendi kopyasını saklar — bu nedenle yalnızca yeni bir og:image URL'si bunu değiştirmez. Sharing Debugger → "Scrape Again" seçeneğini kullanın; Force a Facebook Open Graph Cache Refresh API yolunu, gereken uygulama token'ını ve uyulması gereken hız sınırlarını kapsar.
X'in yeni kartımı göstermesini nasıl sağlarım?
X Card Validator'ı açın ve URL'yi yapıştırın. En son og:image ve twitter:image değerlerini yeniden getirir.