Video Sitemap ve VideoObject İşaretleme Rehberi

Kısa cevap: sitenizdeki videoların Google'a anlatılması için iki araç var ve ikisi birbirinin yerine geçmez. VideoObject işaretlemesi sayfanın içinde durur ve videoyu tarif eder. Video sitemap ise sitemap dosyasında hangi sayfada hangi videonun bulunduğunu listeler. Google'ın belgelerine göre VideoObject için üç alan zorunludur: ad, küçük resim adresi ve yüklenme tarihi. Video sitemap için başlık, açıklama, küçük resim ve video dosyası ya da oynatıcı adresi gerekir. Hiçbiri görünürlük garantisi vermez.

Bu rehber geliştiriciler, SEO uzmanları ve yayıncılar için. Genel video SEO çerçevesi için video SEO ve YouTube rehberimize bakabilirsiniz. Genel sitemap sağlığı ayrı bir konudur ve XML sitemap denetimi ve hata çözümü yazısında işlenir. Burada yalnızca video sitemap ve VideoObject var.

Video sayfası mı, sitemap girdisi mi: ilk karar

Google'ın video belgeleri üç ayrı parçadan oluşur: VideoObject yapılandırılmış verisi (yeni sekmede açılır), video sitemap'ler (yeni sekmede açılır) ve sitelerin uyması gereken genel yapılandırılmış veri kuralları (yeni sekmede açılır). Bunlar birbirini tamamlar. İşaretleme, sayfanın kendisinin videoyu tanıttığı yerdir. Sitemap ise Google'a "şu sayfalarda şu videolar var" diye ek bir liste sunar.

İkisi arasındaki fark

Uygulama önerisi: videoların sitenin önemli içeriği olduğu durumda ikisini birlikte kullanın. Belgeler ikisinin birlikte kullanılmasını yasaklamaz. Google'ın sayfalarında bunlardan birinin yeterli olduğuna dair bir ifade yok; hangisinin sizin için daha uygun olduğu sitenin yapısına bağlıdır.

Üç tipik durum

1. Yalnızca birkaç video var, sayfaları tek tek yönetebiliyorsunuz. İşaretleme yeterli olabilir. Sitemap'i de eklemek keşfi kolaylaştırır.
2. Yüzlerce video, şablonla üretilen sayfalar. Şablona VideoObject eklemek ve sitemap'i otomatik üretmek ölçeklenebilir yoldur.
3. Videolar makalelerin içinde gömülü. Karar sorusu en çok bu durumda ortaya çıkar.

Ortak kural: sayfa gerçekten videoyu göstermeli

Google sayfalarında tekrarlanan bir ilke var: işaretlediğiniz şey kullanıcının sayfada görebildiği şeyle uyumlu olmalıdır. Genel yapılandırılmış veri kuralları, sayfada görünmeyen içeriği işaretlememenizi ve işaretlemenin sayfa içeriğinin doğru bir temsili olmasını ister. Video sitemap belgesi de sayfayla ilgisiz videoları listelememenizi söyler. Yani video, sayfanın konusuyla ilgili olmalı ve izleyici onu gerçekten oynatabilmelidir.

VideoObject: zorunlu ve önerilen alanlar

Google'ın video işaretleme belgesi, özelliklerin tamamını iki gruba ayırır. Aşağıdaki liste belgedeki ifadelerle uyumludur. Belgedeki sınırlar zamanla değişebilir; uygulamadan önce güncel sayfaya bakın.

Zorunlu alanlar

• name: videonun başlığı. Sitedeki her video için benzersiz bir metin olmalı.
• thumbnailUrl: videonun kendine özgü küçük resim dosyasının adresi.
• uploadDate: videonun ilk yayınlandığı tarih ve saat, ISO 8601 biçiminde. Saat dilimi yazmazsanız Google, Googlebot'un saat dilimini kullanır.

Önerilen alanlar

contentUrl ve embedUrl farkı

İki alan sık karıştırılır. contentUrl, doğrudan video dosyasına gider. Belge bunun yanlışlıkla videonun bulunduğu sayfaya ayarlanmaması gerektiğini vurgular. embedUrl ise oynatıcının adresidir. YouTube, Vimeo gibi sağlayıcılardan gömüyorsanız dosya adresine sahip olmayabilirsiniz; bu durumda embedUrl kullanılır.

