VideoObject'ta SeekToAction nasıl kurulur?

VideoObject'ta SeekToAction, videonun saniye parametresiyle açılan URL'sini JSON-LD içine tanımlayarak kurulur. Bunun için VideoObject şemasına potentialAction eklenir ve hedef URL'de {seek_to_second_number} değişkeni kullanılır.

Google bu işaretlemeyi, videodaki önemli anları arama sonuçlarında otomatik göstermek için kullanabilir. Gösterim garanti edilmez. Video sayfasının taranabilir, videonun oynatılabilir ve yapılandırılmış verinin içerikle uyumlu olması gerekir.

Bu konu, ürün tanıtımı, fabrika turu, otel sunumu ve kurumsal video üreten markalar için iki süreci birleştirir. Prodüksiyon sırasında bölümlerin zaman kodlarını kaydetmek, sonradan SEO uygulamasını kolaylaştırır.

VideoObject'ta SeekToAction ne işe yarar?

SeekToAction, kullanıcının arama sonucundan videonun belirli bir saniyesine gitmesini sağlayan yapılandırılmış veri eylemidir.

Örneğin bir fabrika videosunda üretim hattı 42. saniyede başlıyorsa, Google bu bölümü ilgili arama görünümünde öne çıkarabilir. Kullanıcı videoyu baştan izlemek yerine doğrudan o bölüme ulaşabilir.

Bu işaretleme videoya bölüm başlıklarını sizin elle eklemenizi zorunlu kılmaz. Google, video içeriğini ve sayfadaki sinyalleri değerlendirerek önemli anları kendisi belirleyebilir. Bu nedenle yalnızca şema eklemek yeterli değildir.

Video, sayfada kullanıcı tarafından izlenebilir olmalıdır. Yalnızca sosyal medya platformunda bulunan veya erişim kısıtlaması olan bir video, sayfadaki VideoObject için uygun olmayabilir.

SeekToAction, klasik video bölümleriyle aynı işlevi de görmez. Manuel bölümlerde başlıkları ve başlangıç saniyelerini siz belirlersiniz. SeekToAction ise saniye tabanlı URL kalıbını Google'a bildirir.

Video arama sonuçlarında görünmek için VideoObject verisinin ilgili video sayfasına yerleştirilmesi gerekir. Şema, videonun bulunmadığı bir iletişim veya kategori sayfasına eklenmemelidir.

Google'ın desteklediği diller arasında Türkçe de bulunur. Ancak Türkçe desteği, her videoda otomatik önemli an gösterileceği anlamına gelmez. İçeriğin açıklığı, sayfa kalitesi ve teknik erişilebilirlik yine önemlidir.

Ürün videolarında model tanıtımı, kullanım adımı veya teknik özellik bölümü öne çıkabilir. Otel videolarında lobi, oda, toplantı salonu ve restoran gibi bölümler ayrışabilir.

SeekToAction kurmak için hangi VideoObject alanları gerekir?

SeekToAction için önce geçerli bir VideoObject oluşturmalı, ardından bu nesneye SeekToAction tipinde bir potentialAction eklemelisiniz.

VideoObject içinde en azından videonun adı, küçük görseli ve yüklenme tarihi gibi temel bilgiler bulunmalıdır. Video dosyasına erişim için contentUrl veya gömülü oynatıcı için embedUrl kullanılabilir.

name, videonun sayfadaki gerçek başlığıyla uyumlu olmalıdır. Sayfada “İzmir Fabrika Tanıtım Filmi” yazıyorsa, şemada tamamen farklı bir başlık kullanmak doğru değildir.

thumbnailUrl, video içeriğini temsil eden erişilebilir bir görsel URL'sidir. Küçük görselin engellenmemesi, HTTPS üzerinden açılması ve sayfayla ilişkili olması gerekir.

uploadDate, videonun yayınlanma veya yüklenme tarihini ISO 8601 biçiminde göstermelidir. Bilinmeyen tarihi tahmin ederek yazmayın. Tarih kayıt sisteminde yoksa, önce içerik yönetimindeki gerçek tarihi bulun.

duration alanı kullanılıyorsa ISO 8601 süre biçiminde yazılmalıdır. Örneğin 2 dakika 30 saniye için PT2M30S kullanılır. Bu değer, oynatıcıdaki gerçek süreyle örtüşmelidir.

potentialAction içinde @type değeri SeekToAction olmalıdır. target, saniye değişkenini kabul eden video URL kalıbını tanımlar.

startOffset-input alanı, saniye değişkeninin nasıl gönderileceğini belirtir. Google örneğinde bu değer required name=seek_to_second_number biçiminde kullanılır.

