VideoObject şeması kullanımı ve video sonucu çıkma koşulları

Bir sayfaya video gömmek, o videoyu Google için var etmez. Tarayıcıda görünen şey bir oynatıcı çerçevesidir: içindeki dosyanın adı, süresi, ne anlattığı ve ne zaman yayınlandığı sayfanın HTML'inde çoğu zaman hiçbir yerde yazmaz. Google bu boşluğu kendi başına doldurmaya çalışır, ancak elindeki tek ipucu bir iframe adresi olduğunda videoyu tanımlamak yerine sayfayı sıradan bir metin sonucu olarak değerlendirmesi ihtimali yüksektir.

VideoObject bu boşluğu kapatan yapılandırılmış veri türüdür. Videonun başlığını, küçük resmini, süresini ve yayın zamanını makine tarafından okunabilir biçimde bildirir. Ancak işaretlemeyi doğru yazmak, video sonucu almanın yalnızca yarısıdır. Diğer yarısı, çoğu rehberde atlanan bir koşuldur: sayfanın kendisinin ne tür bir sayfa olduğu.

VideoObject şeması Google'a tam olarak neyi söyler

Google, video ayrıntılarını kendi başına anlamaya çalışır. VideoObject bu tahmini yönlendirmenizi sağlar: video sonuçlarında gösterilen açıklama, küçük resim adresi, yükleme tarihi ve süre gibi bilgileri siz belirlersiniz. İşaretleme aynı zamanda videonun bulunmasını da kolaylaştırır.

Videoların görünebileceği yüzeyler tek bir yerle sınırlı değildir. Ana arama sonuçları sayfası, Video modu, Google Görseller ve Keşfet farklı görünüm kanallarıdır. Bunların üstüne, sayfanın nasıl işaretlendiğine bağlı olarak canlı yayın rozeti ve önemli anlar gibi ek özellikler devreye girebilir.

Burada bir sınır çizmek gerekir. Google, işaretleme eklemenin belirli bir video özelliğiyle sonuçlanacağını garanti etmez ve bazı özellikler bazı sorgularda tetiklenmeye uygun olmayabilir. Şema uygunluk üretir, sonuç üretmez.

Zorunlu alanlar sanıldığından az önerilen alanlar sanıldığından belirleyici

Türkçe kaynakların çoğunda VideoObject'in zorunlu alanları dört madde olarak sayılır ve listeye description dahil edilir. Google'ın kendi tanımında zorunlu alan üç tanedir.

• name: Videonun başlığı. Sitedeki her video için benzersiz olmalıdır.
• thumbnailUrl: Videonun benzersiz küçük resim dosyasını gösteren adres. Tekrarlanabilir bir alandır, birden fazla boyut verilebilir.
• uploadDate: Videonun ilk kez yayınlandığı tarih ve saat, ISO 8601 biçiminde. Saat dilimi belirtmezseniz Googlebot'un kullandığı saat dilimi varsayılır.

Geri kalan alanlar önerilen kategorisindedir, fakat "önerilen" burada "isteğe bağlı süs" anlamına gelmez. description, duration, contentUrl, embedUrl, expires ve hasPart alanları, sonucun bilgi yoğunluğunu ve hangi özelliklere uygun olduğunuzu doğrudan belirler. Süre alanı ISO 8601 süre biçiminde yazılır: PT00H30M5S otuz dakika beş saniyelik bir videoyu ifade eder.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Kategori sayfası filtre kurulumu",
  "description": "Filtre parametrelerinin hangi durumda indekslenebilir sayfa üretmesi gerektiğini adım adım gösteren uygulama videosu.",
  "thumbnailUrl": [
    "https://ornek.com/gorsel/filtre-kurulumu-1280x720.webp",
    "https://ornek.com/gorsel/filtre-kurulumu-640x360.webp"
  ],
  "uploadDate": "2026-05-14T09:30:00+03:00",
  "duration": "PT14M22S",
  "contentUrl": "https://ornek.com/video/filtre-kurulumu.mp4",
  "embedUrl": "https://ornek.com/oynatici/filtre-kurulumu",
  "inLanguage": "tr"
}

