Open Graph kontrolü: OG etiketlerini ve link önizlemelerini test edin

Bir URL girerek Facebook, X, LinkedIn ve sohbet uygulamalarında paylaşıldığında nasıl görüneceğini görün. Kontrol her og:* ve twitter:* etiketini okur, önizleme görselini ölçer ve tam olarak neyi düzeltmeniz gerektiğini söyler.

Bir Open Graph kontrolü, biri linkinizi bir gönderiye ya da sohbete yapıştırdığında bir tarayıcının gördüğünü gösterir: sayfanızın og:* ve twitter:* meta etiketlerinde bildirilen başlık, açıklama ve görsel. Bir önizleme yanlış resmi, hiç resim göstermiyorsa ya da makale başlığı yerine site adınızı gösteriyorsa neden hemen her zaman bu birkaç satır HTML’dedir; bu sayfa da hangi satır olduğunu söyler.

Open Graph etiketlerinizi nasıl kontrol edersiniz

  1. Paylaşmak istediğiniz sayfanın URL’sini girin ve Etiketleri kontrol et’e basın. Yönlendirmeler izlenir ve analiz edilen, nihai URL’dir.
  2. Önizlemelere bakın. Bunlar, Facebook, X, LinkedIn ve sohbet uygulamalarının bir link kartını her birinin okuduğu etiketlerden nasıl yerleştirdiğinin yaklaşık görünümleridir.
  3. Kontrolleri gözden geçirin. Hatalar önizlemeleri bozar; uyarılar bazı platformlarda onları kötüleştirir; notlar iyi uygulamadır. Her biri neyi değiştireceğinizi söyler.
  4. Düzeltin ve yeniden kontrol edin. Önerilen etiketler kutusu, mevcut değerlerinizin doldurulduğu, düzenlemeye hazır bir etiket bloğu verir.
  5. Düzeltmeyi yayımladıktan sonra platformların önbelleklerini yenileyin (aşağıya bakın); yoksa eski paylaşımlar eski önizlemeyi göstermeye devam eder.

Bir hazırlık sitesi, bir girişin arkasındaki sayfa ya da localhost üzerindeki herhangi bir şey içinHTML yapıştır’a geçin: sayfa kaynağını yapıştırın; aynı kontroller tarayıcınızda çalışır.

Her sayfanın ihtiyaç duyduğu Open Graph etiketleri

Open Graph, çoğu link önizlemesinin arkasındaki protokoldür. Her sayfa için dört özelliği zorunlu işaretler (ogp.me) ve LinkedIn, paylaşım önizlemeleri için bulunması gereken etiketler olarak başlığı, görseli, açıklamayı ve URL’yi sıralar (LinkedIn Yardım).

EtiketNe yaparİpucu
og:titleKartın başlığı. Zorunlu.Aramaya değil akışa göre yazın; marka adınızı içermesi gerekmez.
og:typeNesnenin türü, örn. website ya da article. Zorunlu.Gönderiler için article kullanın; article:* etiketlerinin kilidini açar.
og:imageÖnizleme görseli. Zorunlu.Tam bir https:// URL’si kullanın; genişlik, yükseklik ve alt metni de ayarlayın.
og:urlNesnenin kalıcı kimliği olarak kullanılan kanonik URL’si. Zorunlu.<link rel="canonical"> ile eşleşsin.
og:descriptionBaşlığın altında bir ya da iki cümle. Protokolde isteğe bağlı, LinkedIn için zorunlu.Sayfanın ne olduğunu değil, okuyucunun ne alacağını söyleyin.
og:site_nameSitenin bütününün adı.Birçok sohbet uygulamasında başlığın üstünde gösterilir.
og:image:altGörselin açıklaması. Protokol, og:image belirten bir sayfanın bunu da belirtmesi gerektiğini söyler.Sayfayı değil, görseli tarif edin.
og:image:width / og:image:heightPiksel cinsinden görsel boyutu.Facebook, link ilk paylaşıldığında görselin düzgün yüklenmesi için bunları belirtmenizi söyler.
og:localeİçeriğin dili ve bölgesi, örn. tr_TR.Facebook bunu og:type ile birlikte önerir.

Bir etiket iki kez geçerse ilki kazanır: değerler çeliştiğinde protokol yukarıdan aşağıya ilk etikete öncelik verir. Yinelenenler genellikle bir temanın ve bir SEO eklentisinin ikisinin de etiket yazmasından gelir; kontrol bunları işaretler.

Türkçe içerik yayımlıyorsanız og:locale için tr_TR değerini kullanın ve og:title ile og:description içindeki ç, ğ, ı, ö, ş, ü harflerinin sayfanızda UTF-8 olarak sunulduğundan emin olun; karakter kodlaması yanlışsa önizlemelerde bu harfler bozuk görünebilir. Bir görselin og:image:alt metnini de sayfanın diliyle yazın. Paylaşımdan önce önizlemeyi en az bir kez bu araçla, ardından hedef platformun kendi hata ayıklayıcısıyla kontrol etmek, yanlış görsel ya da eski başlıkla paylaşım yapma riskini azaltır.

