Twitter Card Validator Nedir? Kartları Oluşturma ve Test

Etkisepeti EkibiEtkisepeti Ekibi
11 dk okuma
Twitter Card Validator Nedir? Kartları Oluşturma ve Test

Twitter Card nedir, X’te link önizlemesi neden bazen yanlış görünür? Twitter Card Validator ile meta etiketleri test etmeyi, önbellek sorunlarını ve temel kurulumu Etkisepeti notlarıyla anlatıyoruz.

Twitter Card nedir? Card Validator neyi kontrol eder?

Twitter Card nedir diye sorarsanız: X’te bir link paylaştığınızda görünen başlık, açıklama ve görselden oluşan link önizlemesidir. Twitter Card Validator (X Card Validator) ise paylaşmadan önce sayfanızın bu kart bilgisinin doğru okunup okunmadığını test etmenizi sağlar: URL’yi sunucudan çeker, HTML içindeki meta etiketleri okur ve kartın nasıl görüneceğini önizleme olarak gösterir. Böylece yanlış görsel kırpılması, boş başlık ya da önbellek kaynaklı “eski kart” gibi sorunları daha paylaşım performansını etkilemeden yakalayabilirsiniz.

Başlarken şu noktaları netleştirmek işinizi kolaylaştırır:

  • Kartın “içeriği” meta etiketlerden gelir: başlık, açıklama, görsel.
  • Doğrulayıcıda doğru görünse bile, gerçek paylaşımda önbellek nedeniyle bir süre eski kart görünebilir.
  • En az 4 etiketle (twitter:card, twitter:title, twitter:description, twitter:image) sağlam bir temel kurabilirsiniz.
  • Görsel oranı ve dosyaya erişim (403/404) en sık hata kaynağıdır.
X'te link önizlemesi
Link paylaşımında kart, içeriğin “ilk izlenim” katmanıdır.

URL’yi çekip meta etiketleri okuma mantığı

Doğrulayıcının yaptığı iş, sayfayı bir tarayıcı gibi “tam render” etmekten ziyade HTML çıktısını alıp meta etiketleri okumaktır. Bu yüzden meta etiketleri JavaScript ile sonradan üreten (istemci tarafında çalışan) sayfalarda sorun yaşanabilir: bot HTML’yi erken okur, siz meta bilgisini geç üretirsiniz.

Önizleme ile gerçek paylaşım neden farklı görünebilir?

Doğrulayıcı önizlemesi, “X bu sayfadan şu an ne okuyabiliyor?” sorusuna cevap verir. Gerçek paylaşımda ise önbellek devreye girer: X daha önce aynı URL’yi taradıysa, bir süre eski kartı göstermeye devam edebilir. Bu yüzden “düzelttim ama değişmedi” durumu sık görülür.

Hangi durumlarda doğrulayıcıya bakmak gerekir?

  • Yeni bir site/tema yayına aldığınızda
  • Blog yazısı şablonunu (başlık/açıklama/öne çıkan görsel) değiştirdiğinizde
  • CDN, güvenlik duvarı veya görsel erişim kısıtları eklediğinizde
  • Paylaşımda yanlış görsel veya boş başlık gördüğünüzde

Kartı doğrulamak neden önemli?

Twitter Card’ı doğrulamak, link paylaşımının “görsel ve metin ambalajını” kontrol etmek demektir. Kart bozuksa, içerik iyi olsa bile kullanıcı tıklamadan geçebilir. Bu da hem görünürlüğü hem de gelen trafiğin kalitesini etkileyebilir.

Yanlış görsel/kırpılma, boş başlık-açıklama gibi sorunların etkisi

Kartta görselin yanlış kırpılması, başlığın yarım görünmesi veya açıklamanın boş kalması genellikle iki şeye yol açar: (1) tıklama isteği düşer, (2) tıklayan kişi beklentisiyle sayfa içeriği uyuşmazsa hızlı geri döner.

Paylaşım performansına etki eden sinyaller: tıklama, kalma, geri dönüş

X tarafında algoritmanın tüm detayları açık değil; ama mühendislik açısından bakınca kart, çoğu durumda tıklama oranını etkileyen bir katman. Tıklama sonrası sayfada kalma ve geri dönme davranışı da (özellikle link paylaşımlarında) içeriğin “beklentiyi karşılama” kalitesine işaret eder. Kartınız net değilse, yanlış kitleyi çekip hızlı geri dönüşü artırabilirsiniz.

“Düzelttim ama değişmedi”: önbellek gerçeği