Video URL'si her saniye için gerçekten çalışmalıdır. Örneğin URL'ye ?t=42 eklendiğinde video 42. saniyeye geçmiyorsa, şema teknik olarak yazılmış olsa bile işlevsel değildir.

Video sayfası farklı bir alan adına yönleniyorsa, yönlendirme ve oynatıcı davranışını ayrıca test edin. Şemadaki URL ile kullanıcının açtığı URL aynı deneyimi vermelidir.

SeekToAction JSON-LD kodu nasıl yazılır?

SeekToAction için aşağıdaki JSON-LD yapısı, saniye parametresi alan bir video URL'sini VideoObject içine bağlar.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "İzmir Fabrika Tanıtım Filmi",
  "description": "Üretim hattını, kalite kontrol sürecini ve tesis özelliklerini anlatan video.",
  "thumbnailUrl": [
    "https://www.ornekalanadi.com/gorsel/fabrika-video-kapak.jpg"
  ],
  "uploadDate": "2026-01-15T10:00:00+03:00",
  "duration": "PT2M30S",
  "contentUrl": "https://www.ornekalanadi.com/videolar/fabrika-tanitim.mp4",
  "potentialAction": {
    "@type": "SeekToAction",
    "target": "https://www.ornekalanadi.com/fabrika-tanitimi?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
}
</script>

Buradaki target değeri, videonun bulunduğu sayfanın URL'sidir. Sorgu parametresi olarak t kullanılmıştır. Sitenizdeki video oynatıcı farklı bir parametre gerektiriyorsa, gerçek davranışa uygun bir kalıp yazmalısınız.

Örneğin oynatıcı saniyeyi start parametresiyle alıyorsa hedef URL şöyle olabilir: https://www.ornekalanadi.com/video?start={seek_to_second_number}.

Buradaki değişken adını keyfi biçimde değiştirmeyin. Google dokümantasyonundaki {seek_to_second_number} yer tutucusunu kullanmak, işaretlemenin beklenen biçime uygun kalmasını sağlar.

Birden fazla VideoObject bulunan sayfalarda her videonun adı, küçük görseli, URL'si ve eylem hedefi ayrı olmalıdır. Aynı URL'yi farklı videolar için kopyalamak veri tutarsızlığı oluşturur.

JSON-LD kodunu sayfanın <head> bölümüne veya gövde HTML'sine yerleştirebilirsiniz. Ancak bu makaledeki gövde HTML'siyle karıştırmayın; uygulama kodu sitenin kaynak yapısına eklenmelidir.

İçerik yönetim sistemi otomatik şema üretiyorsa, elle eklenen ikinci VideoObject kaydını kontrol edin. Aynı sayfada çakışan veya eksik iki kayıt, teşhis sürecini zorlaştırır.

SeekToAction kurulumu hangi adımlarla yapılır?

SeekToAction kurulumu, video verisini toplama, URL kalıbını doğrulama, JSON-LD ekleme ve Google araçlarıyla test etme adımlarından oluşur.

1. Video sayfasının kesin URL'sini belirleyin.
2. Video başlığını, açıklamasını, gerçek süresini ve küçük görselini kaydedin.
3. Oynatıcının saniye parametresini belirleyin.
4. URL'ye örnek bir saniye değeri ekleyerek doğrudan açılmayı test edin.
5. VideoObject içine potentialAction nesnesini ekleyin.
6. Kaynak kodunda JSON-LD'nin geçerli biçimde çıktığını kontrol edin.
7. Rich Results Test ile yapılandırılmış veriyi doğrulayın.
8. Yayın sonrası Search Console'da video görünürlüğünü izleyin.

İlk adımda video sayfasıyla video dosyasını ayırın. contentUrl dosyayı, target ise kullanıcının videoyu izlediği sayfayı temsil edebilir.

İkinci adımda prodüksiyon ekibinden zaman kodlarını isteyin. Zaman kodları, SeekToAction için zorunlu bir liste değildir. Fakat videodaki bölümlerin anlaşılmasını ve URL testlerinin yapılmasını kolaylaştırır.

Üçüncü adımda oynatıcı teknolojisini inceleyin. HTML5 video, YouTube gömmesi veya özel JavaScript oynatıcısı saniye parametresini farklı yorumlayabilir.

Örneğin ?t=42 URL'si sayfayı açıyor fakat oynatıcı 0. saniyede kalıyorsa, yalnızca URL'nin açılması yeterli değildir. Video gerçekten 42. saniyeye geçmelidir.

Yayın sonrası değişiklikleri de izleyin. Video URL'si, sayfa adresi veya oynatıcı parametresi değişirse, eski SeekToAction hedefi geçersiz kalabilir.