Bir uyarı: sitedeki her video için name, description ve thumbnailUrl değerlerinin benzersiz olması gerekir. Kurumsal sitelerde en sık görülen hata, tüm video sayfalarına aynı şablon açıklamayı ve aynı marka görselini basmaktır. Bu, işaretlemeyi teknik olarak geçerli fakat ayırt edici gücü sıfır hale getirir.

contentUrl ile embedUrl arasındaki fark uygulamada en çok kaybettiren detay

İkisi de adres alanıdır ve ikisi de sayfanın adresi değildir. Ayrım şudur:

• contentUrl video dosyasının gerçek içerik baytlarını gösterir. Google'ın video dosyanızı getirmesinin en etkili yolu budur ve mümkünse bu alan verilmelidir.
• embedUrl videoyu oynatan oynatıcının adresidir. Genellikle sayfadaki iframe veya embed etiketinin src değeridir.

Her iki alana da videonun yayınlandığı sayfanın adresini yazmak yaygın bir hatadır ve alanı işlevsiz bırakır. contentUrl verilemiyorsa yerine embedUrl sağlanır.

Bu ayrımın pratik sonucu doğrudan özellik uygunluğuna bağlanır. Video önizlemeleri ve önemli anlar gibi özelliklerin çalışabilmesi için Google'ın video dosyasının gerçek baytlarını başarıyla getirebilmesi gerekir. Yani akış dosyası adresini robots.txt veya noindex ile engellemek, video dosyasını değişken adreslerde tutmak ya da sunucunun tarama isteklerini kaldıramaması, şema kusursuz olsa bile özellikleri kapatır.

Küçük resim kuralını geçmeyen şema sessizce başarısız olur

Video özelliklerinde gösterilmeye uygun olmanın ön koşulu videonun bir küçük resminin olmasıdır. Google, video dosyalarınızı getirebiliyorsa küçük resmi kendisi üretmeye çalışır; hangi görselin kullanılacağını belirlemek isterseniz dört kaynaktan biriyle bildirirsiniz: video etiketinin poster özelliği, video site haritasındaki video:thumbnail_loc etiketi, yapılandırılmış verideki thumbnailUrl alanı veya açık grafik protokolündeki og:video:image özelliği. Birden fazlasını kullanıyorsanız hepsinde aynı görsel adresini vermeniz gerekir.

Görselin karşılaması gereken teknik koşullar da net:

• Desteklenen biçimler: BMP, GIF, JPEG, PNG, WebP, SVG ve AVIF.
• Boyut: en az 60x30 piksel, daha büyüğü tercih edilir.
• Erişim: Googlebot ve Googlebot Görüntü dosyaya ulaşabilmeli, dosya robots.txt ile veya giriş şartıyla engellenmemeli ve sabit bir adreste durmalı.
• Şeffaflık: piksellerin en az yüzde 80'inde alfa değeri 250'nin üzerinde olmalı, yani büyük ölçüde opak bir görsel olmalı.

Son madde, tasarım tarafında hazırlanan şeffaf zeminli PNG kapak görsellerinin neden sessizce elendiğini açıklar. Şemada hata görünmez, zengin sonuç yine de gelmez.

Şema doğru olduğu halde video sonucu çıkmıyorsa sorun sayfanın türüdür

Bu bölüm, uygulamada en çok zaman kaybettiren yanlış varsayımı düzeltir. Google video özelliklerini, ana arama sonuçlarındaki video sonuçları ve Video modu dahil olmak üzere, videonun sayfanın asıl varlık nedeni olduğu sayfalara ayırır. Bu sayfalara izleme sayfası denir ve tanımı basittir: kullanıcının o sayfayı ziyaret etmesinin asıl sebebi tek bir videoyu izlemektir.

Google'ın kendi ayrımı şu şekilde:

Sağdaki sütunun ortak özelliği, videonun sayfadaki diğer içeriği tamamlayan bir öğe olmasıdır. Bu sayfalarda VideoObject yazmak yanlış değildir ve boşa da gitmez: izleme sayfası olmayan bir sayfa, metin sonucu olarak ve video rozetli bir Google Görseller sonucu olarak görünmeye uygun olabilir. Ancak beklenti buna göre kurulmalıdır. Ürün sayfalarında tanıtım videosu için VideoObject eklerken hedef, ürün sonucunun yanına video küçük resmi koydurmak değil, videonun varlığını ve içeriğini doğru bildirmektir.