Clip: önemli bölümler

Clip işaretlemesi, videonun belirli bölümlerini tarif eder. Belgeye göre zorunlu alanlar şunlardır: name (bölümün açıklayıcı başlığı), startOffset (videonun başından saniye cinsinden başlangıç) ve url (videonun adresiyle aynı yola sahip, zaman parametresi içeren adres, örneğin ?t=120). endOffset önerilir. Belgenin kuralları: video, başlangıç dışında bir noktaya doğrudan bağlantıyı desteklemeli, toplam süre en az 30 saniye olmalı, aynı sayfada aynı video için iki Clip aynı başlangıç zamanını taşımamalı ve sayfa kullanıcının videoyu izlemesine imkân vermelidir.

BroadcastEvent: canlı yayın

publication alanıyla birlikte BroadcastEvent kullanıldığında isLiveBroadcast, startDate ve endDate zorunludur. Belge, yayın başladığında, bittiğinde ve işaretleme değiştiğinde Indexing API kullanmayı söyler; bu API yalnızca canlı yayın videoları destekler. Canlı yayın yapmıyorsanız bu alanları eklemeyin.

Alan seçimi için kontrol listesi

• name, thumbnailUrl ve uploadDate üç videoda da eksiksiz mi?
• uploadDate saat dilimi içeriyor mu?
• contentUrl yazılıyorsa gerçekten dosyaya mı gidiyor?
• Clip kullanılıyorsa video en az 30 saniye mi ve başlangıç zamanları farklı mı?
• Süre dolan videolarda expires var, dolmayanlarda yok mu?
• Küçük resim adresi taranabilir ve dizinlenebilir mi?

Son maddeyi genel yapılandırılmış veri kuralları ister: yapılandırılmış veride belirtilen tüm görsel adresleri taranabilir ve dizinlenebilir olmalıdır.

Sitemap girdisi örneği

Video sitemap'te her sayfa bir loc öğesidir ve altına videolar eklenir. Google'ın belgesi, aynı barındırma sayfasındaki her video için loc öğesinin içine birden fazla video:video öğesi yerleştirilebileceğini söyler.

Zorunlu etiketler

Seçime bağlı etiketler

content_loc ve player_loc

content_loc, gerçek video dosyasına işaret eder ve desteklenen bir biçimde olmalıdır. Belge HTML ve Flash'ın desteklenmediğini yazar. content_loc üst öğedeki loc adresiyle aynı olmamalıdır. player_loc ise belirli bir videonun oynatıcı adresidir ve o da loc adresiyle aynı olmamalıdır. content_loc yoksa alternatif olarak player_loc kullanılır.

Örnek girdi, etiket etiket

Örnek senaryo: bir mutfak ekipmanı markası, "Ekmek makinesi bakımı" başlıklı bir rehber sayfasında tek video yayınlıyor. Girdi şu bilgilerle kurulur:

Bu liste etiketlerin sırasını belirlemez; gerçek XML dosyasını sitemap üreticiniz oluşturur. Başlık ve açıklama, sayfada görünenle örtüşmeli, küçük resim adresi robots.txt ile engellenmemiş olmalıdır.

Erişim ve robots kuralları

Belge, sitemap'teki adreslerin robots.txt kurallarıyla taramaya kapatılmamış olması gerektiğini söyler. Adresler metadosya ya da oturum açma olmadan erişilebilir olmalı, güvenlik duvarları tarafından engellenmemeli ve HTTP ya da FTP kullanmalıdır. Akış protokolleri desteklenmez. Dosya yalnızca video listelemek zorunda değildir; mevcut sitemap'inize video etiketleri ekleyebilir ya da ayrı bir video sitemap açabilirsiniz. Belge bu seçim için bir kural koymuyor.

Sitemap girdisi kontrol listesi

• Her videoda title, description, thumbnail_loc ve content_loc ya da player_loc var mı?
• Açıklama 2048 karakteri aşmıyor mu?
• content_loc ve player_loc adresleri loc ile aynı değil mi?
• Sitemap'teki sayfalar robots.txt ile engellenmemiş mi?
• Süresi dolan videolarda expiration_date güncel mi?
• Videolar sayfa konusuyla ilgili mi?