Video sayfasını yeniden tasarlarken şemayı taşıma planına dahil edin. Şemayı sonradan eklemek, yeni URL'nin arama motoru tarafından yeniden taranmasını bekletir.

Türkçe videolarda önemli anlar nasıl daha anlaşılır hale getirilir?

Türkçe videolarda önemli anların anlaşılması için konuşma, ekrandaki metin ve sayfa açıklaması aynı konu sırasını izlemelidir.

Google Türkçe içeriklerde SeekToAction desteği sunar. Buna rağmen otomatik bölüm tespiti, videonun ses kalitesi ve konu geçişlerinin netliği gibi sinyallerden etkilenebilir.

Örneğin ürün videosunda önce dış tasarım, sonra teknik özellikler, ardından kullanım gösteriliyorsa, bu sıra videonun seslendirmesinde de açıkça duyulmalıdır.

“Şimdi ikinci bölüme geçiyoruz” gibi belirsiz ifadeler, tek başına yeterli açıklama sağlamaz. “Cihazın enerji tüketimini şimdi inceliyoruz” gibi konu belirten cümleler daha anlaşılırdır.

Video başlığı ve açıklaması da Türkçe arama niyetine uygun olmalıdır. Ancak anahtar kelimeleri art arda dizmek yerine, videonun gerçekten anlattığı konuları yazın.

Otel videosunda “odalar, toplantı salonu ve kahvaltı alanı” açıkça geçebilir. Fabrika videosunda “hammadde kabulü, üretim hattı ve kalite kontrol” gibi gerçek süreçler belirtilmelidir.

Altyazı kullanıyorsanız Türkçe karakterlerin doğru işlendiğini kontrol edin. Eksik altyazı veya bozuk karakterler, kullanıcı deneyimini ve içeriğin anlaşılmasını olumsuz etkileyebilir.

Video prodüksiyonunda her bölümün başlangıç saniyesini çekim planına yazmak pratik bir yöntemdir. Kurgu tamamlandığında bu liste, sayfa açıklamasını ve teknik testi destekler.

Ancak zaman kodlarını uydurmayın. Kurgu sonrasında reklam girişleri, logo animasyonları veya kesmeler videonun başlangıçlarını değiştirebilir.

Bu nedenle son dosyanın gerçek süresini kullanın. Taslak kurguya göre yazılmış süre ve URL'ler, yayınlanan videoyla eşleşmeyebilir.

SeekToAction ile manuel video bölümleri arasındaki fark nedir?

SeekToAction, saniye parametreli URL kalıbını bildirir; manuel video bölümleri ise bölüm adlarını ve başlangıç zamanlarını doğrudan tanımlar.

SeekToAction, oynatıcınız saniye parametresini destekliyorsa pratik bir çözümdür. Kullanıcıyı doğrudan video içeriğinin ilgili kısmına göndermek, uzun tanıtım filmlerinde özellikle işe yarar.

Manuel bölümler, içerik sahibinin bölüm başlıklarını belirlemek istediği durumlarda daha uygundur. Örneğin bir eğitim videosunda “Kurulum”, “Bakım” ve “Sık yapılan hatalar” başlıklarını açıkça tanımlayabilirsiniz.

İki yaklaşımın teknik gereksinimleri birbirinin yerine geçmez. SeekToAction eklemek, manuel bölüm işaretlemesi yapıldığı anlamına gelmez. Manuel bölümler eklemek de saniye parametreli hedef URL oluşturmaz.

Yanlış: Video sayfasına yalnızca YouTube URL'si ekleyip SeekToAction'ın otomatik çalışacağını varsaymak. Doğru: Oynatıcının saniye parametresini test edip, çalışan sayfa URL'sini target alanına yazmak.

Video kısa ve tek konuluysa iki yöntemin de arama görünümüne katkısı sınırlı olabilir. Google, her video için önemli an veya zengin görünüm göstereceğini garanti etmez.

Uzun ürün tanıtımları, fabrika turları ve otel videoları ise bölümlere ayrılmaya daha uygundur. Çünkü kullanıcıların videonun tamamı yerine belirli bir özelliği arama ihtimali yüksektir.

SeekToAction kodu nasıl test edilir?

SeekToAction kodu, önce yapılandırılmış veri doğrulama aracıyla, sonra gerçek URL ve oynatıcı davranışıyla test edilmelidir.

Google Rich Results Test, sayfanın yapılandırılmış veri açısından okunup okunmadığını kontrol etmek için kullanılabilir. Testte VideoObject'ın algılanıp algılanmadığını ve kritik alanlarda hata bulunup bulunmadığını inceleyin.

