Yapılandırılmış Veri (Schema) Nedir? E-ticaret Siteleri İçin Uygulamalı Rehber (2026)

Yapılandırılmış veri (İngilizcesiyle structured data, SEO dilinde kısaca “schema”), bir sayfadaki bilgiyi arama motorlarının tahmin etmeden okuyabileceği standart bir biçimde tarif eden koddur. Ürün sayfanızda “449,90 TL, stokta, 1-3 iş gününde kargoda” yazar; ziyaretçi bunu bir bakışta anlar. Arama motoru ise sayfadaki onlarca rakamdan hangisinin satış fiyatı, hangisinin eski fiyat, hangisinin taksit tutarı olduğunu çıkarmak zorunda kalır. Yapılandırılmış veri bu tahmini ortadan kaldırır ve açıkça söyler: bu sayfa bir ürün; adı bu, fiyatı 449.90, para birimi TRY, stokta var.

Türk e-ticaret sitelerinin çoğu bu işaretlemeyi bir ölçüde kullanıyor, ama önemli bir kısmı emeğini yanlış yere harcıyor. Türkiye’nin en çok ziyaret edilen 50 bin sitesini taradığımız Türkiye’nin E-ticaret Siteleri 2026 raporuna göre 7.714 online mağazanın %67,9’unun ana sayfasında yapılandırılmış veri var; her üç mağazadan birinde (%32,1) hiç yok. Yapılandırılmış veri kullanan mağazaların %46,5’i ise Google’ın Kasım 2024’te arama sonuçlarından kaldırdığı site içi arama kutusunu hâlâ işaretliyor. Bu rehberde yapılandırılmış verinin ne olduğunu, bir e-ticaret sitesinde hangi sayfaya hangi işaretlemenin gerektiğini, Türkiye’de satış yapan bir mağaza için ürün, kargo ve iade işaretlemesinin nasıl yazılacağını, nasıl test edileceğini ve en sık yapılan hataları örnek kodlarla anlatıyoruz.

Yapılandırılmış veri nedir?

Yapılandırılmış veri, sayfanın içeriğini değiştirmeden sayfanın kodunda o içeriği etiketleyen bir açıklamadır. Ziyaretçi bu açıklamayı görmez; sayfa aynı görünür. Arama motoru ise sayfayı taradığında görünen metnin yanında bu etiketli özeti de okur ve sayfanın neyle ilgili olduğunu, hangi bilginin ne anlama geldiğini kesin olarak öğrenir. Bir ürün sayfasında “599,90” ile “449,90” yan yana durduğunda hangisinin eski, hangisinin güncel fiyat olduğunu tasarımdan çıkarmak gerekir; işaretlemede ise bu, bir alanın adıyla açıkça yazılıdır.

Etiketlerin ortak bir sözlüğü vardır: schema.org. Bu sözlük 2011’de Google, Microsoft ve Yahoo tarafından başlatıldı, aynı yıl Yandex de katıldı; ürün, teklif, kuruluş, yorum ve içerik haritası gibi yüzlerce türü ve her türün alanlarını tanımlar. “Schema işaretlemesi”, “şema” ve “yapılandırılmış veri” bu yüzden aynı şeyi anlatır. Bir e-ticaret sitesinde en çok kullanılan türler şunlardır: ürün için Product, fiyat ve stok bilgisini taşıyan teklif için Offer, mağazanın kendisi için Organization ya da onun online mağazalara özel alt türü OnlineStore, sayfanın sitedeki yerini gösteren içerik haritası için BreadcrumbList ve iade koşulları için MerchantReturnPolicy.

Bu sözlük üç farklı biçimde yazılabilir:

Google üç biçimi de okur ama JSON-LD’yi önerir, çünkü bu biçimde işaretleme tasarımdan ayrı durur: tema değiştiğinde ya da ürün sayfasının görünümü yenilendiğinde bozulmaz, tek bir blokta okunur ve bakımı kolaydır. JSON-LD bloğu sayfanın <head> ya da <body> bölümünde durabilir. Aynı bilgiyi hem JSON-LD hem microdata ile iki kez vermeye gerek yoktur; iki kaynak birbirini tutmazsa hangisinin doğru olduğu belirsizleşir. Kavramların genel bir özeti için Google’ın yapılandırılmış veriye giriş sayfasına bakabilirsiniz.

Yapılandırılmış veri e-ticaret sitesine ne kazandırır?

Yapılandırılmış verinin en görünür sonucu zengin sonuçlardır: arama sonucunda sayfa başlığı ve açıklamasının yanında fiyat, stok durumu ya da puan gibi ek bilgilerin görünmesi. Bir e-ticaret sitesi için karşılığı dört başlıkta toplanır:

• Ürün bilgisi sonuçta görünür: Fiyat, stok durumu, müşteri puanı, kargo ücreti, teslim süresi ve iade süresi arama sonucunda yer alabilir. Arayan kişi tıklamadan önce ürünün stokta olduğunu ve kaça satıldığını görür.
• Alışveriş yüzeylerinde yer alma şansı: Ürünü doğrudan satan sayfalar Google’ın “satıcı girişi” (merchant listing) deneyimlerine uygun hâle gelir. Alışveriş sekmesi, Google Görseller’deki ürün bilgileri ve ücretsiz ürün listelemeleri bu deneyimlerin parçasıdır.
• Mağazanın tanınması: Kuruluş işaretlemesi Google’a mağazanın adını, logosunu, iletişim bilgisini, sosyal medya hesaplarını, kargo ve iade politikasını tek bir yerden bildirir.
• Kategori yolu: İçerik haritası işaretlemesi Google’ın sayfanın sitedeki yerini anlamasına yardım eder ve sonuçta adresin yerine “Ana sayfa › Bebek › Tulum” gibi bir yolun gösterilmesini sağlayabilir.