Gömülü YouTube videosu ve sayfa konumu

Çoğu site videosunu YouTube'dan gömer. Google'ın video sitemap belgesi bu durumu açıkça anar: Vimeo, YouTube ve iframe ile gömmeye izin veren diğer platformlarda video:content_loc yerine player_loc kullanılır. Belgede YouTube için bir örnek de var ve player_loc içinde bir gömme adresi kullanılıyor.

Gömülü videoda neyi kontrol edersiniz

1. Sayfada gerçekten görünüyor mu? Uygulama önerisi: iframe, sayfayı ilk açan kullanıcı için yüklenmeli. Tıklayınca yüklenen bir oynatıcının nasıl ele alınacağını belgeler söylemez, bu yüzden ona güvenmeyin. Sitemap'teki adreslerin oturum açmadan erişilebilir olması ise belgede yazan bir koşuldur.
2. Küçük resim sizin mi? YouTube'un küçük resmi yerine sayfanıza özgü bir küçük resim kullanmak istiyorsanız adresinin taranabilir olması gerekir.
3. Oynatıcı adresi videoya özgü mü? player_loc, belirli bir videonun oynatıcısına gitmeli; genel bir oynatıcı sayfasına değil.
4. Sayfa videonun etrafında içerik taşıyor mu? Belgede bu konuda kesin bir ifade yok; ancak ilgisiz videoları listelemeyin kuralı, sayfa ile video arasında bir konu bağı bekler.

Videonun sayfadaki yeri

Uygulama önerisi: videoyu ilk ekranda ya da başlığın hemen altında gösterin. Belgede "videoyu sayfanın en üstüne koyun" diye bir kural yok. Ancak kullanıcının videoyu kolay bulması, hem izleyici hem de doğrulama açısından işleri kolaylaştırır. Videoyu bir sekmenin ya da kapalı bir menünün içinde saklamak, kullanıcının onu görmesini zorlaştırır.

YouTube sahibi olarak çifte iş

Kendi YouTube kanalınızdaki bir videoyu sitenize gömüyorsanız iki yerde video sayfanız olur: YouTube izleme sayfası ve sizin sayfanız. Bu durumda iki sayfayı farklı amaçlara göre yazın. YouTube açıklaması izleyiciyi kanalda tutar. Sitedeki sayfa ise okuyucuya videonun bağlamını ve ek bilgiyi sunar.

Her makaleye video eklenince ayrı video sayfası gerekir mi

Karar sorusu şudur: makale içine bir video eklediğimizde ayrı bir video sayfası gerekir mi? Belgeler ayrı sayfa gerektiğini söylemiyor. Video sitemap belgesi, aynı barındırma sayfasında birden çok videoya izin verir ve her video için bir video:video öğesi ister.

Karar kuralı

Uygulama önerisi olarak şu soruları sırayla sorun:

1. Video, makalenin konusunu anlatan temel öğe mi, yoksa destekleyici bir örnek mi? Temel öğeyse makale sayfası zaten video sayfasıdır. Ayrı sayfa gerekmez.
2. Sayfadaki video kullanıcı için kolay bulunur ve oynatılabilir mi? Evetse işaretleme ve sitemap girdisi yeterli olabilir.
3. Aynı video birden çok makalede kullanılıyor mu? Her kullanımda o sayfada video işaretlemesi yapılır, ama yinelenen sayfa üretmek için ayrı bir neden yoksa kopya sayfa açmayın.
4. Video kendi başına arama değeri taşıyor mu (ayrı bir konu, ayrı bir sorgu)? O zaman ayrı bir sayfa, kendi başlığı ve açıklamasıyla anlamlı olabilir.

Belge ayrı bir kural koymadığı için bu bir sezgidir; ürün ve içerik yapınıza göre farklı karar verebilirsiniz.

Karar tablosu

Makale şeması ile birlikte kullanım

Makale sayfasına video eklediğinizde sayfada iki farklı işaretleme olabilir: makaleyi tanımlayan Article ve videoyu tanımlayan VideoObject. İkisi birbirini engellemez; yalnızca her biri kendi öğesini doğru temsil etmelidir. Makale şeması için Article ve FAQ işaretlemesi rehberine, genel JSON-LD yapısı için yapılandırılmış veri JSON-LD rehberine bakabilirsiniz.