Aracın hata vermemesi, arama sonucunda önemli anların kesinlikle gösterileceği anlamına gelmez. Bu araç kod biçimini değerlendirir; arama görünürlüğü ayrıca içerik ve teknik koşullara bağlıdır.

İkinci test, hedef URL'yi tarayıcıda açmaktır. ?t=42 veya sitenizde kullanılan gerçek parametreyle sayfayı açın. Video oynatıcı 42. saniyeye geçmiyorsa uygulamayı tamamlanmış saymayın.

Üçüncü test, farklı cihazlarda yapılmalıdır. Masaüstü ve mobil oynatıcılar aynı parametreyi farklı yorumlayabilir. Mobilde otomatik oynatma kısıtları olsa bile video sayfası açılmalıdır.

Kaynak kodunu da inceleyin. JSON-LD, tarayıcıda doğru çıktılanmalı ve JavaScript hatası nedeniyle yarım kalmamalıdır. İçerik yönetim sistemi bazı karakterleri dönüştürüyorsa, ham kaynakta kontrol yapın.

Aşağıdaki listeyi yayın öncesi kontrol için kullanabilirsiniz:

• Video sayfası herkese açık ve taranabilir mi?
• Video gerçekten sayfada oynatılabiliyor mu?
• target URL'si saniye parametresini kabul ediyor mu?
• Örnek saniye değeri videoyu doğru noktada açıyor mu?
• name, thumbnailUrl ve uploadDate gerçek veriler mi?
• duration oynatıcı süresiyle eşleşiyor mu?
• JSON-LD içinde yazım veya virgül hatası var mı?
• Sayfada aynı videoya ait çakışan şema bulunuyor mu?

Yayın sonrası Search Console raporlarını izleyin. Verinin raporlarda görünmesi, tarama zamanına ve Google'ın sayfayı yeniden değerlendirmesine bağlıdır.

SeekToAction neden çalışmayabilir?

SeekToAction çoğunlukla geçersiz URL kalıbı, oynatıcının saniye parametresini desteklememesi veya videonun sayfada erişilebilir olmaması nedeniyle beklenen sonucu üretmez.

En sık hata, target alanına video dosyası URL'si yazmaktır. Kullanıcının izlediği sayfa yerine doğrudan MP4 dosyasını hedeflemek, saniye parametresinin oynatıcı tarafından işlenmesini engelleyebilir.

Bir başka hata, şemadaki süreyi gerçek videodan uzun yazmaktır. Video iki dakika sürüyor fakat duration değeri üç dakika gösteriyorsa, yapılandırılmış veri güvenilirliğini kaybeder.

Sayfa şablonu değiştiğinde video URL'si de değişebilir. Eski URL'ye 301 yönlendirmesi verilse bile, saniye parametresinin yeni adreste korunup korunmadığını ayrıca test etmek gerekir.

Video yalnızca bir iframe içinde yükleniyor ve iframe kaynağı saniye parametresini kabul etmiyorsa SeekToAction beklendiği gibi çalışmayabilir. Bu durumda oynatıcı dokümantasyonundaki zaman atlama yöntemini inceleyin.

Gizli sekmede veya giriş gerektiren sayfada bulunan videolar da sorun çıkarabilir. Googlebot'un ve normal kullanıcıların aynı temel içeriğe erişebildiğini kontrol edin.

Şemada video hakkında olmayan açıklamalar kullanmayın. Örneğin videoda gösterilmeyen bir üretim sertifikasını açıklamaya eklemek, yapılandırılmış veriyi sayfa içeriğinden uzaklaştırır.

Google önemli anları göstermiyorsa, bunu doğrudan kod hatası olarak yorumlamayın. Şema geçerli olabilir; fakat Google ilgili sorgu için bu görünümü seçmemiş olabilir.

Bu nedenle test sürecini ikiye ayırın: teknik geçerlilik ve arama görünümü. İlkini araçlarla doğrulayabilirsiniz. İkincisi için tarama, içerik ve zaman faktörlerini izlemek gerekir.

Video SEO'sunda SeekToAction hangi içerik planına bağlanmalı?

SeekToAction, video çekimi başlamadan önce belirlenen bölüm planına bağlanırsa daha az hata ve daha tutarlı sayfa verisi üretir.

Ürün videosu için bölüm planı; ürünün tanıtımı, kullanım senaryosu, teknik özellikleri ve bakım bilgisi şeklinde hazırlanabilir. Her bölümün gerçek başlangıç saniyesi kurgu tamamlandıktan sonra kesinleştirilmelidir.