X, aynı URL için kart verisini bir süre saklayabilir. Siz meta etiketleri güncellediğinizde, doğrulayıcı yeni veriyi görse bile akışta eski kartın görünmesi mümkündür. Bu noktada önce kendi sunucunuzun/CDN’in güncel HTML verdiğini doğrulamak, ardından yeniden taratma denemek mantıklıdır.

URL’yi UTM gibi parametrelerle değiştirmek ise önbelleği aşma taktiği gibi düşünülmemeli. UTM’ler esas olarak ölçüm içindir; kullanacaksanız kanonik URL disiplinini bozmadan (ör. sayfada rel="canonical" doğruyken) ve aynı içeriğin birden fazla “asıl adresi” varmış gibi görünmesine yol açmadan ilerleyin.

Hangi kart türünü seçmelisiniz?

Kart türünü seçmek (card type), içeriğinizin X akışında nasıl görüneceğini belirler. Yeni başlayanlar için en pratik iki seçenek: Summary Card (küçük görsel) ve Summary Card with Large Image (büyük görsel). Diğer kartlar (Player/App) daha özel senaryolarda anlamlıdır.

Summary Card (küçük görsel) ne zaman yeter?

Summary Card, küçük bir görsel + başlık + açıklama ile daha kompakt görünür. Genellikle şu durumlarda yeterlidir:

  • Haber/duyuru gibi metin ağırlıklı içerikler
  • Görselin kritik olmadığı, başlığın taşıdığı paylaşımlar
  • Blog yazılarında daha sade bir görünüm istediğiniz durumlar

Summary Card with Large Image (büyük görsel) ne zaman daha iyi çalışır?

Summary Card with Large Image, görselin daha baskın olduğu karttır. Çoğu içerikte daha iyi çalışmasının nedeni basit: akışta daha çok yer kaplar ve mesajı daha hızlı anlatır. Şunlarda özellikle mantıklıdır:

  • Rehber içerikler, liste yazıları, lansman sayfaları
  • Ürün/özellik anlatımı (tek bir görselle mesajı taşıyabiliyorsanız)
  • Video/kapak görseli güçlü içerikler

Player/App kartları kimler için anlamlı?

Player kartı, sayfa içinde oynatıcı (video/ses) gömmek isteyen yayıncılar için; App kartı ise uygulama indirme odaklı markalar için daha uygundur. Çoğu blog ve küçük işletme için önce temel kartların sorunsuz çalışması daha değerlidir.

Başlık ve görsel seçimi
Kart türü seçimi, içeriğinizi akışta nasıl konumlandırdığınızı değiştirir.

Card Validator ekranında nelere bakmalısınız?

Card Validator kullanımı pratikte “URL’yi yapıştır, tara, sonucu oku” akışıdır. Asıl değer, sonuç ekranındaki uyarıları doğru yorumlamaktan gelir.

URL yapıştırma → sayfayı çekme → sonuçları okuma

  1. Test etmek istediğiniz sayfanın tam URL’sini kopyalayın (tercihen https).
  2. Doğrulayıcıya URL’yi yapıştırın ve taramayı başlatın.
  3. Önizlemede başlık, açıklama ve görselin beklediğiniz gibi göründüğünü kontrol edin.
  4. Varsa hata/uyarı mesajlarını not alın (özellikle görsel erişimi ve yönlendirmeler).

“Güncel değil” görünüyorsa: önce kendi önbelleğinizi kontrol edin

Meta etiketleri değiştirdiyseniz ve doğrulayıcı hâlâ eskiyi gösteriyorsa, önce sunucunuzun gerçekten güncel HTML verdiğinden emin olun (sayfa önbelleği/CDN). Doğrulayıcı günceli gösteriyor ama X’te eski kart çıkıyorsa, bu kez X’in önbelleği devrededir; yeniden taratma denemek ve biraz beklemek gerekebilir.

Şablon kontrolü: ana sayfa, bir blog yazısı, bir ürün/hizmet sayfası

Tek bir sayfayı düzeltmek yetmeyebilir; çoğu sitede kartlar şablonla üretilir. Bu yüzden en azından şu üç sayfayı kontrol etmek iyi bir alışkanlıktır:

  • Ana sayfa (genel marka kartı)
  • Bir blog yazısı (yazı şablonu)
  • Bir ürün/hizmet sayfası (ticari sayfa şablonu)

En sık görülen hatalar ve pratik çözümler

