Twitter Kartı Doğrulayıcı

Birisi bağlantınızı X (Twitter) üzerinde paylaştığında, platform önizleme kartını oluşturmak için sayfadaki twitter: meta etiketlerini okur: düzenini, başlığını, açıklamasını, görselini ve kaynak bilgisini. Bu etiketler eksikse bağlantı, kartsız düz bir URL olarak paylaşılır. Sayfanızın HTML kodunu aşağıya yapıştırın; bu doğrulayıcı, zorunlu üç etiketin, twitter:card, twitter:title ve twitter:description, mevcut olup olmadığını kontrol eder ve her birinden okuduğu değeri gösterir; böylece yayımlamadan önce bozuk bir önizlemeyi düzeltebilirsiniz.

Kartınızı nasıl doğrularsınız

  1. 1

    Sayfanızın HTML kodunu yapıştırın

    Yalnızca `<head>` bölümünü ya da belgenin tamamını yapıştırabilirsiniz. Doğrulayıcı yalnızca `<meta>` etiketlerini inceler, bu yüzden diğer işaretlemeler yok sayılır.

  2. 2

    Üç zorunlu etiketi arar

    `twitter:card`, `twitter:title` ve `twitter:description`, yani her kart türü için gereken en az etiket. `twitter:image` gibi diğer etiketler burada kontrol edilmez.

  3. 3

    Nelerin bulunduğunu görün

    Eşleşen her etiket, `content` özniteliğinden okunan değeriyle birlikte listelenir; böylece metni bir bakışta gözden geçirebilirsiniz.

  4. 4

    Eksik olanı düzeltin

    Üç etiketten eksik olan her biri, eksik olarak işaretlenir. Onu `<head>` bölümünüze ekleyin ve yeniden kontrol etmek için HTML kodunu tekrar yapıştırın.

X (Twitter) kartının dört türü

Düzen, twitter:card değeriyle belirlenir. Bu doğrulayıcı, girdiğiniz değeri okur; X’in desteklediği dört tür şunlardır:

Kart türü twitter:card değeri Tipik kullanım
Özet summary Makaleler ve standart içerik sayfaları
Büyük görselli özet summary_large_image Öne çıkan görselli blog gönderileri
Oynatıcı player Gömülü ses veya video
Uygulama app Mağaza meta verileriyle uygulama yükleme bağlantıları

Zorunlu ve önerilen etiketler

Bu araç yalnızca ilk grubu, yani X’in her kart için ihtiyaç duyduğu üç etiketi kontrol eder.

Zorunlu (burada kontrol edilir):

  • twitter:card, kullanılacak düzen
  • twitter:title, başlık (X yaklaşık ilk 70 karakteri gösterir)
  • twitter:description, özet (X yaklaşık ilk 200 karakteri gösterir)

Önerilen (burada kontrol edilmez, ama eklemeniz iyi olur):

  • twitter:image, bir PNG, JPG veya GIF dosyasına giden mutlak https:// URL’si; özet kartı için en az 300 x 157 px, summary_large_image için 800 x 418 px
  • twitter:site, markanızın @handle bilgisi
  • twitter:creator, yazarın @handle bilgisi
  • twitter:image:alt, erişilebilirlik için alternatif metin

Sık yapılan hatalar

  • Yalnızca Open Graph etiketleri. X, og:title, og:description ve og:image etiketlerine geri döner, böylece bağlantı yine de açılır, ancak twitter:card olmadan düzen varsayılan olarak küçük bir özet olur. Yapabildiğinizde iki seti de ekleyin.
  • Görsel çok küçük. 300 x 157 px altında kart yalnızca metne düşebilir.
  • Göreli görsel URL’si. twitter:image mutlak olmalıdır (https://...); göreli bir yol yok sayılır.
  • name= yerine property=. X ve bu doğrulayıcı, Twitter etiketlerini name="twitter:..." üzerinden okur. property="twitter:..." yazmak Open Graph için çalışır ama bunlar için çalışmaz.
  • Açıklama çok uzun. Yaklaşık 200 karakterden sonra X onu keser, genellikle bir kelimenin ortasından.

Gerçek kartı nasıl önizlersiniz

X, resmi Card Validator aracını (cards-dev.twitter.com/validator) 2023’te kapattı, bu yüzden artık canlı önizleme sunan resmi bir sayfa yok. Bu araç, zorunlu etiketlerin mevcut ve okunabilir olduğunu doğrular; gerçek kartı görmek için bağlantıyı bir gönderi taslağında ya da kendinize gönderdiğiniz bir doğrudan mesajda paylaşın veya üçüncü taraf bir bağlantı önizleme aracı kullanın. Etiketleri düzelttikten sonra X hâlâ eski bir görsel gösteriyorsa, önbelleği aşmak için görsel URL’sine ?v=2 gibi bir sorgu dizesi ekleyin.

Sık Sorulan Sorular

Hayır. Yapıştırdığınız HTML kodunu okur ve zorunlu üç twitter: etiketinin mevcut olduğunu doğrular, her birinin değerini gösterir. Kartı çizmez ve canlı sayfanızı getirmez. X, kendi Card Validator aracını 2023’te kapattı; bu yüzden gerçek kartı görmenin güvenilir yolu, bağlantıyı bir gönderi taslağında ya da kendinize gönderdiğiniz bir doğrudan mesajda paylaşmaktır.

X, og:title, og:description ve og:image etiketlerine geri döner, böylece bağlantı yine de açılır, ancak twitter:card olmadan düzen varsayılan olarak küçük bir özet olur. Büyük görselli bir kart için twitter:card değerini açıkça summary_large_image olarak ayarlamanız gerekir. Bu doğrulayıcının yalnızca twitter: etiketlerini kontrol ettiğini, og: etiketlerinizi kontrol etmediğini unutmayın.

İsimden sonra yazılmış content özniteliğiyle birlikte name="twitter:..." arar; tek veya çift tırnak fark etmez. Etiketiniz name= yerine property="twitter:..." kullanıyorsa ya da content özniteliğini name özniteliğinden önce koyuyorsa, HTML geçerli olsa bile desen eşleşmez. Sıralamayı name="..." content="..." biçimine getirin ve tekrar kontrol edin.

Bu doğrulayıcı adı büyük/küçük harften bağımsız olarak tanır; bu yüzden twitter:Card da burada algılanır. Yine de küçük harfle yazın (twitter:card), çünkü X’in belgelediği ve beklediği biçim budur.

Kısaca: evet. Kontrol sunucumuzda çalışır, bu yüzden yapıştırdığınız HTML oraya gönderilir, taranır ve silinir. Yalnızca aracın kullanıldığına dair anonim bir kayıt tutarız, asla kodunuzu tutmayız ve bu, tarayıcıda çalışan çevrimdışı bir araç değildir.

İlgili Araçlar

Araç diğer dillerde mevcuttur