📊 Modules/SeoManagement & Schema.org Analizi

📅 Tarih: 2025-12-02 🏢 Tenant: Tüm Tenantlar (Multi-Tenant) 🎯 Odak: Schema Türleri, Rich Snippets, 2025 SEO Standartları

📑 İçindekiler

Genel Bakış Desteklenen Schema Türleri Rich Snippets Desteği Google Merchant Uyumu SEO Settings AI Üretimi 2025 SEO Standartları Meta Tag Otomasyonu Özet ve Öneriler

🎯 Genel Bakış

SeoManagement Modülü Mimarisi

Laravel CMS'de SEO yönetimi enterprise-grade bir sistemle uygulanmıştır. Modern (2025) SEO standartlarını takip eden, AI-destekli ve multi-tenant yapıya uyumlu bir yapıdır.

Temel Bileşenler:

  • SchemaGeneratorService - Dinamik Schema.org JSON-LD üretimi
  • SchemaRegistryService - Otomatik model taraması ve pattern tespiti
  • SeoAIService - 2425 satır, çok parametreli AI analiz motoru
  • SeoSetting Model - Polymorphic SEO veri saklama
  • Universal Schemas Trait - FAQ, HowTo, Breadcrumb otomatik üretimi
  • ReviewSystem Schema - AggregateRating ve Product Schema
Bileşen Dosya Satır Özellik
Schema Generator SchemaGeneratorService.php 646 Registry + Hardcode hybrid
Schema Registry SchemaRegistryService.php 315 Dinamik model discovery
SEO AI Service SeoAIService.php 2425 Enterprise AI analizi
SEO Model SeoSetting.php 343 Polymorphic depolama

📋 Desteklenen Schema Türleri

✅ Otomatik Olarak Üretilen Schema Türleri

SchemaGeneratorService, model tipini otomatik olarak algılayıp uygun Schema.org türünü seçer.

1️⃣ Sayfa/İçerik Şemaları

BlogPosting
Blog yazıları, çoklu dil desteği, yayın tarihi, okuma süresi, yorum sayısı, kategori, etiketler
NewsArticle
Announcement (duyuru) modülü, başlık, açıklama, tarih, yazar, editör
WebPage
Page modülü, site başlığı, meta açıklama, dil desteği
CreativeWork
Portfolio projeler, başlık, açıklama, yaratıcı, görsel
Thing
Kategori/taksonomi, fallback generic tip

2️⃣ E-Ticaret Şemaları

Product 2025 Enhanced
Adı, açıklaması, SKU, GTIN-13, marka, kategori, resimler, fiyat, kullanılabilirlik, koşul, dönüş politikası
Offer
Fiyat, para birimi, kullanılabilirlik URL, dönüş politikası detayları
AggregateRating
ReviewSystem entegrasyonu, ortalama puan, puan sayısı, 1-5 skala

3️⃣ Yapısal Şemaları

FAQPage Trait
Soru-cevap çiftleri, otomatik faq_data alanından üretim
HowTo Trait
Adım adım talimatlar, howto_data JSON alanından
BreadcrumbList Trait
Navigasyon breadcrumb'ları, konum-tabanlı
Organization
Site bilgileri, logo, açıklama, sosyal medya linkleri

🔍 Kişi/Yazar Şemaları

Person (E-E-A-T için optimize)

Google 2025 E-E-A-T (Expertise, Authoritativeness, Trustworthiness) standardına uygun olarak Person şeması kullanılır (Organization değil):

  • Ad (name) - Zorunlu
  • URL (url) - Biyografi sayfası veya profil
  • İş Unvanı (jobTitle) - E-E-A-T: Uzmanlaşma göstergesi
  • Açıklama (description) - E-E-A-T: Tanınırlık
  • Resim (image) - E-E-A-T: Güvenilirlik

Kaynak: SeoSetting modelinde varsayılan author fields, blog yazarları ve editörler için otomatik doldurulur.

✨ Rich Snippets Desteği

Google Rich Results Desteği

Sistem aşağıdaki rich result türlerini otomatik olarak oluşturur:

1️⃣ Product Rich Snippet

ShopProduct Model > getSeoFallbackSchemaMarkup()

Desteklenen Alanlar:

  • ✅ Ürün Adı & Açıklaması
  • ✅ SKU, GTIN-13, MPN, Barkod
  • ✅ Marka (Brand)
  • ✅ Kategori
  • ✅ Fiyat & Para Birimi (TRY)
  • ✅ Kullanılabilirlik (InStock, OutOfStock, PreOrder, LimitedAvailability)
  • ✅ Ürün Koşulu (New, Refurbished, Used)
  • ✅ Dönüş Politikası (MerchantReturnPolicy)
  • ✅ Yorum Puanı (AggregateRating)
  • ✅ Resimleri (ImageObject, multiple)