İki şeyi baştan bilmek gerekir. Birincisi, yapılandırılmış veri tek başına bir sıralama sinyali değildir; Google onu sayfayı anlamak ve zengin sonuçlara uygunluğu belirlemek için kullanır. İşaretleme eklemek, zayıf bir ürün sayfasını üst sıralara taşımaz. İkincisi, işaretleme zengin sonucu garanti etmez: Google, sayfanın kalitesine, aramanın türüne ve işaretlemenin kurallara uyup uymadığına bakarak göstermeye kendisi karar verir.

Buna rağmen yapılandırılmış veri bir e-ticaret sitesinin en yüksek getirili teknik işlerinden biridir. Ürün sonuçlarında fiyat ve stok görünmesi, arayanı daha sayfaya gelmeden bilgilendirir; gelen tıklama fiyatı görmüş ve kabul etmiş birinden gelir. Aynı arama sonucunda rakibinizin ürününde fiyat, stok ve kargo bilgisi görünürken sizinkinde yalnız başlık görünüyorsa, arayanın gözünde eksik olan sizsinizdir.

Google Merchant Center kullanıyorsanız ayrı bir fayda daha vardır. Merchant Center’ın otomatik öğe güncellemeleri, fiyat ve stok bilgisini ürün sayfasındaki yapılandırılmış veriden okuyarak beslemedeki eski bilgiyi düzeltebilir. Kampanya dönemlerinde fiyat gün içinde değişirken beslemenin geride kalması, ürünlerin “fiyat uyuşmazlığı” nedeniyle reddedilmesine yol açan tipik durumdur; doğru işaretleme bu riski azaltır.

Sayfa türüne göre şema seçimi

Bir e-ticaret sitesinde her sayfa türünün kendi işaretlemesi vardır. Hepsini aynı anda yapmak zorunda değilsiniz; öncelik, satışın gerçekleştiği ürün sayfalarındadır. Aşağıdaki tablo hangi sayfaya neyin ekleneceğini ve hangi sırayla ele alınacağını özetliyor:

Tabloda iki nokta sık gözden kaçar. Birincisi kategori sayfalarıdır: listelenen her ürün için kategori sayfasına Product işaretlemesi eklenmez. Google, ürün işaretlemesinin tek ve belirli bir ürünü anlatan sayfada olmasını ister; “bebek tulumları” ya da “kadın ayakkabı” gibi bir liste, ürün değildir. Kategori sayfasında içerik haritası işaretlemesi yeterlidir. Kategori sayfasının asıl işi, iyi bir başlık, açıklama ve ürünlere taranabilir bağlantılarla arama trafiği toplamaktır; bunun ayrıntılarını e-ticaret SEO rehberimizde anlattık.

İkinci nokta ana sayfadır. Ana sayfadaki WebSite işaretlemesi, Google’ın arama sonucunda sitenizi hangi adla göstereceğini belirlemesine yardım eder: “name” alanına mağazanın kullandığı adı, “alternateName” alanına varsa kısaltmasını yazarsınız. Kuruluş işaretlemesi ise ana sayfada ya da mağazayı anlatan tek bir “Hakkımızda” sayfasında bir kez verilir; her sayfaya kopyalanması gerekmez. Fiziksel bir mağazanız varsa yerel aramalarda asıl belirleyici Google İşletme Profili’dir; Store işaretlemesi bu profili tamamlar, yerini tutmaz.

Ürün sayfası işaretlemesi: zorunlu ve önerilen alanlar

Google ürün işaretlemesini iki deneyim için kullanır. Ürün snippet’leri, fiyat ve puan gibi bilgileri normal arama sonucunda gösterir; ürünü satmayan inceleme sayfaları da bunlara uygun olabilir. Satıcı girişleri ise ürünü doğrudan satan sayfalar içindir; bu yüzden teklif (Offer) zorunludur, çünkü satıcı ürünü satan taraftır. Online mağazanın ürün sayfaları için esas alınacak kurallar satıcı girişi kurallarıdır ve bu kuralları karşılayan bir sayfa, ürün snippet’i için gereken bilgileri de vermiş olur. Alanların tam listesi Google’ın satıcı girişi belgesinde; bir mağaza için önemli olanlar şunlar:

Aşağıdaki örnek, indirimde olan bir ürünün sayfasına eklenecek JSON-LD bloğudur. Ürünün güncel fiyatı 449,90 TL, üstü çizili eski fiyatı 599,90 TL:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Pamuklu Bebek Tulumu, 6-9 Ay",
  "image": [
    "https://www.example.com/img/tulum-1x1.jpg",
    "https://www.example.com/img/tulum-4x3.jpg"
  ],
  "description": "Pamuklu, önden çıtçıtlı, uzun kollu bebek tulumu.",
  "sku": "TLM-069",
  "brand": { "@type": "Brand", "name": "Örnek Marka" },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/pamuklu-bebek-tulumu",
    "priceSpecification": [
      {
        "@type": "UnitPriceSpecification",
        "price": 449.90,
        "priceCurrency": "TRY"
      },
      {
        "@type": "UnitPriceSpecification",
        "priceType": "https://schema.org/StrikethroughPrice",
        "price": 599.90,
        "priceCurrency": "TRY"
      }
    ],
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}
</script>