Video, video özellikleriyle görünmesi gereken bir varlıksa çözüm işaretlemeyi zorlamak değil, o videoya kendi izleme sayfasını açmaktır. Aynı videonun hem izleme sayfasında hem de bir haber makalesinde veya ürün sayfasında bulunması sorun değildir. Her izleme sayfasının o videoya özel bir sayfa başlığı ve açıklaması olması gerekir.

Bununla bağlantılı bir kural daha var: sayfanın asıl odağını yansıtan ana yapılandırılmış veri türü mutlaka bulunmalıdır. Ağırlıklı olarak yemek tarifi olan bir sayfaya yalnızca Video işaretlemesi koyarsanız Google'ın elinde o sayfayı tarif zengin sonucu olarak göstermeye yetecek bilgi olmaz. Video şeması, sayfanın ana türünün yerine geçmez, yanına eklenir.

Önemli anlar Clip ve SeekToAction ile nasıl kontrol edilir

Önemli anlar, kullanıcının videoyu kitap bölümleri gibi gezinebilmesini sağlar. Google segmentleri kendiliğinden algılamaya çalışır; siz bildirdiğinizde ise sizin tanımladıklarınıza öncelik verir. Kontrolü ele almanın iki yolu vardır.

• Clip ile her segmentin başlangıç ve bitiş zamanını ve etiketini kendiniz yazarsınız. Zorunlu alanları name, startOffset (saniye cinsinden başlangıç) ve url (videoyla aynı adres yoluna işaret eden ve zaman parametresi taşıyan bağlantı) alanlarıdır, endOffset önerilendir. Google Arama'nın kullanılabildiği tüm dillerde desteklenir.
• SeekToAction ile segmentleri tek tek yazmazsınız, zaman damgalarını adres yapınızın neresine koyduğunuzu bildirirsiniz ve önemli anları Google kendi belirler. Desteklenen diller arasında Türkçe de vardır.

"hasPart": [
  { "@type": "Clip", "name": "Filtre parametresi kararı",
    "startOffset": 45, "endOffset": 180,
    "url": "https://ornek.com/video/filtre-kurulumu?t=45" },
  { "@type": "Clip", "name": "Canonical kontrolü",
    "startOffset": 181, "endOffset": 320,
    "url": "https://ornek.com/video/filtre-kurulumu?t=181" }
]

Segmentleri elle tanımlamak, hangi bölümün hangi başlıkla görüneceğine karar vermek istediğinizde anlamlıdır. Otomatik algılamayı da dahil ederek özelliği tamamen kapatmak isterseniz nosnippet kuralı kullanılır. Video YouTube'da barındırılıyorsa önemli anlar Clip işaretlemesiyle değil, YouTube açıklamasındaki zaman damgalarıyla yönetilir.

Kendi sunucunda barındırmak mı YouTube mu

Bu kararı şema belirlemez, iş modeli belirler. İki seçeneğin gerçek karşılaştırması şöyle:

Dürüst sonuç şu: sitelerin çoğu için YouTube pratik olandır. Video barındırmanın altyapı maliyeti, oynatıcı bakımı ve tarama yükü, videonun ürün olmadığı bir işletmede karşılığını nadiren verir. Üstelik üçüncü taraf oynatıcı gömdüğünüzde Google videoyu hem sizin sayfanızda hem de platformun eşdeğer sayfasında indeksleyebilir ve sayfalar uygunsa iki sürüm de görünebilir. Bu durumda bile kendi izleme sayfanız için yapılandırılmış veri sağlamanız ve bu sayfaları video site haritanıza eklemeniz önerilir.

Kendi barındırma artı VideoObject kurulumu ise dar bir senaryo kümesinde kazanır: videonun kendisinin satılan ürün olduğu eğitim ve kurs siteleri, haber ve spor kliplerini kendi alan adında toplayan yayıncılar, izleme verisini ve oynatıcı davranışını kontrol etmesi gereken platformlar, YouTube'a taşınması ticari olarak sakıncalı içerikler. Bu senaryolarda contentUrl ile gelen özellik uygunluğu ve izleme sayfası mimarisi gerçek bir fark üretir.