Product Schema Örneği: { "@context": "https://schema.org", "@type": "Product", "name": "Ürün Adı", "description": "...", "offers": { "@type": "Offer", "priceCurrency": "TRY", "price": 1999.99, "availability": "https://schema.org/InStock" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.5, "ratingCount": 120 } }

2️⃣ Article Rich Snippet

Blog Model > SchemaGeneratorService

  • ✅ Başlık (headline)
  • ✅ Açıklama & İçerik (description, articleBody)
  • ✅ Yayın Tarihi (datePublished)
  • ✅ Güncelleme Tarihi (dateModified)
  • ✅ Yazar (Person type)
  • ✅ Öne Çıkan Resim (image)
  • ✅ Okuma Süresi (timeRequired, ISO 8601)
  • ✅ Kategori (about)
  • ✅ Etiketler (keywords)
  • ✅ Yorum Sayısı (commentCount)

3️⃣ FAQ Rich Snippet

HasUniversalSchemas Trait > getFaqSchema()

Model'in faq_data JSON alanından otomatik FAQPage şeması oluşturur.

{ "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Soru?", "acceptedAnswer": { "@type": "Answer", "text": "Cevap..." } } ] }

4️⃣ HowTo Rich Snippet

HasUniversalSchemas Trait > getHowToSchema()

Adım adım talimatlar için otomatik HowTo şeması (talimatlar, videolar, resimler için optimize).

5️⃣ Rating Rich Snippet

ReviewSystem Module > getSchemaMarkup()

Ürünler için AggregateRating, yorumlardan otomatik hesaplanır (1-5 skala).

🛒 Google Merchant Uyumu

✅ Merchant Center Entegrasyonu

Sistem, Google Merchant Center feed'i oluşturmak için gerekli tüm veri alanlarını sağlar.

📊 Desteklenen Alanlar

Merchant Feed Alanı Model Alanı Durum Açıklama
id product_id ✅ Benzersiz ürün ID
title title ✅ Ürün adı (70 char)
description short_description + body ✅ Detaylı açıklama
link URL (dinamik) ✅ Ürün sayfası URL
image_link media_gallery[0] ✅ Ürün ana resmi
availability stock_tracking + current_stock ✅ InStock, OutOfStock, PreOrder
price base_price + currency ✅ Fiyat TRY cinsinden
gtin barcode (GTIN-13) ✅ 13 haneli barkod
brand brand.title ✅ Marka adı
mpn model_number ✅ Üretici parça numarası
condition condition ✅ new, refurbished, used
content_language tenant locale ✅ Feed dili (tr, en vb.)
target_country setting('merchant_country') ⚠️ Hedef ülke (TR)
return_policy Return fields ✅ Geri iade politikası

📈 Merchant Feed Üretimi

Gerekli Adım: XML/CSV feed generator oluşturulmalıdır.

Önerilen Uygulamalar:

  • ✅ Shopify/WooCommerce tarzı Google Feed XML output
  • ✅ CSV feed (tab-separated, UTF-8)
  • ✅ Günlük otomatik feed generation (Scheduler)
  • ✅ Feed validation API entegrasyonu
  • ✅ Google Merchant Center API eklentisi

Not: Şu anda feed XML'i oluşturmak için ayrı bir controller/service gereklidir. Schema data hazır, feed üretimi yapılmalıdır.

🤖 SEO Settings AI Üretimi

✅ Enterprise AI-Destekli SEO Analizi

SeoAIService, 2025 standardlarına uygun kapsamlı SEO analizi yapar.

🧠 AI Analiz Motoru Özellikleri

Analiz Seviyesi Özellik Çıktı
1. Sayfa Bağlamı Page Type Intelligence Sayfa türü, SEO öncelik, içerik kategorisi
2. Gerçek Zamanlı Form veri analizi Başlık, meta, içerik length skorları
3. Detaylı Skorlama 6 parametreli scoring Title (25%), Description (20%), Content (20%), Technical (15%), Social (10%), Performance (10%)
4. Rekabet Analizi Landscape comparison Benchmark, boşluklar, fırsatlar
5. AI Deep Learning Claude AI integration Detaylı öneriler, aksiyonlar, improvement roadmap

📋 SEO Standartları (Yerleşik)