Kodu okurken dikkat edilecek beş nokta var. Fiyat, sayfada müşteriye gösterilen KDV dahil satış fiyatıdır ve sayı olarak yazılır: “449,90 TL” ya da “1.249,90” değil, 449.90 ve 1249.90. Para birimi “TL” değil, uluslararası kod olan TRY’dir. İndirim yoksa priceSpecification listesine gerek yoktur; teklifin içine doğrudan “price”: 449.90 yazmak yeterlidir. İndirim varsa güncel fiyat hiçbir priceType almadan yazılır, eski fiyat ise StrikethroughPrice olarak işaretlenir; Google güncel fiyatı bu durumda indirimli fiyat olarak anlar. Stok durumu tam adresiyle yazılır: InStock (stokta), OutOfStock (tükendi), PreOrder (ön sipariş) ya da BackOrder (tedarik ediliyor). Son olarak, üstü çizili fiyat gerçekten uygulanmış bir önceki fiyat olmalıdır; Türkiye’de indirimli satışlardaki önceki fiyat için ayrıca mevzuat kuralları da vardır.

Barkodu olan ürünlerde gtin13 alanı özellikle değerlidir, çünkü barkod ürünün kimliğidir ve Google aynı ürünü farklı satıcılarda bu numarayla tanır. GS1 Türkiye’nin verdiği barkodlar 868 ya da 869 ile başlar. Kendi ürettiğiniz ve barkodu olmayan ürünlerde bu alanı boş bırakın; uydurma ya da başka bir ürüne ait numara yazmayın. Stok kodu (sku) ise mağazanın kendi kodudur ve her varyant için ayrı olmalıdır.

Varyantlı ürünler: ProductGroup

Beden ve renk seçenekli ürünlerde her seçenek aslında ayrı bir üründür: kendi stok kodu, barkodu, fiyatı ve stok durumu vardır. Tek bir Product işaretlemesine en düşük fiyatı yazıp geçmek, 6-9 ay bedeni tükenmişken ürünü “stokta” göstermek gibi yanlışlara yol açar. Google bunun için ProductGroup türünü destekler. Ana ürün ProductGroup olarak işaretlenir; productGroupID alanına ana ürün kodu, variesBy alanına seçeneğin türü (beden için https://schema.org/size, renk için https://schema.org/color) yazılır ve her varyant hasVariant altında kendi teklifiyle ayrı bir Product olarak listelenir.

Varyantların ayrı adresi varsa (örneğin ?beden=6-9-ay gibi bir parametreyle), her varyantın teklifindeki url alanı bu adresi göstermelidir; Google böylece arayanı doğrudan doğru bedene götürebilir. Varyantlar tek bir adreste, sayfa içinde seçiliyorsa da ProductGroup kullanılabilir. Tüm varyantları tek bir fiyat aralığıyla (AggregateOffer) anlatmak ise satıcı girişleri için yetmez; satıcı girişleri her ürün için tekil bir teklif ister. Ayrıntılı örnekler Google’ın ürün varyantları belgesinde.

Mağaza bilgisi, kargo ve iade politikası: kuruluş işaretlemesi

Kargo ücreti ve iade süresi, ürün sonuçlarında fiyattan sonra en çok dikkat çeken bilgilerdir. Bu bilgileri her ürünün teklifinde tek tek vermek mümkündür, ama Google artık mağazanın genel kargo ve iade politikasını kuruluş işaretlemesinde bir kez vermenizi öneriyor. Yalnız farklı politikası olan ürünlerde, örneğin iadesi mümkün olmayan kişiye özel ürünlerde, politika o ürünün teklifinde ayrıca yazılır ve genel politikanın yerine geçer.

Aşağıdaki örnek, ana sayfaya eklenecek bir mağaza işaretlemesidir. Örnekteki mağaza 2.000 TL ve üzeri siparişlerde ücretsiz, altında 89,90 TL kargo ücreti alıyor; hafta içi saat 14.00’e kadar gelen siparişleri en geç ertesi iş günü kargoya veriyor, teslimat 1-3 gün sürüyor; 14 gün içinde ücretsiz iade kabul ediyor. 2.000 TL’yi rastgele seçmedik: raporumuzda ücretsiz kargo eşiğini yazan mağazalarda hem en sık görülen hem de medyan tutar bu.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "OnlineStore",
  "name": "Örnek Mağaza",
  "legalName": "Örnek Ticaret Ltd. Şti.",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/img/logo.png",
  "telephone": "+90-212-000-00-00",
  "email": "destek@example.com",
  "taxID": "0000000000",
  "sameAs": [
    "https://www.instagram.com/ornekmagaza",
    "https://www.facebook.com/ornekmagaza"
  ],
  "hasMerchantReturnPolicy": {
    "@type": "MerchantReturnPolicy",
    "applicableCountry": "TR",
    "returnPolicyCountry": "TR",
    "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
    "merchantReturnDays": 14,
    "returnMethod": "https://schema.org/ReturnByMail",
    "returnFees": "https://schema.org/FreeReturn"
  },
  "hasShippingService": {
    "@type": "ShippingService",
    "name": "Türkiye içi standart kargo",
    "handlingTime": {
      "@type": "ServicePeriod",
      "cutoffTime": "14:00:00+03:00",
      "duration": { "@type": "QuantitativeValue", "minValue": 0, "maxValue": 1, "unitCode": "DAY" },
      "businessDays": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"]
    },
    "shippingConditions": [
      {
        "@type": "ShippingConditions",
        "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "TR" },
        "orderValue": { "@type": "MonetaryAmount", "minValue": 0, "maxValue": 1999.99, "currency": "TRY" },
        "shippingRate": { "@type": "MonetaryAmount", "value": 89.90, "currency": "TRY" },
        "transitTime": {
          "@type": "ServicePeriod",
          "duration": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 3, "unitCode": "DAY" }
        }
      },
      {
        "@type": "ShippingConditions",
        "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "TR" },
        "orderValue": { "@type": "MonetaryAmount", "minValue": 2000, "currency": "TRY" },
        "shippingRate": { "@type": "MonetaryAmount", "value": 0, "currency": "TRY" },
        "transitTime": {
          "@type": "ServicePeriod",
          "duration": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 3, "unitCode": "DAY" }
        }
      }
    ]
  }
}
</script>