Twitter (X) kartı etiketleri

X’in kart işaretleme başvurusuna göre (X geliştirici belgeleri, arşivlenmiş, İngilizce) X kendi twitter:* etiketlerini okur ve çoğu için Open Graph’a geri döner:

  • twitter:card: kart türü; summary (küçük kare görsel) ya da summary_large_image (geniş görsel). Yoksa ama og:type, og:title ve og:description varsa bir özet kartı oluşturulabilir.
  • twitter:title: en fazla 70 karakter; og:title’a geri döner.
  • twitter:description: en fazla 200 karakter; og:description’a geri döner.
  • twitter:image: 5 MB’ın altında; JPG, PNG, WEBP ve GIF (yalnızca ilk kare); SVG desteklenmez. og:image’a geri döner.
  • twitter:image:alt: en fazla 420 karakter; og:image:alt’a geri döner.

Pratikte Open Graph artı tek bir satır, yani <meta name="twitter:card" content="summary_large_image">, X’i kapsar.

og:image boyutu: her platform ne ister

PlatformBelgelenmiş gereksinim
LinkedInEn az 1200 × 627 px, önerilen oran 1,91:1, en çok 5 MB dosya boyutu (LinkedIn Yardım)
FacebookYüksek çözünürlüklü cihazlarda en iyi görüntü için en az 1080 px genişlik; og:image:width ve og:image:height belirtin (Meta paylaşım en iyi uygulamaları)
X: büyük görsel kartı2:1 oran, en az 300 × 157, en çok 4096 × 4096 px, 5 MB’ın altında (X belgeleri, arşivlenmiş)
X: özet kartı1:1 oran, en az 144 × 144, en çok 4096 × 4096 px, 5 MB’ın altında, kareye kırpılır (X belgeleri, arşivlenmiş)

Tek bir görsel hepsini karşılayabilir: 1200 × 630 piksel, PNG ya da JPEG, 5 MB’ın altında. LinkedIn’in asgarisini ve Facebook’un genişlik önerisini aşar, yaklaşık 1,91:1 oranındadır ve X onu 2:1’lik büyük kartı için hafifçe kırpar. Kırpma onları kesmesin diye metni ve logoları kenarlardan uzak tutun. X ayrıca genel bir site logosu yerine sayfa başına benzersiz bir görsel ister; bu her yerde mantıklı bir kuraldır.

Link önizlemeniz neden yanlış ve nasıl düzeltilir

Eski görsel ya da başlık görünmeye devam ediyor

Platformlar önizlemeleri önbelleğe alır. Facebook görselleri URL’ye göre önbelleğe alır ve URL değişmedikçe güncellemez (Meta for Developers); bu yüzden değiştirilmiş bir görseli yeni bir dosya adıyla yükleyin, ardından sayfayı yeniden tarama tetikleyenSharing Debugger aracından geçirin. LinkedIn’de URL’yi yenilemek için Post Inspector’ı kullanın.

Hiç görsel yok

Yukarıdaki Önizleme görseli tablosuna bakın. Sık nedenler: og:image göreli bir yoldur, görsel tarayıcılara 403 ya da 404 döndürür (hotlink koruması, korumalı bir dizin, bir CDN kuralı), bir SVG’dir ya da 5 MB’ın üzerindedir. LinkedIn, gereksinimleri karşılayan bir görselin yine de site LinkedIn’in onu çekmesini engelliyorsa başarısız olabileceğini belirtir.

Etiketler tarayıcıda var ama burada yok

Etiketler büyük olasılıkla sayfa yüklendikten sonra JavaScript ile ekleniyordur. Tarayıcılar sunucunun gönderdiği HTML’i okur; bu yüzden etiketleri sunucuda oluşturulan ya da önceden derlenmiş HTML’e taşıyın. Tek sayfalı uygulamalar paylaşım önizlemeleri için genellikle sunucu tarafı oluşturmaya ya da ön oluşturmaya ihtiyaç duyar.

Yanlış sayfa önizleniyor

URL yönlendiriyorsa tarayıcılar nihai sayfayı önizler. Kontrol yönlendirme sayısını gösterir;yönlendirme kontrolü ise her adımı listeler. Ayrıca og:url’nin ana sayfanızı değil sayfanın kendisini gösterdiğinden emin olun; bu yaygın bir şablon hatasıdır.

Open Graph etiketleri ve SEO meta etiketleri

<title>, meta açıklaması ve canonical link arama motorları içindir; Open Graph ve Twitter etiketleri paylaşımlar içindir. Farklı olabilirler: bir paylaşım başlığı bir arama başlığından daha çarpıcı olabilir; ama kanonik URL ile og:url uyumlu olmalı ve bir sayfayı tanıtmadan önce bir noindex robots yönergesinin varlığını bilmekte fayda var. Kontrol bunların hepsini, bir X-Robots-Tag HTTP üst bilgisi dahil, raporlar.