Doğrulama hataları genellikle iki kaynaktan çıkar: (1) X’in sayfaya erişememesi, (2) sayfanın doğru meta etiketleri üretmemesi. Aşağıdaki tablo, en sık görülen sorunları daha hızlı ayıklamak için kullanılabilir.

Yaygın doğrulama hataları ve pratik çözümler
Belirti Muhtemel neden Ne yapmalı?
Görsel görünmüyor 403/404, görsel erişim kısıtı, yanlış URL Görsel URL’sini tarayıcıda açın; CDN/izin ayarlarını kontrol edin.
Başlık/açıklama boş Meta etiket yok, yanlış şablon, meta bilginin geç üretilmesi HTML kaynakta twitter:title ve twitter:description var mı bakın.
Eski kart görünüyor X önbelleği veya CDN önbelleği Önce sunucu çıktısını doğrulayın; sonra yeniden taratma deneyin.
Yanlış sayfa kartı geliyor Çok adımlı yönlendirme, http→https karmaşası Tek adım yönlendirme ve kanonik URL kullanın.
Görsel kırpılıyor Oran uyumsuz, odak noktası ortada değil Görseli daha güvenli oranla hazırlayın; metni kenarlara yaslamayın.

Görsel erişilemiyor (403/404): CDN ve izinler

X’in botları görseli indiremezse kartta görsel çıkmaz. En sık sebep, görselin bulunduğu sunucunun dışarıdan erişimi kısıtlamasıdır. CDN kullanıyorsanız, botların erişimine izin verildiğinden emin olun. Görsel URL’si tarayıcıda açılıyor diye her bot açabilir anlamına gelmez; bazı güvenlik katmanları kullanıcı ajanına göre farklı davranabilir.

Robots.txt ve sayfa yönergeleri (noindex vb.)

Robots.txt ile sayfanın veya görsellerin taranması engellenmiş olabilir. Ayrıca bazı sayfalarda noindex gibi yönergeler bulunabilir. Bu ayarlar SEO için düşünülür ama sosyal medya botlarını da etkileyebilir.

Yönlendirme zinciri ve http→https sorunları

URL birden fazla kez yönleniyorsa (A→B→C), botlar bazen doğru sayfaya ulaşsa bile meta etiket okuması tutarsızlaşabilir. Mümkünse tek adım yönlendirme kullanın ve her yerde https standardına geçin.

Başlık/açıklama çok uzunsa kırpılabilir

Başlık ve açıklama çok uzunsa kartta kırpılır. Bu bir “hata” gibi görünmese de mesajı zayıflatır. Genel iyi uygulama: başlığı kısa ve net tutmak, açıklamada ise tek cümleyle “ne kazanacağım?” sorusunu cevaplamak.

Dış kaynak: Open Graph protokolü ve meta etiket mantığını anlamak için iyi bir başlangıçtır.

Dinamik sayfalarda meta bilginin geç üretilmesi

Tek sayfa uygulama (SPA) veya yoğun JavaScript kullanan sitelerde meta etiketler sayfa yüklendikten sonra değiştiriliyorsa, botlar bu değişimi görmeyebilir. Çözüm çoğu durumda meta bilgisini sunucu tarafında üretmek (SSR) veya sayfa başına statik meta üretmektir. WordPress gibi sistemlerde bu sorun daha az görülür; modern framework’lerde ise özellikle dikkat ister.

Twitter Card nedir ve nasıl oluşturulur? Meta etiketlerle temel kurulum

Uygulamada twitter card nedir sorusu, “X link önizlemesini hangi meta etiketlerden üretiyor?” sorusuna bağlanır. Kurulumun özü basittir: sayfanızın <head> bölümünde kartı tarif eden alanlar (kart tipi, başlık, açıklama, görsel) net ve erişilebilir olmalı. Bu yapı doğruysa, Twitter Cards çıktısı sayfadan sayfaya daha tutarlı görünür.

Twitter Cards için minimum meta etiketler (aç/kapa)
  • twitter:card (kart tipi)
  • twitter:title (başlık)
  • twitter:description (açıklama)
  • twitter:image (görsel URL)

Open Graph (og:*) ile birlikte kullanma

Birçok platform Open Graph etiketlerini (og:*) okur. X de bazı durumlarda twitter:* eksikse og:* alanlarını yedek olarak kullanabilir. Bu yüzden pratik yaklaşım şudur: og etiketleri ve Twitter etiketleri birlikte tanımlanır; böylece hem X hem diğer sosyal ağlar tutarlı önizleme üretir. Birden fazla sayfada Twitter Cards görünümünü standardize etmek istiyorsanız bu ikili kurulum işinizi kolaylaştırır.