Mağaza bilgisi. Kodda kuruluşun türü OnlineStore’dur; Google, kuruluş işaretlemesinde mağazaya en uygun alt türün kullanılmasını ve e-ticaret siteleri için OnlineStore’u öneriyor. Kuruluş işaretlemesinde zorunlu alan yoktur; mağazanıza uyan alanları doldurursunuz. Logo en az 112×112 piksel olmalı ve beyaz zemin üzerinde düzgün görünmelidir. taxID alanına vergi kimlik numarası, legalName alanına ticaret unvanı yazılır; sameAs listesine yalnız mağazanın resmî sosyal medya hesapları girilir. Alanların tamamı Google’ın kuruluş işaretlemesi belgesinde.

İade politikası. returnPolicyCategory iade penceresinin türünü (sınırlı süre, süresiz ya da iade yok), merchantReturnDays gün sayısını, returnMethod iadenin nasıl yapıldığını (kargoyla ReturnByMail, mağazada ReturnInStore) söyler. returnFees ücretin kimde olduğunu gösterir: iade kargosunu mağaza karşılıyorsa FreeReturn yazılır; müşteri ödüyorsa ReturnShippingFees yazılır ve tutar returnShippingFeesAmount alanında verilir. Türkiye’de mesafeli satışta cayma süresi 14 gündür; daha uzun bir süre tanıyorsanız işaretlemeye kendi sürenizi yazın. Kişiye özel üretilen ya da hijyen nedeniyle iadesi alınmayan ürünler gibi cayma hakkı kapsamı dışındaki ürünlerde, o ürünün teklifine iade kategorisi MerchantReturnNotPermitted olan ayrı bir politika eklenir. İade sürecini müşteri tarafında nasıl yöneteceğinizi iade yönetimi rehberimizde anlattık.

Kargo politikası. Her ShippingConditions bloğu tek bir koşulu anlatır: hangi ülkeye (shippingDestination), hangi sipariş tutarı aralığında (orderValue), kaç liraya (shippingRate) ve kaç günde (transitTime). Ücretsiz kargo eşiği iki blokla ifade edilir: eşiğin altı ücretli, üstü sıfır lira. handlingTime siparişin kargoya verilme süresini, cutoffTime ise o günün kargosuna yetişmek için son sipariş saatini gösterir; saati Türkiye saatiyle (+03:00) yazın. Kargo ve iade ayarlarını Google Merchant Center’da ya da Search Console’da da girdiyseniz Google o ayarları işaretlemeye tercih eder; iki yerdeki bilginin aynı olması en güvenli yoldur. Eşiğinizi nasıl belirleyeceğinizi ücretsiz kargo limiti rehberimizde, son sipariş saatini nasıl koyacağınızı aynı gün kargo rehberimizde bulabilirsiniz. Kargo işaretlemesinin tüm seçenekleri Google’ın kargo politikası ve iade politikası belgelerinde.

Yorum ve puan işaretlemesi: yıldızların kuralları

Arama sonucundaki sarı yıldızlar hem en çok istenen hem de en çok kötüye kullanılan zengin sonuçtur. Ürün sayfasında AggregateRating ile ortalama puanı ve değerlendirme sayısını, Review ile tek tek yorumları işaretleyebilirsiniz. Kurallar nettir ve Google’ın yorum snippet’i belgesinde ayrıntılı olarak yazılıdır:

• Yorum sayfada görünmeli: İşaretlediğiniz puan ve yorumlar, ziyaretçinin o ürün sayfasında görebildiği yorumlar olmalıdır. Başka bir sayfada duran ya da gizli bir bölmeye konmuş yorumlar işaretlenmez.
• Yorum sizin müşterinizden gelmeli: Puanlar doğrudan kullanıcılardan toplanmalıdır. Pazaryerindeki mağazanıza ya da başka sitelere yazılmış yorumları kendi sayfanızda toplayıp işaretlemek kurallara aykırıdır.
• Kendi hakkınızda yıldız çıkmaz: Google 2019’dan beri, bir kuruluşun kendi sitesinde kendisi hakkında topladığı yorumlar için (Organization ve LocalBusiness türlerinde) yıldız göstermiyor. Ana sayfaya “mağazamız 4,9 puan” işaretlemesi eklemek bu yüzden sonuç vermez.
• Uydurma puan ağır sonuç doğurur: Sayfada olmayan bir puanı işaretlemek, yapılandırılmış veri için elle işlem uygulanmasına ve sitenin zengin sonuçlara uygunluğunu tümden kaybetmesine yol açabilir.