Test, yayın ve izleme

Google'ın video işaretleme belgesi bir dağıtım sırası önerir. Aşağıdaki adımlar o belgeyle uyumludur.

Yayın öncesi

1. Rich Results Test ile işaretlemeyi doğrulayın ve kritik hataları düzeltin.
2. Birkaç sayfayı yayına alın ve URL Inspection aracıyla Google'ın sayfalara erişebildiğini doğrulayın. Sayfalar robots.txt, noindex ya da oturum isteğiyle engellenmemeli.
3. Google'dan yeniden tarama isteyin ve sitemap gönderin.

Genel yapılandırılmış veri kuralları da yapılandırılmış veri sayfalarını robots.txt, noindex ya da başka bir erişim denetimiyle Googlebot'a kapatmamanızı ister.

Search Console ile izleme

Belgeye göre ilk dağıtımdan sonra Rich result status raporunda geçerli öğelerin arttığını ve geçersiz öğelerin artmadığını kontrol edin. Sorun varsa düzeltin, canlı adresleri inceleyin ve doğrulama isteyin. Şablon ya da kod değişikliğinden sonra geçersiz öğelerde artış ya da geçerli öğelerde düşüş olup olmadığını izleyin. Düzenli aralıklarla Performance raporunda sayfaların zengin sonuç olarak görünme sıklığını, tıklamaları ve ortalama konumu takip edebilirsiniz. Search Console API ile bu veriyi otomatik çekmek de mümkündür. Arayüzü Türkçe kullanıyorsanız rapor adları farklı görünebilir.

İhlallerde ne olur

Google, yönergeleri aşan tekniklerin manuel işlem doğurabileceğini yazar. Genel yapılandırılmış veri kurallarına göre manuel işlem, sayfanın zengin sonuç olarak görünme uygunluğunu kaldırır; bu işlem sayfanın web aramasındaki sıralamasını değiştirmez. Manual Actions raporu Search Console'da bulunur.

Test planı tablosu

Sık görülen hatalar

• Sayfada görünmeyen videoyu işaretlemek. İşaretleme sayfa içeriğinin doğru temsili olmalıdır.
• contentUrl'i sayfa adresine ayarlamak. Belge bunu açıkça yapmayın der.
• Sitemap'te loc ile content_loc'u aynı yapmak. İki adres aynı olmamalıdır.
• Küçük resmi robots.txt ile engellemek. Görsel adresleri taranabilir olmalıdır.
• Süresi dolan videoyu expires ya da expiration_date olmadan bırakmak. Süresi doluyorsa tarihi yazın.
• Açıklamayı 2048 karakter üstüne çıkarmak. Sitemap'te bu sınır geçerlidir.
• Test yapmadan toplu dağıtım. Önce birkaç sayfada deneyin.

Başlık, açıklama ve küçük resim tutarlılığı

İşaretleme ve sitemap aynı videoyu iki yerde anlattığı için tutarsızlık kolayca oluşur. Başlık bir yerde güncellenir, öbür yerde eski kalır.

Tek kaynak ilkesi

Uygulama önerisi: video başlığını, açıklamasını, küçük resim adresini, süresini ve yayın tarihini tek bir veri kaynağında tutun. Sayfa şablonu, VideoObject işaretlemesi ve sitemap üretimi bu kaynaktan beslensin. Böylece editör başlığı değiştirdiğinde üç yerde de değişir. Google belgeleri sitemap başlığının sayfadaki başlıkla, sitemap açıklamasının sayfadaki açıklamayla örtüşmesini ister; tek kaynak bu beklentiyi kendiliğinden karşılar.

Tutarlılık tablosu

Bu tablodaki alanlar belgelerde ayrı ayrı anlatılır; eşleştirme, ekip için bir kontrol aracıdır. Süre ve yayın tarihi gibi alanlarda bir fark, kullanıcıda ve doğrulama araçlarında kafa karışıklığı yaratır.

Küçük resim