Videonun marka görünürlüğündeki payı büyürken

Video artık yalnızca bir sayfa öğesi değil, markanın adının geçtiği bir kaynak katmanı. Ahrefs'in 75.000 markayı incelediği çalışmasında, marka adının video başlığında açıklamasında veya transkriptinde geçmesi ile markanın yapay zeka cevaplarında görünürlüğü arasında 0,737 düzeyinde bir sıra korelasyonu ölçüldü ve bu, çalışmada incelenen sinyaller içindeki en yüksek değerdi. Bu bir korelasyondur, video yayınlamanın yapay zeka görünürlüğüne yol açtığının kanıtı değildir; büyük ve tanınan markaların hem daha çok videoda anılması hem de daha çok cevapta görünmesi aynı sonucu üretebilir.

Pratik çıkarım abartısız olanıdır: video, üretken arama motorlarında görünürlük için tek başına bir kaldıraç değil, metin içeriğin yanında duran ikinci bir anılma yüzeyidir. VideoObject şeması bu tabloda videonun aramada doğru tanımlanmasını sağlar; anılmayı üreten şey videonun kendisi ve içeriğinin niteliğidir.

Yayına almadan önce geçilmesi gereken kontroller

Şema yazıldıktan sonra sırasıyla şunlar doğrulanır:

1. Video sayfada yaygın bir HTML öğesiyle mi duruyor? Google video, embed, iframe ve object öğeleriyle verilen videoları bulabilir.
2. Video yüklemek için kaydırma veya tıklama gibi bir kullanıcı işlemi gerekiyor mu? Gerekiyorsa video bulunamaz.
3. Video JavaScript ile ekleniyorsa oluşturulan HTML'de görünüyor mu? URL Denetleme aracıyla kontrol edilir.
4. Videoyu yüklemek için parça tanımlayıcı kullanılmış mı? Google genellikle parça adreslerini desteklemez.
5. Küçük resim dosyası sabit bir adreste ve tarayıcılara açık mı?
6. Şemadaki bilgiler gerçek video içeriğiyle ve diğer meta verilerle tutarlı mı?
7. İşaretleme sözdizimsel olarak geçerli mi? Zengin sonuç testiyle doğrulama adımında kritik hatalar giderilir, ardından birkaç sayfa yayına alınıp URL Denetleme aracıyla Google'ın sayfayı nasıl gördüğü test edilir.

Bu listenin sırası önemli. Sözdizimi doğrulaması en sona bırakılmalıdır, çünkü hataların çoğu sözdiziminde değil erişilebilirlik ve sayfa türü tarafındadır. Geçerli bir JSON-LD, robots.txt ile engellenmiş bir küçük resmi ya da izleme sayfası olmayan bir sayfayı kurtarmaz.

Sık sorulanlar

VideoObject eklemek videonun kesin olarak video sonucunda çıkacağı anlamına gelir mi

Hayır. İşaretleme uygunluk üretir, garanti üretmez. Google belirli bir video özelliğinin tetikleneceğini taahhüt etmez ve bazı özellikler bazı sorgularda gösterilmeye uygun olmayabilir.

Aynı sayfada birden fazla video varsa ne yapılır

Eşit belirginlikte birden fazla videonun listelendiği bir sayfa izleme sayfası sayılmaz. Videolardan biri gerçekten sayfanın odağıysa yapı buna göre kurulur; hepsi eşit ağırlıktaysa her videoya kendi izleme sayfasını açmak, video özelliklerine uygunluğu sağlayan yoldur.

Video arama sonucunda doğrudan oynatılır mı

Google video dosyasını arama sonuçlarında doğrudan göstermez. Video sonucuna tıklayan kullanıcı videoyu izlemek için sitenize yönlendirilir. Bu nedenle izleme sayfasının hızı ve oynatıcının ilk saniyedeki davranışı, sonucun kendisi kadar belirleyicidir.

Videonun yayından kalkacağı biliniyorsa şemada ne yapılmalı

expires alanı yalnızca videonun gerçekten bir geçerlilik sonu varsa yazılır. Süresi dolmayan bir videoya bu alanı eklemek, içeriğin gereksiz yere kullanım dışı sayılmasına yol açabilir.