Raporda ana sayfasında puan işaretlemesi bulunan mağaza oranı yalnız %1,3. Bu kötü bir haber değil, çünkü ürün puanının doğru yeri ürün sayfasıdır. Asıl zorluk işaretlemede değil, işaretlenecek gerçek yorumu toplamaktadır. Sipariş teslim edildikten birkaç gün sonra gönderilen kısa bir değerlendirme e-postası ya da WhatsApp mesajı, yıldızın ön koşulu olan yorumu üretmenin en pratik yoludur. Yorumu olmayan üründe puan alanlarını hiç yazmayın; boş ya da sıfır değerli bir puan işaretlemesi yarar sağlamaz, test araçlarında hataya da yol açabilir.

Artık işe yaramayan işaretlemeler

Google’ın desteklediği zengin sonuçlar zamanla değişir ve birçok e-ticaret temasında artık hiçbir görünür sonuç üretmeyen işaretlemeler duruyor. Bunlar zarar vermez ve kaldırmak zorunlu değildir; ama yeni bir işaretleme planlarken bunlara emek harcamaya gerek yoktur:

Raporumuzdaki veri, bu değişikliklerin sitelere yansımadığını gösteriyor: JSON-LD kullanan mağazaların %46,5’i, yani tüm mağazaların %31,7’si hâlâ site içi arama kutusunu işaretliyor. Google’ın duyurusunda da belirttiği gibi bu işaretleme artık bir şey kazandırmıyor ama zarar da vermiyor. Asıl risk başka yerde: ana sayfadaki bu blokların “sitede yapılandırılmış veri var” izlenimi vermesi ve asıl önemli olan ürün sayfalarının hiç kontrol edilmeden kalması. SSS ve nasıl yapılır değişikliklerinin ayrıntıları Google’ın 2023 duyurusunda.

Editör sıralaması

Bu konuda öne çıkan sağlayıcılar

Yazıda anlatılan ihtiyaç için editör sıralamasında ilk sıradaki çözümler.

1

T-SoftÜcretsiz deneme sunuyor

9.2

Siteye git →

2

TicimaxÜcretsiz deneme sunuyor

9.2

Siteye git →

3

IdeaSoftÜcretsiz deneme sunuyor

9.2

Siteye git →

Sıralama editoryal puanlamaya dayanır, ücretli yerleşim değildir. Tüm e-ticaret sağlayıcıları →

Yapılandırılmış veri nasıl eklenir?

Ekleme yolu, mağazanın hangi altyapıda çalıştığına bağlıdır. Raporumuzda yapılandırılmış veri kullanımının en çok altyapı grubuna göre değiştiğini gördük; işaretleme çoğu mağazada bilinçli bir karardan çok altyapının varsayılan ayarından geliyor. Bu yüzden önce altyapınızın ne ürettiğini görün, sonra eksiği tamamlayın.

Hazır (kiralık) altyapı

Hazır altyapıların çoğu ürün ve kuruluş işaretlemesini temada kendiliğinden üretir. Sizin işiniz eksikleri bulmaktır: bir ürün sayfasını Zengin Sonuçlar Testi’nden geçirin ve hangi önerilen alanların boş kaldığına bakın. En sık eksikler marka, barkod, kargo ve iade bilgisidir. Marka ve barkod genellikle ürün kartındaki alanlardan gelir; bu alanları doldurmak işaretlemeyi de tamamlar. Altyapıda kargo ve iade politikası için bir ayar yoksa, yukarıdaki mağaza işaretlemesini altyapının “özel kod” ya da “head alanı” gibi bir bölümünden ana sayfaya eklemek çözümdür. Altyapınıza sormanız gereken üç soru var: ürün işaretlemesi fiyat, indirim ve stokla birlikte anında güncelleniyor mu; varyantlar ayrı ayrı işaretleniyor mu; işaretlemeye ek alan eklenebiliyor mu? Altyapıların SEO özelliklerini e-ticaret altyapıları sayfamızdaki özellik tablosunda karşılaştırabilirsiniz.

Açık kaynak altyapı

Açık kaynak altyapılarda ürün işaretlemesini genellikle e-ticaret eklentisi, kuruluş ve içerik haritası işaretlemesini ise SEO eklentisi üretir. Buradaki en büyük risk çift işaretlemedir: tema, e-ticaret eklentisi ve SEO eklentisi aynı ürün için ayrı ayrı Product bloğu basabilir ve bu blokların fiyatları birbirini tutmayabilir. Bir ürün sayfasının kaynak kodunda “application/ld+json” diye arayın; aynı ürün için birden fazla blok varsa birini kapatın. Eklenti ya da tema güncellemelerinden sonra testi tekrarlayın, çünkü güncellemeler kapattığınız ayarları geri açabilir.

Özel yazılım

Kendi yazılımını kullanan mağazalarda işaretleme, biri eklemedikçe yoktur; raporda yapılandırılmış veri oranının en düşük olduğu grup budur. Yazılımcınızdan JSON-LD bloğunu sunucu tarafında, sayfadaki fiyatı ve stoku üreten aynı veriden üretmesini isteyin. Fiyat sayfaya bir kaynaktan, işaretlemeye başka bir kaynaktan gelirse kampanya dönemlerinde ikisi mutlaka ayrışır. Yukarıdaki iki örnek kod, yazılımcıya verebileceğiniz bir başlangıç şablonudur.

Etiket Yöneticisi ile eklemek