// SEO_STANDARDS sabitleri: - Title: 30-70 karakter (ideal: 50-60) - Description: 120-200 karakter (ideal: 150-160) - Keyword Density: 1-4% (ideal: 2.5%) - Content Length: 300+ (good: 800+, ideal: 1500+)

🎯 AI Önerileri Kategorileri

Teknik Öneriler
Meta taglar, structured data, page speed, mobile optimization
İçerik Önerileri
Başlık iyileştirme, description yazma, anahtar kelime optimizasyonu
Sosyal Medya
OG tagleri, Twitter Cards, share snippet optimize
Backlink Stratejisi
Referans kaynakları, linklenebilir içerik, authority building

💾 Otomatik Kayıt Alanları

AI analizi tamamlandığında SeoSetting tablosuna kaydedilen alanlar:

  • seo_score (0-100)
  • seo_analysis (JSON) - Detaylı skorlar
  • analysis_results (JSON) - AI çıktıları
  • detailed_scores (JSON) - Parametreli skorlar
  • strengths (array) - Güçlü yönler
  • improvements (array) - İyileştirme alanları
  • action_items (array) - Aksiyonlar
  • last_analyzed (datetime)
  • priority_score (1-10)

🚀 2025 SEO Standartları Uyumluluğu

✅ Güncel (2025) Google SEO Best Practices

Sistem, 2025 Google SEO yönergeleri ve algoritma güncellemelerine uyum sağlar.

1️⃣ Core Web Vitals & Page Experience

  • ✅ LCP (Largest Contentful Paint) - İçerik yükleme hızı
  • ✅ FID/INP (Interactivity) - Etkileşim gecikmesi
  • ✅ CLS (Cumulative Layout Shift) - Görsel stabilite
  • ✅ Mobile-First Indexing - Mobil öncelikli indeksleme

2️⃣ E-E-A-T (Google 2024+ Priority)

Expertise (Uzmanlık) - Author jobTitle ve description alanları

Authoritativeness (Yetki) - Backlink profili, content authority, brand mentions

Trustworthiness (Güvenilirlik) - Author image, social signals, user reviews (AggregateRating)

Experience (Deneyim) - Content freshness, author bio, domain age

2025 Person type schema kullanılarak tüm E-E-A-T sinyalleri sağlanır.

3️⃣ Rich Results (SERP Enhancements)

Enhanced Snippets
Product, Article, FAQ, Rating schemas
Knowledge Panels
Organization schema + structured data
Product Pages
Price, availability, ratings, images
How-To & FAQ
HowTo, FAQPage schemas

4️⃣ Core Algorithm Updates

Content Quality (March 2024)

  • ✅ Helpfulness Content System
  • ✅ Original research & unique perspectives
  • ✅ In-depth analysis & comprehensive guides
  • ✅ AI-generated spam detection

Spam Algorithm (March 2024)

  • ✅ Spam classification (spam, harmful, deceptive)
  • ✅ Review/rating spam detection
  • ✅ Cloaking/SEO abuse penaltisi

5️⃣ Robots.txt & Meta Directives (2025)

SeoSetting modeli, 2025 Google recommended directives'i destekler:

Robots Meta Defaults: - index: true (arama motorlarında indeksle) - follow: true (linkleri takip et) - max-snippet: -1 (sınırsız snippet) - max-image-preview: large (büyük resim ön izle) - max-video-preview: -1 (sınırsız video ön izle) - noarchive: false (cache'e izin ver) - noimageindex: false (resimleri indeksle) - indexifembedded: true (gömülü contenenti indeksle)

6️⃣ Hreflang & Multi-Langue Support

  • ✅ inLanguage - Tüm schema'lara eklenir
  • ✅ Çoklu dil desteği - SEO settings JSON fields
  • ✅ Locale-specific URLs - Dinamik dil prefix'i
  • ✅ Canonical URLs - Duplicate content önü

⚙️ Meta Tag Otomasyonu

🔄 Meta Tag Üretim Pipeline

Sistem 3 seviyeli meta tag üretim stratejisi kullanır:

Level 1: Manuel SEO Settings

Admin tarafından doğrudan SeoSetting tablosuna girilir.

  • Meta Title (çoklu dil)
  • Meta Description (çoklu dil)
  • OG Title/Description/Image
  • Canonical URL
  • Robot Meta Directives

Level 2: AI-Assisted Auto-Fill

SeoAIService form verisinden otomatik öneriler üretir:

AI Önerisi Süreci: 1. Form content parse et (title, body, excerpt) 2. Sayfa tipi tespit et (blog, product, page) 3. Anahtar kelimeleri çıkar & öner 4. Title yazı istekleri üret (8 alternatif) 5. Meta description taslakları (5 alternatif) 6. Social media snippets (OG, Twitter) 7. Overall SEO skoru hesapla

Level 3: Fallback Auto-Generation

SEO Settings yoksa model alanlarından otomatik fallback:

  • Title → Model title alanı
  • Description → Short description / body ilk 160 char
  • Image → Media gallery ilk resmi
  • Type → Model sınıfından detection

Metodlar:

  • ShopProduct: getSeoFallbackSchemaMarkup()
  • Blog: SchemaGeneratorService > BlogPosting
  • Page: SchemaGeneratorService > WebPage

🔗 SeoMetaTagService Integration

Global SEO meta tag servis, dinamik olarak route'tan model algılar:

  • Homepage detection
  • Module index page detection
  • Slug-based model lookup (URL slug'ından)
  • Admin panel routes (ID-based)

📝 Blade Component: @seo-meta

Layout'a global SEO meta tagleri ekler:

<component name="seo-meta" /> Çıktı: - <title>...</title> - <meta name="description"> - <meta property="og:*"> - <script type="application/ld+json">... schemas - <link rel="canonical">

📊 Özet ve Öneriler

✅ Yetkinlikler Özeti

Özellik Durum Maturity
Schema.org JSON-LD ✅ Tam Production-ready
Multi-Tenant Schema ✅ Tam Enterprise
AI SEO Analysis ✅ Tam Advanced (2425 lines)
Rich Snippets (5 types) ✅ Tam Comprehensive
Google E-E-A-T ✅ Tam 2025-compliant
Google Merchant ⚠️ Partial Data ready, feed builder needed
Product Feed XML ❌ Missing Need to implement
Breadcrumb Schema ✅ Trait Customizable per model

🎯 Öncelikli Geliştirme Önerileri

1. Google Merchant Feed Builder
Neden: XML feed oluşturma, Google'a ürün gönderme
Önem: YÜKSEK (e-ticaret için)
Tahmini Çaba: 2-3 saat
Dosya: Modules/Shop/app/Http/Controllers/MerchantFeedController.php
2. Breadcrumb Override'ları
Neden: Her modül için custom breadcrumb
Önem: ORTA
Tahmini Çaba: 1-2 saat
Modeller: Blog, Shop, Portfolio
3. Local SEO Schema'ları
Neden: Coğrafi konum desteği
Önem: DÜŞÜK (tenant'a bağlı)
Types: LocalBusiness, Place, Address
4. Video Schema Support
Neden: Video-rich snippets
Önem: ORTA
Schema: VideoObject, Clip, Episode

📋 Dosya Referansları

Ana Dosyalar:

  • /Modules/SeoManagement/app/Services/SchemaGeneratorService.php (646 satır)
  • /Modules/SeoManagement/app/Services/SchemaRegistryService.php (315 satır)
  • /Modules/SeoManagement/app/Services/SeoAIService.php (2425 satır)
  • /Modules/SeoManagement/app/Models/SeoSetting.php (343 satır)
  • /app/Traits/HasUniversalSchemas.php (213 satır)
  • /app/Services/SeoMetaTagService.php (dinamik meta tag üretimi)
  • /Modules/ReviewSystem/app/Services/ReviewService.php (AggregateRating)
  • /Modules/Shop/app/Models/ShopProduct.php (getSeoFallbackSchemaMarkup)

Blade Components:

  • resources/views/components/seo-meta.blade.php
  • Modules/ReviewSystem/resources/views/components/schema-markup.blade.php

💡 Best Practices

  • ✅ Tüm model'lere HasSeo trait'i ekle
  • ✅ FAQ ve HowTo veri alanlarını kullan (rich snippets)
  • ✅ Author bilgilerini SEO settings'te doldur (E-E-A-T)
  • ✅ Ürün resimlerini ImageObject olarak ekle
  • ✅ Rating sistemi aktif tutmak (AggregateRating)
  • ✅ Canonical URL'leri doğru ayarla (duplicate content)
  • ✅ Mobile-friendly responsive tasarım koru
  • ✅ Page speed optimizasyonları devam ettir (Core Web Vitals)
  • ✅ Hreflang tags'ini multi-language sayfalar için ekle
  • ✅ Google Search Console'ı monitor et (schema errors)

🎉 Sonuç

Sistem, enterprise-grade SEO infrastructure sağlar. Schema.org implementasyonu kapsamlı, AI desteği ileri düzey, ve 2025 Google standartlarına tamamen uyumludur. Yalnızca Google Merchant Feed XML üretimi ve bazı granular optimizasyonlar kalmıştır.