Video içerikleri SEO’ya entegre etme: VideoObject schema

Video içeriklerini SEO’ya entegre etmeden önce yayın modelini seçin

Video SEO’da ilk karar, videonun sayfadaki rolüdür. Google Search Central’ın Video SEO best practices dokümanı 18 Aralık 2025 güncellemesinde, video özelliklerine uygunluk için dedicated watch page modelini açık biçimde öne çıkarıyor. Bunun nedeni basit: Sayfanın ana amacı tek bir videoyu izletmek olduğunda Google, videonun birincil içerik olduğunu daha net anlıyor. Buna karşılık blog yazısı içine gömülü bir video, ürün sayfasındaki tanıtım videosu veya çoklu video listeleme ekranı çoğu zaman destekleyici içerik sayılıyor.

Pratikte üç ana senaryo var. Birincisi, videonun ana içerik olduğu bir watch page. Bu model; haber videosu, ürün demosu, eğitim kaydı veya vaka anlatımı gibi tek videoya odaklı sayfalarda en temiz sinyali verir. İkincisi, blog içine gömülü video modelidir; burada video yazıyı güçlendirir ama sayfanın ana konusu metindir. Üçüncüsü, yalnızca YouTube ya da Vimeo embed kullanılan senaryodur. Bu model hızlı yayına almayı kolaylaştırır; ancak video dosyasına doğrudan erişim yoksa bazı gelişmiş video özellikleri için sinyal derinliği sınırlı kalabilir.

• Dedicated watch page: Tek videonun arama görünürlüğünü büyütmek istediğinizde seçin.
• Blog içine gömülü video: Yazı ana içerikse ve video açıklayıcı rol üstleniyorsa yeterlidir.
• Yalnızca üçüncü taraf embed: Dağıtım kolaydır; fakat oyuncu ve dosya erişimi tarafını ayrıca kontrol etmek gerekir.

contentUrl ile embedUrl farkı burada kritikleşir. Google’ın aynı dokümana göre embedUrl, oynatıcının URL’sini; contentUrl ise gerçek video dosyasının URL’sini temsil eder. Self-hosted veya CDN üzerinden servis edilen MP4 ya da M3U8 dosyalarında contentUrl vermek mümkündür. YouTube ve çoğu Vimeo senaryosunda genelde embedUrl öne çıkar. Resmi dokümanların birlikte okunmasından çıkan pratik sonuç şudur: Google video dosyasının baytlarına erişebiliyorsa, önizleme ve key moments gibi özellikler için daha zengin bir sinyal alanı oluşur. Bu yüzden self-hosted kurulumlarda contentUrl’yi atlamak doğru değildir.

Yalnızca YouTube embed kullanıyorsanız bu kurulum tamamen değersiz değildir. Google, aynı best practices sayfasında bir videonun hem watch page üzerinde hem de başka bir sayfada yer alabileceğini; watch page olmayan sayfanın yine metin sonucu veya video rozetli görsel sonucu olarak görünebileceğini söylüyor. Ancak hedefiniz video sekmesinde daha güçlü görünürlükse, tek videoya adanmış bir sayfa modeli daha güvenilir bir temel oluşturur.

VideoObject schema kurulumu: zorunlu alanlar, JSON-LD ve key moments

Google Search Central’ın Video structured data dokümanı 13 Şubat 2026 güncellemesinde, VideoObject için başlangıç seviyesindeki en kritik çekirdeği koruyor: name, thumbnailUrl ve uploadDate. Bunlar olmadan Google videodan anlamlı bilgi çıkaramayabilir. Kaliteli bir kurulumda description, duration, contentUrl ve embedUrl de eklenir. Buradaki amaç yalnızca rich result uygunluğu değildir; Google’a hangi videodan söz ettiğinizi, bu videonun nerede oynadığını ve hangi dosyaya işaret ettiğini tutarlı biçimde anlatmaktır.

Örnek JSON-LD iskeleti nasıl düşünülmeli?

JSON-LD’yi ham kod ezberiyle değil, alanların göreviyle kurmak daha güvenlidir. En sade iskelet; "@context": "https://schema.org", "@type": "VideoObject", ardından name, description, thumbnailUrl ve uploadDate alanlarından oluşur. Videonun gerçek dosyasına erişim varsa contentUrl; yalnızca oynatıcıya erişim varsa embedUrl eklenir. Süreyi ISO 8601 biçiminde yazmak gerekir; örneğin 5 dakika 12 saniye için PT5M12S. Bu yapı, WordPress’te ister tema alanına ister eklentiye ister manuel head-body yerleşimine eklensin, aynı mantıkla çalışır.