Örnek meta etiket bloğu

Aşağıdaki örnekteki başlık, açıklama, görsel ve URL alanlarını her sayfaya göre değiştirin. Aynı başlık/açıklamayı tüm sayfalara kopyalamak, kartların birbirine benzemesine ve yanlış beklenti yaratmasına neden olabilir. Ayrıca görsel URL’sinin dışarıdan erişilebilir olduğundan emin olun.

<!-- Twitter / X -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Başlık buraya">
<meta name="twitter:description" content="Açıklama buraya">
<meta name="twitter:image" content="https://siteadresiniz.com/gorsel.jpg">

<!-- Open Graph (diğer platformlar için) -->
<meta property="og:title" content="Başlık buraya">
<meta property="og:description" content="Açıklama buraya">
<meta property="og:image" content="https://siteadresiniz.com/gorsel.jpg">
<meta property="og:url" content="https://siteadresiniz.com/sayfa">
<meta property="og:type" content="article">

Görsel oranı: kırpılmayı azaltan pratik kurallar

Kırpılmayı azaltmak için en güvenli yaklaşım, görselin merkezinde “nefes alanı” bırakmak ve metni kenarlara dayamamaktır. Büyük görsel kart kullanıyorsanız, odak noktası ortada olmalı; logo/başlık gibi kritik öğeler köşelere sıkışmamalı. Ayrıca görsel URL’sinin dışarıdan erişilebilir olması (403 vermemesi) şarttır.

Meta etiketlerle kart hazırlama
Görselin erişilebilir olması ve doğru oran, kart kalitesini belirler.

WordPress ve benzeri altyapılarda kurulum (kodsuz seçenekler)

Kodla uğraşmak istemiyorsanız, WordPress’te SEO eklentileri üzerinden Twitter/X kart alanlarını doldurmak genellikle yeterlidir. Burada amaç, her sayfanın başlık-açıklama-görsel bilgisini tutarlı üretmektir. Bu düzen oturduğunda, farklı içeriklerde Twitter Cards görünümü daha az sürpriz çıkarır.

SEO eklentilerinde hangi alanlar doldurulmalı?

Çoğu eklentide “Twitter” veya “Sosyal” sekmesinde şu alanlar bulunur: kart tipi, varsayılan görsel, başlık şablonu, açıklama şablonu. Varsayılan görseli mutlaka belirleyin; bazı sayfalarda öne çıkan görsel yoksa boş kart oluşmasını engeller.

Öne çıkan görselin karta etkisi

  • Öne çıkan görsel yeterince net mi?
  • Görsel URL’si dışarıdan erişilebilir mi?
  • Başlık ve açıklama, sayfa içeriğiyle aynı vaadi mi veriyor?

Ürün/hizmet sayfalarında başlık ve görsel standardı

Ürün sayfalarında kart kalitesi, “ürün adı + net fayda” başlığı ve temiz ürün görseliyle belirgin şekilde artar. Varyantlı ürünlerde (renk/beden) URL’lerin yönlendirme ve kanonik ayarları düzgün değilse doğrulayıcı farklı sayfaları karıştırabilir.

Etkisepeti notu: Kart kalitesi görünürlüğü nasıl etkileyebilir?

Etkisepeti’nin mühendislik bakışıyla kart optimizasyonu, algoritmayı “kandırmak” değil; içeriği doğru kitleye doğru şekilde sunmaktır. Kart, sosyal medya akışında içeriğinizi temsil eden bir arayüz bileşeni gibi çalışır: netlik arttıkça yanlış tıklamalar azalır, doğru beklentiyle gelen tıklamalar artma eğilimindedir.

Kartı “paketleme katmanı” gibi düşünün

İyi bir kart, kullanıcıya hızlıca üç şeyi söyler: “Bu ne?”, “Bana ne katacak?”, “Tıklayınca ne göreceğim?”. Bu üçlü netse, tıklama sonrası sayfada kalma davranışı da çoğu hesapta daha sağlıklı olur.

Yerel kitle uyumu: Türkçe başlık/açıklamada netlik

Türkçe kitleye hitap eden paylaşımlarda, başlıkta gereksiz İngilizce karışımı ve muğlak ifadeler yerine net bir Türkçe vaat çoğu durumda daha iyi çalışır. Örneğin “Link preview ayarları” yerine “Link paylaşınca görsel neden yanlış çıkıyor?” gibi daha anlaşılır bir cümle, doğru beklentiyi kurar.