JSON-LD, Google Tag Manager ile de sayfaya eklenebilir ve Google JavaScript ile eklenen işaretlemeyi okuyabilir. Ancak ürün işaretlemesi için bu yol önerilmez: Google, ürün işaretlemesinin sayfanın ilk HTML’inde olmasını öneriyor ve JavaScript ile sonradan üretilen işaretlemenin alışveriş taramalarını seyrekleştirip güvenilirliğini azaltabileceğini belirtiyor. Fiyat ve stok gibi sık değişen bilgiler için bu ciddi bir sorundur. Etiket Yöneticisi, geçici bir çözüm olarak mağaza bilgisi gibi sabit işaretlemeler için kullanılabilir; ürün işaretlemesi temada ya da sunucuda üretilmelidir. Etiket Yöneticisi’nin kurulumu için Google Tag Manager rehberimize bakabilirsiniz.

Test ve doğrulama: Zengin Sonuçlar Testi ve Search Console

İşaretlemeyi ekledikten sonra üç araçla kontrol edin. Her biri farklı bir soruyu cevaplar:

1. Zengin Sonuçlar Testi: Google’ın test aracına sayfanın adresini yazın. Araç sayfanın hangi zengin sonuçlara uygun olduğunu gösterir; zorunlu alan eksiklerini hata, önerilen alan eksiklerini uyarı olarak listeler. Hata varsa o sayfa ilgili zengin sonuçta görünemez; uyarılar görünmeyi engellemez ama sonucu zayıflatır.
2. Schema Markup Validator: validator.schema.org, işaretlemenin schema.org sözlüğüne uygun olup olmadığını genel olarak denetler; Google’a özel uygunluğu değil. Google’ın zengin sonuç üretmediği türleri de gösterdiği için yazım hatalarını ve yanlış alan adlarını bulmakta işe yarar.
3. Search Console raporları: Search Console’un sol menüsündeki alışveriş ve geliştirmeler bölümlerinde ürün snippet’leri, satıcı girişleri ve içerik haritaları raporları sitenin tamamındaki geçerli ve hatalı sayfaları listeler. Bir hatayı düzelttikten sonra ilgili rapordan “Düzeltmeyi doğrula” ile Google’dan yeniden kontrol isteyin.

Test için her şablondan bir sayfa seçin: normal bir ürün, indirimli bir ürün, tükenmiş bir ürün, varyantlı bir ürün, bir kategori ve ana sayfa. Sorunlar genellikle tek tek sayfalarda değil şablonlarda çıkar: indirimli ürünlerde eski fiyatın güncel fiyat gibi işaretlenmesi ya da tükenen ürünün stokta görünmesi gibi. Bir şablondaki hata, o şablonu kullanan binlerce sayfada aynı anda vardır; bu yüzden altı sayfalık bir test, sitenin büyük kısmını kapsar. Tek bir sayfanın Google’ın gördüğü hâlini incelemek için Search Console’daki URL denetiminde “Canlı URL’yi test et” seçeneği de algılanan yapılandırılmış veriyi gösterir.

İşaretleme düzgünse zengin sonucun görünmesi için Google’ın sayfayı yeniden taraması gerekir; bu birkaç günden birkaç haftaya kadar sürebilir. Önemli sayfalar için URL denetiminden dizine eklenmesini isteyebilirsiniz. Altyapı değiştirirken işaretlemenin yeni sitede korunması da ayrı bir kontrol maddesidir; ayrıntılar altyapı değiştirirken SEO kaybını önleme rehberimizde.

Veri: Türk e-ticaret sitelerinde yapılandırılmış veri

Raporda mağazaların ana sayfa kodunda hangi yapılandırılmış verinin bulunduğuna baktık ve aynı veriden büyük ile küçük mağazaları ve altyapı gruplarını ayrıca karşılaştırdık:

Kaynak: EticaretRadarı, Türkiye’nin E-ticaret Siteleri 2026 ve aynı veriden ek hesaplama. 7.714 online mağaza; büyük = en çok ziyaret edilen ilk 10 bin sitedeki 1.086 mağaza, küçük = 10–50 bin arasındaki 6.628 mağaza.

Kaynak: aynı veriden ek hesaplama. Altyapı, ana sayfa kodundaki bilinen imzalardan tespit edildi; firma adı verilmiyor.

Veriden beş sonuç çıkıyor. Birincisi, her üç mağazadan biri ana sayfasında hiç yapılandırılmış veri taşımıyor. Oran küçük mağazalarda %33,2, ilk 10 bindeki büyük mağazalarda %25,3. Bu mağazaların ürün sayfalarında işaretleme olabilir, ama Google’a mağazanın kim olduğunu, logosunu ve politikalarını anlatan temel bilgi bile verilmiyor.

İkincisi, işaretlemeyi mağaza değil altyapı belirliyor. JSON-LD oranı yabancı hazır altyapılarda %86,4, açık kaynak yazılımlarda %77,1, yerli hazır altyapılarda %67,8, özel yazılımlarda %53,1. En çarpıcı fark site içi arama kutusunda: yabancı hazır ve açık kaynak altyapılarda oran yüzde 70’e yakınken yerli hazır altyapılarda %6,9. Bu fark mağazaların bilinçli tercihinden çok temaların ve eklentilerin varsayılan ayarlarını yansıtıyor; işaretleme kurulumla geliyor ve kimse kontrol etmeden yerinde kalıyor. Özel yazılımlarda ise biri eklemedikçe işaretleme yok.