VideoObject belgesi thumbnailUrl için videoya özgü bir küçük resim ister ve ayrıntıları ayrı bir yönergeye bırakır. Bu sayfada boyut ya da oran kuralı yer almıyor, bu yüzden bir ölçü uydurmayın. Genel kural olarak küçük resim adresi taranabilir ve dizinlenebilir olmalıdır. Küçük resmi bir CDN'de ya da oturum gerektiren bir alanda tutuyorsanız Googlebot'un ona ulaşıp ulaşamadığını URL Inspection ile kontrol edin.

Süre ve tarih biçimleri

duration ISO 8601 biçimini kullanır (örneğin PT1M54S). uploadDate de ISO 8601 biçimindedir ve saat dilimi içermelidir. Sitemap tarafında video:duration saniye cinsinden bir tam sayıdır ve 1 ile 28800 arasında olmalıdır. İki yerde iki farklı biçim kullanıldığını unutmayın; şablonda dönüşümü tek bir işlevde yapın.

Örnek senaryo: üç sayfalık deneme dağıtımı

Örnek senaryo: bir bahçe ekipmanları markasının blogunda 40 rehber yazısı var ve altısında kendi çektiği videolar gömülü. Ekip önce hepsini işaretlemek yerine küçük bir deneme yapar.

1. Envanter. Altı sayfanın adresi, video başlığı, küçük resmi ve süresi bir tabloya yazılır. İkisinde video makalenin ana içeriği, dördünde destekleyici örnektir.
2. Şablon. Blog şablonuna VideoObject eklenir. Zorunlu üç alan ve contentUrl yerine embedUrl kullanılır, çünkü videolar bir sağlayıcıdan gömülüdür.
3. Sitemap. Mevcut sitemap yapısına dokunmadan ayrı bir video sitemap açılır ve altı sayfa eklenir. Her girdide player_loc kullanılır.
4. Doğrulama. İki sayfa Rich Results Test'ten geçirilir, hatalar düzeltilir. Ardından URL Inspection ile Googlebot'un sayfaya erişebildiği doğrulanır.
5. İzleme. Search Console'da Rich result status raporuna bakılır. Geçersiz öğe yoksa kalan sayfalara aynı şablon uygulanır.

Bu senaryoda önemli olan, sürecin geri alınabilir olmasıdır. Küçük bir deneme, şablon hatasının tüm siteye yayılmasını önler.

Denemede çıkabilecek sorunlar

Bakım: video değiştiğinde ne yapılır

Videolar yayınlandıktan sonra değişir: silinir, güncellenir, gizlenir ya da süresi dolar. İşaretleme ve sitemap bu değişikliği yansıtmazsa belirsizlik oluşur.

Video kaldırıldığında

Videoyu sayfadan kaldırdıysanız işaretlemeyi ve sitemap girdisini de kaldırın. Sayfada görünmeyen içerik işaretlenmemelidir. Süresi dolan videoyu otomatik yönetmek istiyorsanız VideoObject'te expires, sitemap'te video:expiration_date kullanabilirsiniz. Belge, süre sonu etiketinin yalnızca videonun süresi dolacaksa yazılmasını söyler.

Video güncellendiğinde

Yeni sürümü yayınladığınızda küçük resim, süre ve açıklamayı yenileyin. uploadDate videonun ilk yayın tarihidir; belge bunu "ilk yayınlandığı tarih" olarak tanımlar. Küçük bir düzeltme için tarihi değiştirmek yerine tarihi koruyup diğer alanları güncelleyin. Belgede bu konuda başka bir ifade yok.

Düzenli kontrol takvimi

Takvimdeki sıklıklar bir öneridir, belgelerde böyle bir periyot yazmaz. Belgelerdeki kurallar değişebilir; uygulamadan önce güncel sayfaya bakın.

Uygulama planı: ekip için sırayla

Küçük bir ekip için sade bir sıra yeterlidir.

1. Sitedeki videoların envanterini çıkarın: sayfa adresi, video başlığı, küçük resim, süre, yayın tarihi.
2. Hangi sayfalarda videonun ana içerik, hangilerinde destekleyici olduğunu işaretleyin.
3. Şablonda VideoObject için zorunlu üç alanı ekleyin, ardından önerilen alanları ekleyin.
4. Sitemap üretimini kurun ve etiket kurallarını (2048 karakter, 32 etiket, süre sınırı) test edin.
5. Üç sayfada deneyin, Rich Results Test ve URL Inspection ile doğrulayın.
6. Tamamını yayına alın, Search Console raporlarını izleyin.
7. Her şablon değişikliğinde raporu yeniden kontrol edin.