1. name: Sayfadaki video başlığıyla uyumlu, tek videoyu tarif eden net başlık olmalı.
2. thumbnailUrl: Kırık olmayan, sabit kalan ve Googlebot’un erişebildiği küçük görsel URL’si kullanılmalı.
3. uploadDate: Videonun gerçek yayın tarihi yazılmalı; içerik güncelleme tarihiyle karıştırılmamalı.
4. description: Her video için benzersiz açıklama girilmeli; kopya açıklamalar kaliteyi düşürür.
5. duration: ISO 8601 formatında yazılmalı; saniye ve dakika düzeyi doğru olmalı.
6. contentUrl: Gerçek video dosyası erişilebiliyorsa eklenmeli; özellikle self-hosted ve CDN kurulumlarında önemlidir.
7. embedUrl: iFrame ya da özel oynatıcı URL’si kullanılıyorsa eklenmeli; YouTube ve Vimeo senaryolarında çoğu zaman ana alan budur.

Gelişmiş işaretlemelerde hata payı daha büyüktür. Clip, key moments zaman damgalarını sizin tanımladığınız senaryolarda mantıklıdır; bölümleriniz netse ve her başlangıç zamanı benzersizse kullanın. SeekToAction, URL parametresiyle belirli saniyeye gitmeyi destekleyen oynatıcılarda uygundur. Google’ın kendi dokümanında da belirtildiği gibi, zaman segmentlerini siz kontrol etmek istiyorsanız Clip, otomatik atlama yapısı sunuyorsanız SeekToAction tercih edilir. BroadcastEvent ise LIVE badge için gerekir; canlı olmayan videoya eklemek yanlış sinyal üretir. Kısacası gelişmiş alanları sadece gerçekten desteklediğiniz oynatıcı mantığında kullanın.

Video sitemap, transkript ve sayfa içi sinyalleri birlikte güçlendirin

Structured data tek başına yeterli olabilir; ancak keşif tarafını güçlendirmek için video sitemap veya mRSS çoğu projede ikinci katman görevi görür. Google Search Central’ın Video sitemaps and examples dokümanı 20 Mayıs 2026 güncellemesinde, video sitemap ve mRSS akışlarını hâlâ geçerli keşif kanalı olarak konumluyor. Özellikle büyük içerik arşivlerinde, çok sayıda video landing page olduğunda veya JavaScript ağırlıklı sayfalarda sitemap ek sinyal sağlar. Eğer aynı video hem structured data hem sitemap ile anlatılıyorsa, başlık, thumbnail ve video URL bilgisinin tutarlı kalması gerekir.

Video SEO’da transkript ve çevreleyen metin beklenenden daha büyük rol oynar. Arama motoru videonun kendisini görse bile, sayfadaki metin videonun sorgu bağlamını netleştirir. Bu nedenle sayfada yalnızca oynatıcı bırakmak yerine kısa özet, bölüm başlıkları, ana çıkarımlar ve mümkünse tam veya özet transkript sunmak faydalıdır. Altyazı dosyaları kullanıcı deneyimini güçlendirirken, transkript metni de long-tail sorgular için ek bağlam kazandırır. Özellikle eğitim, ürün demosu ve vaka videolarında bu kombinasyon organik görünürlükte fark yaratır.

• Stabil thumbnail URL: Aynı video için sık değişmeyen, erişilebilir küçük görsel kullanın.
• Erişilebilir oynatıcı: Login duvarı, tıklama sonrası yükleme veya kırık iFrame akışı bırakmayın.
• Birincil video yerleşimi: Ana video sayfanın üst bölümünde ve görünür alanda olsun.
• Çevreleyen metin: Başlık, açıklama, özet ve transkript videonun arama bağlamını pekiştirir.

Open Graph etiketleri de yardımcı sinyal üretir; fakat bunları structured data ile çelişecek biçimde kullanmayın. Search Console Help, aynı video için farklı metadata kaynaklarında farklı thumbnail veya başlık vermenin hata ve karışıklık üretebildiğini açıkça gösteriyor. Lazy-load tarafında da sınır net: Video oynatıcısı, kullanıcı tıklamadan önce rendered HTML içinde görünmeli. Search Console Help’teki "Cannot determine video position and size" açıklaması, oyuncu yerine ekran görüntüsü koyup tıklama sonrası yükleme yapan düzenlerin indeksleme riski taşıdığını söylüyor. Bu yüzden ilk yüklemede gerçek oynatıcıyı göstermek daha güvenlidir.