Üçüncüsü, emekliye ayrılan özellik hâlâ yaygın. Site içi arama kutusu Kasım 2024’ten beri gösterilmediği hâlde mağazaların %31,7’sinde, JSON-LD kullananların %46,5’inde işaretli. Zararsız, ama işaretlemenin gözden geçirilmediğinin açık bir işareti.

Dördüncüsü, kuruluş bilgisi yaygın ama tek başına yetmez. JSON-LD kullanan mağazaların %88,2’si kuruluş ya da mağaza bilgisini işaretliyor; tüm mağazaların %8’inde ise JSON-LD olduğu hâlde kuruluş bilgisi yok. Bu taramada kargo ve iade politikası işaretlemesi ayrıca ölçülmedi; bu alanlar Google’ın kuruluş düzeyinde görece yeni desteklediği alanlar; temanızın bunları üretip üretmediğini Zengin Sonuçlar Testi ile kontrol edin. Mağazanızın kuruluş işaretlemesinde yalnız ad ve logo varsa, kargo ve iade politikasını eklemek sıradaki en değerli adımdır.

Beşincisi, modern JavaScript çatıları engel değil. Modern JavaScript çatılarıyla kurulmuş mağazalar tüm mağazaların %5,9’u; bu grubun %95,6’sının ilk HTML kodunda JSON-LD var, diğer mağazalarda ise oran %66,2. Sayfayı sunucuda üreten modern yapılar, işaretlemeyi Google’ın önerdiği gibi ilk HTML’de verebiliyor. Sorun teknolojide değil, işaretlemenin sonradan tarayıcıda eklenmesinde.

Ölçümde yalnız ana sayfanın ilk HTML kodu okundu. Ürün sayfaları taranmadığı için ürün işaretlemesinin gerçek yaygınlığını bu veri göstermez; ana sayfadaki %4,6’lık ürün işaretlemesi oranı beklenen bir düşüklüktür, çünkü ürün işaretlemesinin yeri ürün sayfasıdır. JavaScript ile sonradan eklenen işaretleme de görünmez; bu yüzden tablodaki oranlar alt sınırdır.

En sık yapılan yapılandırılmış veri hataları

• Fiyatı Türkçe biçimle yazmak: “1.249,90” ya da “449,90 TL” makine için okunamaz ya da yanlış okunur. Fiyat 1249.90 biçiminde, binlik ayracı ve para simgesi olmadan yazılır.
• Para birimini TL yazmak: “TL” geçerli bir para birimi kodu değildir; Türk lirasının kodu TRY’dir. Hazır bir temada bu alan yanlışsa bütün ürünlerde yanlıştır.
• Sayfa ile işaretlemenin fiyatının ayrışması: Kampanyada sayfadaki fiyat değişir ama işaretleme önbellekten eski fiyatı verir; ya da işaretlemeye KDV hariç fiyat, üye fiyatı veya sepette uygulanan indirimli fiyat yazılır. İşaretlemedeki fiyat, ziyaretçinin ürün sayfasında gördüğü fiyat olmalıdır.
• Güncellenmeyen stok durumu: Ürün tükendiği hâlde işaretleme “InStock” demeye devam eder. Arayan kişi stokta görünen ürüne tıklayıp tükendi yazısıyla karşılaşır; Merchant Center kullanıyorsanız ürün reddedilebilir.
• Çift işaretleme: Tema ve eklenti aynı ürün için iki ayrı Product bloğu üretir. Bloklardan biri eski fiyatı, diğeri yeni fiyatı taşıyorsa Google’ın hangisini esas alacağı belirsizleşir.
• Kategori sayfasında ürün işaretlemesi: Listelenen her ürün için kategori sayfasına Product eklemek kurallara aykırıdır; ürün işaretlemesi tek bir ürünü anlatan sayfaya aittir.
• Varyantları tek fiyatla anlatmak: Bütün bedenleri en düşük fiyatla tek bir üründe işaretlemek, pahalı bedeni arayana yanlış fiyat gösterir ve tükenen bedenleri stokta gösterir. Varyantlar için ProductGroup kullanın.
• Sayfada olmayan ya da başka yerden taşınan yorumlar: Pazaryeri yorumlarını ya da sayfada görünmeyen puanları işaretlemek, yapılandırılmış veri için elle işleme yol açabilir.
• Ürün işaretlemesini sonradan JavaScript ile eklemek: Etiket Yöneticisi ya da tarayıcıda çalışan bir betikle eklenen ürün işaretlemesi alışveriş taramalarında daha seyrek ve daha az güvenilir okunur. Ürün işaretlemesini ilk HTML’de verin.
• Taranamayan ya da küçük logo: Logo adresi robots.txt ile engellenmiş, oturum gerektiren ya da 112×112 pikselden küçük bir görseli gösteriyorsa Google logoyu kullanamaz.

Yapılandırılmış veri kontrol listesi