Fabrika videosunda ziyaretçinin görmek isteyeceği süreçleri sıralayın. Hammadde girişi, üretim hattı, kalite kontrol ve sevkiyat gibi başlıklar, videonun açıklamasında da karşılık bulabilir.

Otel videosunda oda tipleri, ortak alanlar, toplantı salonu ve konum bilgisi farklı kullanıcı niyetlerine cevap verir. Ancak videoda bulunmayan alanları şemaya veya açıklamaya eklemeyin.

Tanıtım filmlerinde açılış logosu veya uzun müzik bölümü, önemli an olarak değerlendirilmeyebilir. İçerik geçişlerini belirginleştirmek, Google'ın yanı sıra videoyu izleyen kullanıcıya da yardımcı olur.

Video sayfasının başlığını, açıklamasını ve görselini de aynı içerik planına göre hazırlayın. Sayfa “otel odaları” hakkında görünürken şema yalnızca “kurumsal tanıtım” diyorsa, sinyaller zayıflayabilir.

Bu noktada Web sitesinde Google etiketi nasıl kurulur? başlıklı rehber, ölçüm altyapısıyla sayfa uygulamasını birlikte değerlendirmek için kullanılabilir.

Video trafiğini organik aramadan ayrı ölçmek istiyorsanız, URL parametrelerinin analiz araçlarında nasıl göründüğünü kontrol edin. Saniye parametresi, raporlarda ayrı URL varyasyonları oluşturabilir.

Yerel işletmeler için video sayfasını işletme bilgileriyle de ilişkilendirmek önemlidir. İzmir'deki tesis veya otel videolarında, Google Business Profile Optimizasyonu rehberindeki profil-sayfa tutarlılığı yaklaşımı yardımcı olabilir.

Yerel arama hedefi olan bir video sayfasında konum bilgisini abartılı biçimde tekrarlamayın. İzmir, ilçe veya tesis adı yalnızca gerçek bağlam içinde kullanılmalıdır.

SeekToAction uygulamasında hangi sonuçlar ölçülmeli?

SeekToAction uygulamasında ölçülmesi gereken temel sonuçlar, teknik geçerlilik, video sayfası görünürlüğü ve saniye parametreli ziyaret davranışıdır.

Önce URL'nin açılma oranını değil, URL'nin doğru saniyeye geçip geçmediğini kontrol edin. Bu işlev çalışmıyorsa, arama sonucundaki olası görünüm kullanıcı için beklenen faydayı sağlamaz.

Search Console'da video arama görünürlüğünü izleyebilirsiniz. Raporlarda gösterim, tıklama ve ortalama konum gibi metrikler bulunabilir; ancak bunlar SeekToAction'ın tek başına getirdiği sonucu kesin olarak ayırmayabilir.

Bu nedenle değişiklik tarihlerini kaydedin. Şema ekleme tarihi, URL değişikliği, video güncellemesi ve sayfa şablonu değişikliği aynı kayıt içinde tutulmalıdır.

Video sayfasının organik tıklamalarını, genel sayfa tıklamalarından ayırmak için ayrı URL raporu veya analiz filtresi kullanın. Filtre yöntemini araç kurulumunuza göre belirleyin.

AI özellikleri veya farklı arama görünümleri için raporlama arıyorsanız, Search Console'da AI filtreleri nasıl kullanılır? rehberini ilgili ölçüm sürecine bağlayabilirsiniz.

Ölçümde yalnızca tıklamaya bakmayın. Video izleme süresi, sayfada kalma davranışı ve saniye parametresiyle açılan oturumlar birlikte incelenmelidir.

Bir video sayfası daha fazla gösterim alırken daha az video oynatımı üretebilir. Bu durum, küçük görsel, başlık, sayfa hızı veya oynatıcı davranışıyla ilişkili olabilir.

SeekToAction'ın etkisini test etmek için aynı anda birçok değişiklik yapmayın. Önce şemayı ve URL davranışını düzeltin. Sonra sayfa başlığı veya görsel gibi başka unsurları ayrı izleyin.

SEO çalışmasının maliyetini değerlendirirken yalnızca kod ekleme süresini hesaba katmayın. Video düzenleme, sayfa geliştirme, test ve yayın sonrası izleme de kapsamın parçalarıdır. Bu ayrım, SEO fiyatlarının nasıl belirlendiğini değerlendirirken daha gerçekçi bir çerçeve sağlar.

Sonuç olarak SeekToAction, video içeriğini arama motoruna daha anlaşılır biçimde tanıtabilir. Fakat geçerli kod, çalışan oynatıcı ve içerikle uyumlu sayfa birlikte gerekir.