Sorumluluk dağılımı

Geliştirici şablon ve sitemap üretiminden, editör başlık ve açıklama metninden, SEO uzmanı doğrulama ve izlemeden sorumlu olabilir. Editörün yazdığı başlık ve açıklama, işaretleme ve sitemap'e aynı kaynaktan akarsa iki yerde tutarsızlık oluşmaz.

İlgili rehberler: YouTube ve Discover'dan Web Sitesine Trafik Rehberi, Google Discover Performans Raporu Nasıl Okunur?, YouTube Video Açıklaması ve Bölümler: Yazım Rehberi.

Sonuç

VideoObject sayfa içinde videoyu tarif eder, video sitemap ise sayfa ile videoyu eşleştirir. Google'a göre VideoObject için ad, küçük resim adresi ve yüklenme tarihi zorunludur; contentUrl, embedUrl, süre, Clip ve diğerleri önerilir. Video sitemap'te başlık, açıklama (en fazla 2048 karakter), küçük resim ve content_loc ya da player_loc gerekir. YouTube gibi gömülü sağlayıcılarda player_loc kullanılır. Makaleye video eklemek ayrı bir video sayfası gerektirdiğini Google belgelerinde yazmıyor; karar videonun sayfadaki rolüne göre verilir. Önce birkaç sayfada test edin, Search Console ile izleyin ve hiçbir adımın zengin sonuç ya da sıralama garantisi vermediğini unutmayın.

Video içeren rehber ve makale sayfalarının metinlerini hazırlamak için makale yazımı hizmetine göz atabilirsiniz; kapsam ve koşullar ürün sayfasında anlatılır.

Sık Sorulan Sorular

Video sitemap ile VideoObject aynı şey mi?

Hayır. VideoObject sayfanın içindeki yapılandırılmış veridir ve videoyu tarif eder. Video sitemap ise sitemap dosyasında sayfa ile videoyu eşleştiren listedir. Google'ın belgeleri bunları ayrı sayfalarda anlatır; birlikte kullanılmaları yasak değildir.

VideoObject için zorunlu alanlar hangileri?

Google'ın belgesine göre name, thumbnailUrl ve uploadDate zorunludur. uploadDate ISO 8601 biçiminde olmalı ve saat dilimi içermelidir; yoksa Googlebot'un saat dilimi kullanılır. Belgedeki ayrıntılar değişebilir, uygulamadan önce güncel sayfaya bakın.

YouTube'dan gömdüğüm video için hangi etiketi kullanırım?

Video sitemap belgesine göre Vimeo, YouTube gibi iframe ile gömülebilen platformlarda content_loc yerine player_loc kullanılır. player_loc belirli videonun oynatıcı adresi olmalı ve sayfanın loc adresiyle aynı olmamalıdır.

Video sitemap açıklaması kaç karakter olabilir?

Belgede video:description için en fazla 2048 karakter yazıyor. Açıklamanın sayfadaki açıklamayla birebir aynı olması gerekmez ama onunla örtüşmesi beklenir.

Makaleye video koyunca ayrı bir video sayfası açmam gerekir mi?

Google belgeleri ayrı sayfa gerektiğini söylemiyor. Video sitemap, aynı sayfada birden çok videoya izin verir. Video makalenin ana içeriğiyse makale sayfası yeterli olabilir; video kendi başına bir konuysa ayrı sayfa düşünülebilir. Bu ikinci kısım bir uygulama önerisidir.

Clip işaretlemesi için ne gerekir?

Belgeye göre name, startOffset ve url zorunludur; endOffset önerilir. Videonun başlangıç dışındaki bir noktaya bağlantıyı desteklemesi ve toplam süresinin en az 30 saniye olması gerekir. Aynı sayfada aynı video için iki Clip aynı başlangıç zamanını taşımamalıdır.

Bu işaretlemeler videomun Google'da görünmesini garanti eder mi?

Hayır. Google sayfaları işaretlemenin uygunluk sağlayabileceğini söyler, görünürlük vaadi vermez. Doğrulama ve izleme için Rich Results Test, URL Inspection ve Search Console raporları kullanılır.