1. Her ürün sayfasında, ilk HTML kodunda, tek bir Product bloğu var.
2. Ürün adı, görseli, fiyatı ve para birimi (TRY) işaretlemede eksiksiz; fiyat sayı biçiminde ve sayfadaki KDV dahil fiyatla aynı.
3. İndirimli ürünlerde eski fiyat StrikethroughPrice olarak işaretli, güncel fiyat işaretsiz.
4. Stok durumu anlık güncelleniyor; tükenen ürün OutOfStock görünüyor.
5. Marka, barkod (varsa) ve stok kodu işaretlemede var; her varyantın kendi stok kodu ve barkodu işaretleniyor.
6. Varyantlı ürünler ProductGroup ile işaretlenmiş; varyantların kendi adresi varsa teklifteki url o adresi gösteriyor.
7. Ana sayfada ya da Hakkımızda sayfasında OnlineStore işaretlemesi var: ad, logo, iletişim, resmî sosyal medya hesapları.
8. Kargo politikası (ücret, ücretsiz kargo eşiği, kargoya verme ve teslim süresi) ve iade politikası (süre, yöntem, ücret) kuruluş işaretlemesinde tanımlı; istisna ürünlerde teklif düzeyinde ayrı politika var.
9. Puan ve yorumlar yalnız ürün sayfasında görünen gerçek müşteri yorumlarından geliyor.
10. Kategori sayfalarında ürün işaretlemesi yok, içerik haritası işaretlemesi var.
11. Tema, eklenti ya da altyapı güncellemesinden sonra altı şablon sayfası Zengin Sonuçlar Testi’nden geçiriliyor.
12. Search Console’daki ürün snippet’leri, satıcı girişleri ve içerik haritaları raporları ayda bir kontrol ediliyor.

Sık sorulan sorular

Yapılandırılmış veri Google sıralamasını yükseltir mi?

Doğrudan yükseltmez. Google yapılandırılmış veriyi sayfayı anlamak ve zengin sonuçlara uygunluğu belirlemek için kullanır. Etkisi dolaylıdır: fiyat, stok ve puan görünen bir sonuç, arayana daha çok bilgi verir ve daha nitelikli tıklama getirir.

Schema ile yapılandırılmış veri aynı şey mi?

Günlük kullanımda evet. Schema, yapılandırılmış verinin ortak sözlüğü olan schema.org’dan gelir. “Schema işaretlemesi” denildiğinde, schema.org sözlüğüyle yazılmış yapılandırılmış veri kastedilir.

JSON-LD kodu sayfanın neresine eklenir?

Sayfanın <head> ya da <body> bölümüne eklenebilir; Google ikisini de okur. Ürün işaretlemesinde kodun sayfanın ilk HTML’inde bulunması önerilir; her durumda işaretlemenin anlattığı bilgi sayfada da görünmelidir.

İşaretlemeyi ekledim, zengin sonuç ne zaman görünür?

Google’ın sayfayı yeniden taraması gerekir; bu birkaç günden birkaç haftaya kadar sürebilir. Search Console’daki URL denetiminden dizine eklenmesini isteyebilirsiniz. İşaretleme kurallara uygun olsa da Google zengin sonucu göstermeyi garanti etmez.

Fiyatı KDV dahil mi yazmalıyım?

Evet. İşaretlemedeki fiyat, ürün sayfasında müşteriye gösterilen satış fiyatıyla aynı olmalıdır; Türkiye’de tüketiciye gösterilen fiyat vergiler dahil fiyattır. KDV hariç fiyat yalnız sayfada da öyle gösteriliyorsa, örneğin yalnız firmalara satış yapan bir B2B sitesinde, anlamlıdır.

Stokta olmayan ürünün işaretlemesi kaldırılmalı mı?

Hayır. Ürün geri gelecekse sayfa açık kalır ve işaretlemede stok durumu OutOfStock olarak güncellenir. Ürün kalıcı olarak kalktıysa sayfa yeni modele yönlendirilir ya da kaldırılır; işaretleme de sayfayla birlikte gider.

Merchant Center kullanıyorsam yapılandırılmış veriye yine gerek var mı?

Evet, ikisi birbirini tamamlar. Besleme ürün verisini Google’a toplu olarak iletir; yapılandırılmış veri ise sayfanın kendisini anlatır ve Merchant Center’ın otomatik öğe güncellemelerinin fiyat ve stoku sayfadan doğrulamasına yardım eder. Besleme ile işaretlemedeki bilgilerin aynı olması, ürünlerin reddedilme riskini azaltır.

Bing ve Yandex yapılandırılmış veriyi okur mu?

Evet. schema.org sözlüğü Google, Microsoft, Yahoo ve Yandex’in ortak girişimidir ve JSON-LD bu arama motorlarında da okunur. Her arama motorunun zengin sonuç kuralları farklıdır; ama Google kurallarına uygun, eksiksiz bir işaretleme diğerleri için de sağlam bir temel olur.

Veri ve yöntem

Bu yazıdaki oranlar, Google CrUX Türkiye listesinde en çok ziyaret edilen 50 bin sitenin ana sayfaları 24 Eylül 2026’da taranarak hazırlanan raporumuzdan ve aynı veriden yapılan ek hesaplamadan alındı. 42.057 site istendi, 28.979’u okunabildi, 7.714’ü online mağaza çıktı. Yapılandırılmış veri, ana sayfanın ilk HTML kodunda JSON-LD bloğu ve bu bloklardaki tür adları (Organization, OnlineStore, Store, LocalBusiness, SearchAction, AggregateRating, Product, Offer) aranarak tespit edildi; ürün ve teklif işaretlemesinde microdata da sayıldı. Altyapı grubu, ana sayfa kodundaki bilinen imzalardan belirlendi. Rapor firma adı ve sıralama içermez. Yöntemin tamamı, sınırlar ve indirilebilir veri raporun yöntem bölümünde.

Kaynak: EticaretRadarı, Türkiye’nin E-ticaret Siteleri 2026, Eylül 2026.