Ekip içi referans için, Google Search Central’ın resmi video anlatımlarını izlemek iyi bir tamamlayıcı kaynak olabilir; fakat teknik kararları yine resmi dokümana göre vermek gerekir. Özellikle thumbnail URL, player URL ve video file URL ayrımını ürün, içerik ve geliştirme ekiplerinin aynı terimlerle kullanması, sonradan çıkacak indeksleme hatalarını azaltır.

Rich Results Test ve Search Console ile video hatalarını giderin

Yayın akışının teknik doğrulaması dört adımda ilerlemeli. İlk adımda Rich Results Test ile VideoObject alanlarının parse edilip edilmediğini kontrol edin. İkinci adımda URL Inspection üzerinden canlı sayfayı test edin ve rendered HTML içinde videonun gerçekten görünüp görünmediğine bakın. Üçüncü adımda sayfayı yeniden tarama isteğine uygun hâle getirin. Dördüncü adımda Search Console Video Indexing Report üzerinden sayfa bazlı hataları takip edin. Bu sıralama önemlidir; çünkü schema doğru olsa bile oynatıcı görünmüyorsa ya da thumbnail erişilemiyorsa indeksleme yine aksar.

Search Console Help’e göre video indeksleme raporu en sık şu nedenleri gösterir: video watch page üzerinde değildir, thumbnail URL sağlanmamıştır, video konumu ve boyutu belirlenememektedir, video henüz işlenmemiştir veya eksik video URL yüzünden Google videoyu ayırt edememektedir. Aynı yardım sayfası, Google’ın sayfa başına yalnızca bir videoyu indekslediğini de vurgular. Bu nedenle çok videolu sayfalarda hangi videonun birincil olduğunu siz netleştirmezseniz, Google sizin beklediğiniz videoyu seçmeyebilir.

• No thumbnail URL provided: Structured data, sitemap veya mRSS içinde erişilebilir thumbnail ekleyin.
• Video isn’t on a watch page: Tek videoya odaklı sayfa oluşturun ya da videonun sayfadaki rolünü yeniden düzenleyin.
• Cannot determine video position and size: Tıklama sonrası yüklenen sahte kapak yerine gerçek oynatıcıyı ilk yüklemede gösterin.
• Missing video URL: contentUrl veya embedUrl alanlarından en az biriyle oynatıcı ya da dosya URL’sini net verin.

WordPress tarafında üç pratik seçenek vardır. Az sayıda videolu, teknik kontrol ihtiyacı yüksek projelerde manuel JSON-LD en temiz çözümdür; her alanı siz yönetirsiniz. Editörün teknik müdahaleyi azaltmak istediği sitelerde tema alanı veya özel alan mantığı daha sürdürülebilir olabilir. Yüksek içerik hacminde ise eklenti tabanlı yönetim zaman kazandırır; ancak alanların otomatik yanlış dolmadığından emin olmak gerekir. Özellikle embedUrl ve contentUrl karışıklığı yaşayan kurulumlarda eklenti çıktılarını mutlaka test edin.

Doğrulama sonrası hata çözümünü bekleme modunda bırakmayın. Aynı URL’de schema düzeltildi, thumbnail sabitlendi ve oyuncu görünür hâle getirildiğinde yeniden inceleme isteyip birkaç gün sonra raporu tekrar kontrol etmek gerekir. Video SEO’nun önemli kısmı kurulum kadar bakım işidir; en iyi sonuç, doğru şema ile düzenli hata temizliğinin birlikte yürütüldüğü projelerde gelir.

Adım Adım: Video içeriklerini SEO’ya VideoObject schema ile entegre etme

Aşağıdaki akış, teknik ekiple içerik ekibinin aynı check-list üzerinden ilerlemesini sağlar. Amaç sadece schema eklemek değil; sayfa modeli, medya erişimi, metadata tutarlılığı ve yayın sonrası izlemeyi tek süreçte birleştirmektir.