Kontrol URL’nizle ne yapar

Sunucumuz sayfayı bir kez ister, sekize kadar yönlendirmeyi izler, en fazla ilk 600 KB’ı okur (<head> sonunda durur) ve boyutlarını ve biçimlerini okumak için en fazla iki önizleme görselinin ilk kısmını indirir. Yalnızca standart bağlantı noktalarındaki herkese açık http(s) adreslerini getirir ve bir yönlendirme oraya işaret ettiğinde de dahil olmak üzere özel, yerel ve bulut meta veri IP’lerini reddeder. Hiçbir şey saklanmaz. Önizleme kartları ardından görseli doğrudan tarayıcınızda yükler. Bir kampanya linki paylaşıyorsanız onu UTM oluşturucuyla hazırlayın; başkasının linkini paylaşıyorsanız önce izlemeyi URL temizleyiciyle ayıklayın.

Sıkça Sorulan Sorular

Open Graph kontrolü ne yapar?

Bir sayfayı link önizleme tarayıcısı gibi getirir, HTML başlığındaki Open Graph (og:*) ve Twitter kartı (twitter:*) etiketlerini okur ve paylaşılan bir linkin nasıl görüneceğini gösterir. Bu araç ayrıca önizleme görselini indirip biçimini, piksel boyutunu ve dosya boyutunu kontrol eder; eksik ya da geçersiz her etiketi bir çözümle birlikte listeler.

Hangi Open Graph etiketleri zorunludur?

Open Graph protokolü dört zorunlu özelliği sayar: og:title, og:type, og:image ve og:url. LinkedIn, önizlemeleri için og:title, og:image, og:description ve og:url etiketlerinin bulunması gerektiğini söyler; bu yüzden pratikte beşini de, ayrıca görsel için og:image:alt etiketini de ayarlayın.

og:image’im hangi boyutta olmalı?

Tek bir resmî boyut yoktur. LinkedIn, 1,91:1 oranında en az 1200 × 627 piksel ve 5 MB’ın altında bir görsel ister. Facebook en az 1080 piksel genişliğinde görseller önerir. X’in büyük görsel kartı 2:1 oranını, en az 300 × 157 boyutunu ve 5 MB sınırını kullanır. 5 MB’ın altında 1200 × 630’luk bir PNG ya da JPEG hepsini karşılar.

Facebook ya da LinkedIn neden hâlâ eski önizlememi gösteriyor?

Platformlar link önizlemelerini önbelleğe alır. Facebook görselleri URL’ye göre önbelleğe alır ve URL değişmedikçe yenilemez; bu yüzden güncellenmiş görseli yeni bir dosya adıyla yayımlayın, ardından yeniden tarama tetiklemek için sayfayı Facebook’un Sharing Debugger aracından geçirin. LinkedIn’in Post Inspector aracı LinkedIn için aynısını yapar.

Zaten Open Graph etiketlerim varsa Twitter kartı etiketlerine ihtiyacım var mı?

X çoğu alanda Open Graph’a geri döner: twitter:title için og:title’a, twitter:description için og:description’a, twitter:image için og:image’a. twitter:card olmadan X, og:type, og:title ve og:description’dan yine de küçük bir özet kartı oluşturabilir. Büyük görsel düzenini istiyorsanız twitter:card’ı summary_large_image değeriyle ekleyin.

Kontrol JavaScript çalıştırıyor mu?

Hayır. Sunucunun döndürdüğü HTML’i okur; çoğu link önizleme tarayıcısı da onu okur. Etiketleriniz yalnızca istemci tarafı JavaScript çalıştıktan sonra görünüyorsa burada eksik çıkarlar, büyük olasılıkla gerçek paylaşımlarda da. Onları sunucuda ya da derleme sırasında oluşturun.

Bir hazırlık (staging) ya da localhost sayfasını kontrol edebilir miyim?

URL ile değil: güvenlik için kontrol yalnızca herkese açık adresleri getirir ve özel, yerel ve bulut meta veri IP’lerini engeller. Bunun yerine HTML Yapıştır sekmesini kullanın: sayfa kaynağını yapıştırın; tamamen tarayıcınızda analiz edilir ve görsel boyutları yerelde ölçülür.

Önizlemeler her platformun göstereceğiyle birebir aynı mı?

Hayır, bunlar her platformun belgelediği etiketlerden üretilmiş yaklaşık görünümlerdir. Her ağ kendi yerleşimini, kırpmasını, kısaltmasını ve önbelleğini uygular ve bunları zamanla değiştirir. Önizlemeleri eksik görselleri ve kötü başlıkları yakalamak için kullanın, büyük bir lansmandan önce platformun kendi hata ayıklayıcısıyla doğrulayın.

← Ücretsiz araçlar

Ana Sayfa · Marqly