Düzenli tempo: link paylaşımlarını akışa yaymak

Kartlarınız düzgün çalışıyorsa, link paylaşımlarını “bir günde yüklenip sonra kaybolan” bir düzenden çıkarıp daha düzenli bir akışa oturtmak kolaylaşır. Etkisepeti’nin kademeli teslimat (drip-feed) yaklaşımında olduğu gibi, sosyal tarafta da ani sıçramalar yerine daha doğal görünen, düzenli bir tempo çoğu hesapta daha sağlıklı sinyal üretebilir.

Paylaşım sonrası takip edilecek sayılar

Kartı sadece “güzel görünsün” diye değil, ölçülebilir sonuç için iyileştirin. X’te link paylaşımı sonrası en anlamlı takip edilecek sayılar genellikle link tıklaması, profil ziyareti ve takip dönüşümüdür. Planlı kampanyalarda link tıklaması odağınız varsa, Twitter (X) link tıklaması sayfasındaki teslimat yaklaşımına göz atabilirsiniz; yerel kitle uyumunu korumak isteyenler için de Twitter (X) Türk takipçi seçenekleri ayrı bir çerçeve sunar.

Paylaşım performansı ve ölçüm
Kart doğruysa, ölçüm tarafında “ne işe yaradı?” sorusunu daha net cevaplayabilirsiniz.

İçerik tarafını güçlendirmek için şu yazılar da işinize yarayabilir:

Dış kaynak: Meta etiketlerin sosyal platformlarda nasıl kullanıldığına dair genel çerçeve için MDN meta etiketi dokümantasyonu faydalıdır.

Sıkça Sorulan Sorular

Twitter Card nedir, Open Graph’ten farkı ne?

Twitter Card, X’in link önizlemesi için okuduğu twitter:* meta etiketlerine dayanır. Open Graph ise daha genel bir standarttır (og:*). Çoğu sitede ikisini birlikte kullanmak, farklı platformlarda tutarlı önizleme üretmeyi kolaylaştırır. Bu yaklaşım, birden fazla URL için Twitter Cards çıktısının tutarlı olmasına da yardımcı olur.

Twitter Card nasıl oluşturulur: Her sayfaya ayrı başlık ve açıklama yazmak gerekir mi?

İdeal olan evet: her sayfanın twitter:title ve twitter:description alanı o sayfanın içeriğini anlatmalı. Altyapınız izin vermiyorsa, en azından şablonun doğru çalıştığından ve kritik sayfalarda (ana sayfa, en çok trafik alan içerikler) özel alanların dolu olduğundan emin olun. Özellikle blog şablonunda kurulum mantığı doğru kurulursa, yeni içerikler otomatik olarak düzgün kart üretir.

Kartım doğrulayıcıda doğru görünüyor ama X’te yanlış çıkıyor, neden?

En sık neden önbellektir. X daha önce URL’yi taradıysa eski kartı bir süre gösterebilir. Ayrıca URL’nin yönlendirme (http→https gibi) durumu ve CDN önbelleği de fark yaratabilir. Önce sayfanın kaynak kodunda güncel meta etiketlerin gerçekten çıktığından emin olun.

“Twitter Cards” ifadesi neyi anlatır?

Twitter Cards, Twitter Card’ın çoğul kullanımıdır; yani birden fazla sayfanın/URL’nin kart önizlemeleri veya kart türleri (summary, large image gibi) kastedilir.

Büyük görsel kartı her zaman daha mı iyi performans verir?

Her zaman değil. Büyük görsel daha dikkat çekici olabilir; ama görsel zayıfsa veya mesajı taşımıyorsa ters tepebilir. İçeriğe göre Summary Card daha “temiz” ve güven veren bir görünüm sağlayabilir.


Not: X (Twitter) arayüzü ve doğrulama araçları zaman içinde değişebilir. Buradaki yaklaşım, değişmeyen temele dayanır: doğru meta etiket, erişilebilir görsel ve tutarlı URL. Bu temeli oturttuğunuzda, farklı sayfalarda Twitter Cards görünümü daha stabil olur.

Etkisepeti Ekibi

Etkisepeti Ekibi

Etkisepeti ekibi, sosyal medya büyümesi ve dijital pazarlama trendleri hakkında bilgiler paylaşır.

Daha fazla içerik

Daha Fazla İçerik Keşfedin

Sosyal medya stratejileri ve ipuçları hakkında daha fazla yazı okuyun.

Tüm Blog Yazıları