1. Yayın modelini ve hedef sayfayı seçin: Videonun dedicated watch page mi, blog içi embed mi, üçüncü taraf oynatıcı mı olacağına içerik amacıyla birlikte karar verin.
2. Birincil video sinyallerini hazırlayın: Başlık, açıklama, thumbnail, yayın tarihi, oynatıcı ya da dosya URL’si ve transkripti tamamlayın.
3. VideoObject JSON-LD kodunu ekleyin: Önce name, thumbnailUrl ve uploadDate alanlarını girin; sonra duration, description, contentUrl veya embedUrl ekleyin.
4. Sitemap ve sayfa içi metni tamamlayın: Gerekliyse video sitemap ekleyin; başlık, özet, altyazı ve transkriptle videonun bağlamını güçlendirin.
5. Test edin ve indekslemeyi izleyin: Rich Results Test, URL Inspection ve Video Indexing Report akışıyla doğrulama yapın.

Bu iş akışında kritik nokta, tüm sinyallerin aynı videoyu anlattığından emin olmaktır. Sayfadaki başlık başka, structured data başlığı başka, sitemap thumbnail’i başka olduğunda Google metadata’yı birleştirmeye çalışır ve kalite düşer. Yayına aldıktan sonra birkaç hafta boyunca watch page, thumbnail erişimi ve indeksleme durumunu kontrollü biçimde izlemek gerekir.

30 günlük mini test: kurulum farkını SEOYEN ile nasıl izlersiniz?

En yararlı mini test, aynı videoyu üç senaryoda izlemektir: blog yazısına gömülü video, dedicated watch page ve YouTube embed artı VideoObject kurulumlu sayfa. 30 ile 45 günlük pencere, özellikle indeksleme ve görünürlük tarafında ilk sinyalleri okumak için yeterlidir. Uygulama projelerinde en hızlı ayrışan fark çoğu zaman sıralama değil, önce rendered HTML içinde videonun görünmesi, thumbnail erişimi ve Search Console’un videoyu aday olarak algılaması oluyor. Bu yüzden testin ilk haftasında teknik doğrulama metrikleri, sonrasında görünürlük metrikleri izlenmelidir.

İzleme setinde dört ana ölçüm kullanın: CTR, rich result uygunluğu, indekslenme durumu ve sorgu görünürlüğü. Teknik tarafta site sağlığı kontrolü ile kırık medya URL’leri, erişim sorunları ve sayfa bazlı teknik bozulmaları tarayabilirsiniz. Sorgu performansında sıralama takibi raporu, video odaklı sorguların watch page lehine ayrışıp ayrışmadığını görmeyi kolaylaştırır. Yeni nesil görünürlük tarafında AI görünürlük analizi, içeriğin sadece klasik organik sonuçlarda değil, yapay zekâ destekli özetlerde ne kadar görünür sinyal ürettiğini takip etmek için mantıklı bir ek katmandır.

• 1. gün: Rich Results Test, URL Inspection ve thumbnail erişimi kontrol edilir.
• 7. gün: Video Indexing Report’ta algılama ve hata durumları karşılaştırılır.
• 14. gün: Watch page ile embed sayfası arasındaki görünürlük farkı okunur.
• 30. gün: CTR, indekslenme oranı ve sorgu kapsamı birlikte değerlendirilir.

Bu noktada SEOYEN’in avantajı fiyat söyleminden çok iş akışındadır. Ahrefs, SEMrush, Moz, SE Ranking ve SEOptimer kendi alanlarında veri sunar; ancak Türkiye pazarında teknik ekip ile içerik ekibinin aynı panelde, Türkçe arayüzle ve yerel destekle ilerlemesi çoğu zaman daha hızlı karar üretir. SEOYEN’in tek platformda tüm SEO araçları yaklaşımı, video kurulum testi gibi çok adımlı operasyonlarda parçalı raporlama yükünü azaltır. Ayrıca ekipler güncel fiyat ve paketler yapısını tek sayfadan görebildiği için araç seçimi tarafı da operasyonu yavaşlatmaz.

Soft bir kapanış önerisi olarak şunu not etmek yeterli: Video SEO kurulumu doğruysa fark birkaç alanda aynı anda görünür olur; yanlışsa da sorun genelde thumbnail, watch page mantığı veya eksik metadata tarafında kendini çabuk belli eder. Bu nedenle 30 günlük mini test, sadece schema’nın varlığını değil, kurulum kalitesini ölçmek için en pratik yöntemlerden biridir.

Sıkça Sorulan Sorular