Shopify Trendyol Yorum Aktarma: Theme App Extension ile Uçtan Uca Kurulum

Shopify tarafında yorum konusu, Ikas veya Ticimax tarafından teknik olarak epey farklı ilerler. Sebebi basit: Shopify, tema koduna dışarıdan müdahaleyi yıllar içinde giderek kısıtladı ve uygulamaların temaya içerik basması için theme app extension adında ayrı, kurallı bir mekanizma tanımladı. Bu yüzden "siteye bir script kodu yapıştır, bitsin" yaklaşımı Shopify'da hem çalışmaz hem de uzun vadede temanızı kırar.

Bu yazıda Shopify mağazanıza Trendyol yorumlarını aktarmanın dört teknik yolunu, hangisinin ne zaman doğru olduğunu, ürün eşleştirmenin gerçekte nerede tıkandığını, hız (Core Web Vitals) etkisini, çoklu dil ve çoklu para birimi mağazalarda ne değiştiğini ve çoğu rehberin es geçtiği Google schema politikasını anlatıyoruz.

Shopify Trendyol yorum aktarma nedir?

Shopify Trendyol yorum aktarma; Trendyol mağazanızdaki ürün değerlendirmelerinin (yıldız puanı, yorum metni, tarih, varsa müşteri fotoğrafı) belirli aralıklarla toplanıp Shopify ürün sayfanızda ilgili ürünün altında gösterilmesidir. Süreç üç parçadan oluşur:

1. Veri toplama: Trendyol tarafındaki yorumların bir sunucuda toplanması ve tekilleştirilmesi.
2. Ürün eşleştirme: Trendyol ürününün Shopify'daki hangi ürün ya da varyanta karşılık geldiğinin barkod veya stok kodu üzerinden belirlenmesi.
3. Vitrinde yayınlama: Yorumun Shopify temasında, tasarımla uyumlu biçimde basılması.

Genel mantığı ve Trendyol tarafındaki veri kaynağı meselesini daha önce Trendyol yorumlarını siteye aktarma yazısında ele almıştık. Burada odağımız tamamen üçüncü adım, yani Shopify tarafı.

Önemli bağlam: Shopify'ın yerleşik Product Reviews uygulaması artık yok

Bu, Shopify'da yorum konusunu araştıran herkesin ilk öğrenmesi gereken şey. Shopify'ın uzun yıllar ücretsiz sunduğu Product Reviews uygulaması emekliye ayrıldı. Shopify destek ekibinin resmî topluluk forumundaki açıklamasına göre uygulama 5 Eylül 2023 itibarıyla sunset edildi ve App Store listesinden kaldırıldı; uygulamayı daha önce kurmuş mağazalar mevcut yorumlarını dışa aktarabilmek için 2024 Ocak sonuna kadar süre buldu. Shopify'ın gerekçe olarak belirttiği nokta, üçüncü taraf yorum uygulamalarının doğrulanmış alışveriş kontrolü gibi daha kapsamlı özellikler sunmasıydı.

Bunun pratik sonuçları şunlar:

• Bugün yeni açtığınız bir Shopify mağazasında ürün sayfasına yorum basan yerleşik ve ücretsiz bir uygulama bulunmuyor. Yorum altyapısı için mutlaka bir uygulama kurmanız ya da özel geliştirme yaptırmanız gerekiyor.
• Shopify'ın bugün sunduğu yerleşik değerlendirme mekanizması Shop uygulaması tarafındadır; sipariş teslim edildikten sonra müşteriye Shop uygulamasından değerlendirme bildirimi gider. Bu, kendi ürün sayfanızdaki yorum bloğuyla aynı şey değildir.
• Eski Product Reviews uygulamasından kalma spr- önekli CSS sınıflarını ve reviews metafield yapısını hâlâ birçok temada görürsünüz. Yeni bir kurulum yaparken bu kalıntıları temizlemek gerekir, aksi halde iki ayrı yorum bloğu üst üste görünür.

Yani Shopify'da yorum, artık "varsayılan olarak gelen" bir özellik değil, bilinçli olarak kurduğunuz bir katman. Trendyol yorumlarını taşıma kararı da tam bu boşluğa oturuyor.

Shopify'da yorum basmanın dört teknik yolu

Aşağıdaki tablo, Shopify ürün sayfasına dışarıdan yorum içeriği basmanın dört yöntemini karşılaştırıyor. Hepsi teknik olarak mümkündür; hangisinin doğru olduğu mağazanızın temasına ve ihtiyacınıza bağlıdır.

Pratikte olgun bir çözüm bunları birlikte kullanır: ürün sayfasındaki ana yorum listesi app block ile, koleksiyon sayfasındaki küçük yıldız rozetleri app embed ile, sayfalama ve fotoğraf galerisi gibi dinamik istekler app proxy ile çalışır.

Theme app extension: Shopify'ın kurallı yolu

Theme app extension, bir uygulamanın temaya içerik eklemesinin Shopify tarafından desteklenen yoludur. Uygulama, tema dosyalarına dokunmaz; kendi bloklarını ve varlıklarını ayrı bir paket olarak yayınlar, mağaza sahibi de bunları tema editöründen açar. Varlıklar Shopify CDN'inden servis edilir ve sürümlenir.

App block ile app embed block farkı

• App block, şemasında target değeri section olan bloktur. Mağaza sahibi tema editöründe ürün şablonunu açar, Blok ekle > Uygulamalar menüsünden yorum bloğunu ekler ve fiyatın altına mı yoksa açıklamanın altına mı geleceğine kendisi karar verir. Bunun için temanın JSON şablon kullanması ve ilgili bölümün @app blok tipini kabul etmesi gerekir.
• App embed block, target değeri head, compliance_head veya body olan bloktur. Sayfanın ilgili bölümünün kapanış etiketinden hemen önce enjekte edilir. Dinamik veri kaynağına bağlanamaz, yalnızca global Liquid kapsamına erişir. Buna karşılık vintage temalarda da çalışır, bu yüzden eski temalı mağazalarda tek pratik seçenek çoğu zaman budur.

İkisinin de ortak bir davranışı var ve kurulum sırasında en sık kafa karıştıran nokta bu: uygulama kurulduğunda bloklar varsayılan olarak kapalıdır. Uygulamayı kurup ürün sayfasına bakıp "hiçbir şey görünmüyor" demenizin sebebi genelde budur. Tema editöründen bloğu açmak ayrı bir adımdır.

Bilmeniz gereken sert sınırlar

Shopify, theme app extension paketlerine somut sınırlar koyar. Bir yorum modülünün performans davranışını anlamak için bu tablo faydalıdır:

Buradaki en anlamlı satır 10 KB JavaScript tavsiyesi. Shopify, temaya eklenen bir uygulama bloğunun sıkıştırılmış JavaScript boyutunun 10 KB'ı geçmemesini öneriyor. Bir yorum modülü değerlendirirken sorulacak somut soru şudur: bu blok ürün sayfama kaç KB JavaScript ekliyor? Cevabı ölçebilirsiniz, tahmine gerek yok.

Yapamayacağı şeyler

• Checkout adımlarında (iletişim bilgisi, kargo, ödeme, sipariş durumu) render edilemez.
• content_for_header, content_for_index ve content_for_layout nesnelerine erişemez.
• App block, içinde bulunduğu bölümün yalnızca id özelliğine erişebilir; bölümün diğer ayarlarını okuyamaz.
• Blok adları en fazla 25 karakter olabilir.

Ürün eşleştirme: işin gerçekten zor kısmı

Yorum verisini almak çözülebilir bir problemdir. Projelerde zaman ve para yakan asıl konu, Trendyol'daki ürünün Shopify'daki hangi kayda karşılık geldiğini doğru belirlemektir. Yanlış eşleştirme, siyah tişörtün yorumlarını beyaz sweatshirt sayfasında göstermek demektir; bu da sosyal kanıt değil, itibar kaybıdır.

Shopify tarafında hangi alanlar kullanılabilir?

Shopify'da eşleştirmeye uygun alanlar varyant seviyesindedir. Liquid'de varyant nesnesi üzerinden hem sku hem barcode alanına erişebilirsiniz; her ikisi de metin tipindedir. Ürün nesnesi ise metafields, selected_variant ve variants alanlarını sunar.

Shopify'a özgü üç tuzak

1. Barkod alanı boş bırakılır. Shopify'da barkod zorunlu alan değildir ve Türkiye'deki mağazaların önemli bölümünde boştur. Eşleştirme kalitesini artırmanın en ucuz yolu, entegrasyona başlamadan önce Shopify Admin üzerinden toplu düzenleme (bulk edit) ile barkod sütununu doldurmaktır.
2. Varyant kırılımları iki tarafta aynı değildir. Trendyol'da her renk-beden kombinasyonu ayrı bir listeleme olabilirken Shopify'da tek üründe 20 varyant olarak durur. Bu durumda ürün seviyesinde toplama (aggregation) yapmak gerekir: aynı Shopify ürününe bağlı tüm varyantların yorumları birleştirilir, ama yorumun hangi varyanta ait olduğu bilgisi saklanır ki müşteri "L beden dar geldi" yorumunu bağlamıyla görebilsin.
3. Liquid'de varyant listesi sayfalanmaz. Ürün nesnesinin variants dizisi sayfalama olmadan en fazla 250 kayıt döner. Çok varyantlı kataloglarda eşleştirme mantığını tema tarafında değil, sunucu tarafında kurmak gerekir.

Sağlıklı bir modül, eşleşmeyen ürünler için mutlaka bir manuel eşleştirme ekranı sunar. Otomatik eşleşme oranı ne kadar yüksek olursa olsun, her katalogda elle bağlanması gereken bir kuyruk kalır.

Metafield mi, harici sunucu mu?

Yorum verisinin nerede duracağı, projenin en belirleyici mimari kararıdır. İki ana yaklaşım vardır.

Metafield yaklaşımı: Yorumlar (veya en azından ortalama puan ve yorum sayısı) Shopify metafield'larına yazılır, Liquid bunları sunucu tarafında render eder. Avantajı, içeriğin sayfa kaynağında görünmesi ve ek JavaScript gerektirmemesidir. Dezavantajı, veri hacmi ve senkron yüküdür: her yeni yorumda metafield güncellenmesi gerekir. Shopify dokümantasyonuna göre uygulama kapsamında sahip olunan tanım sayısı için sınır vardır (owner tipi başına 128 metafield tanımı), ayrıca tek bir deploy içinde 25'ten fazla metafield değişikliği yapılamaz. Bu yüzden metafield, özet veriyi (ortalama puan, yorum adedi, ilk birkaç yorum) tutmak için mükemmeldir; binlerce yorumun tam gövdesini tutmak için tasarlanmamıştır.

Harici sunucu yaklaşımı: Yorumlar modül sağlayıcısının veritabanında durur, ürün sayfasında istek yapılarak çekilir. Avantajı sınırsız hacim, gelişmiş filtreleme ve sayfalama; dezavantajı ise ek ağ isteği ve içeriğin JavaScript ile basılmasıdır. Bu yaklaşımda app proxy önemli bir araçtır: Shopify, mağaza alan adı altındaki /apps, /a, /community veya /tools öneklerinden birini (en fazla 30 karakterlik bir alt yol ile) sizin sunucunuza yönlendirir. Yanıtın başlığında Content-Type: application/liquid gönderirseniz Shopify, gövdedeki Liquid kodunu mağazanın kendi teması bağlamında render eder. Böylece harici veriyi çapraz alan adı sorunu olmadan ve tema stilleriyle uyumlu biçimde basabilirsiniz. Dikkat edilecek nokta: önek ve alt yol, uygulama kurulduktan sonra değiştirilemez; ayrıca Shopify güvenlik gereği Set-Cookie ve Server gibi bazı yanıt başlıklarını temizler.

Pratikte en dengeli kurgu melez olanıdır: özet puan ve ilk 5-10 yorum metafield ile sunucuda render edilir (SEO ve ilk görünüm için), gerisi kullanıcı "daha fazla yorum" dediğinde app proxy üzerinden yüklenir.

Adım adım kurulum

1. Trendyol tarafında veri disiplinini kurun

Trendyol mağazanızdaki ürünlerin barkod ve stok kodu alanlarının doldurulmuş ve tutarlı olduğundan emin olun. Eşleştirme kalitesi doğrudan bu iki alana bağlıdır. Trendyol'un satıcılara açtığı entegrasyon servisleri arasında ürün, sipariş, iade, fatura ve müşteri sorularını yönetme servisleri dokümante edilmiştir; ürün yorumlarını listeleyen dokümante edilmiş bir satıcı servisi ise aynı şekilde yayınlanmış değildir. Bu yüzden yorum tarafında çalışan çözümler farklı yollar izler ve seçtiğiniz sağlayıcıya verinin nereden geldiğini sormanız yerinde olur.

2. Shopify ürünlerinde barkod alanını doldurun

Shopify Admin > Ürünler ekranında ürünleri seçip toplu düzenleme görünümüne geçin, sütunlar arasına Barkod alanını ekleyin ve doldurun. 500 ürünlük bir katalogda bu iş yarım gün sürer; entegrasyon sonrası eşleşmeyen ürünleri tek tek düzeltmekten kat kat hızlıdır.

3. Modülü kurun ve mağazayı bağlayın

Uygulamayı kurduktan sonra Trendyol mağaza bilgilerinizi tanımlarsınız. Bu aşamada senkron sıklığını da belirlersiniz. Yorum verisi saatlik değişen bir veri değildir; günde bir kez tam senkron çoğu mağaza için fazlasıyla yeterlidir, kampanya dönemlerinde sıklık artırılabilir.

4. Eşleştirmeyi çalıştırın ve kuyruğu temizleyin

İlk eşleştirme turundan sonra modülün eşleştiremediği ürünlerin listesini alın. Bunları elle bağlayın. Bu adımı atlarsanız katalogun bir kısmı sessizce yorumsuz kalır ve bunu aylar sonra fark edersiniz.

5. Tema editöründe bloğu etkinleştirin

Shopify Admin > Online Store > Temalar > Özelleştir ekranını açın. App embed kullanıyorsanız sol alttaki Uygulama yerleşimleri (App embeds) sekmesinden ilgili anahtarı açın. App block kullanıyorsanız üstteki şablon seçicisinden Ürün şablonuna geçin, Blok ekle > Uygulamalar menüsünden yorum bloğunu ekleyin.

6. Konumu ve görünürlüğü ayarlayın

Yorum listesinin ürün açıklamasının altında, yıldız özetinin ise fiyatın hemen altında olması yaygın ve işe yarayan bir düzendir. Yıldız özetine tıklandığında yorum bölümüne kaydıran bir bağlantı ekleyin.

7. Tema stiliyle hizalayın

Yorum bloğunun yazı tipi, köşe yuvarlaklığı ve renkleri temanızla uyuşmuyorsa blok "yapıştırılmış" görünür ve güven kaybettirir. İyi modüller renk ve yazı tipi ayarlarını blok ayarlarından sunar; sunmuyorsa CSS ile hizalanması gerekir.

8. Moderasyon kurallarını belirleyin

Küfür, kişisel veri (isim-soyisim, telefon, sipariş numarası) ve rakip marka adı içeren yorumlar için filtre kurun. Ancak düşük puanlı yorumları toptan gizlemek hem etik hem itibar açısından yanlıştır; sadece 5 yıldızlı yorumların olduğu bir sayfa müşteride tam tersi etki yapar.

9. Yayın öncesi kontrol listesi

• Mobil görünümde yorum bloğu taşma yapıyor mu?
• Sayfa kaynağında (Ctrl+U) yorum metinleri görünüyor mu, yoksa tamamen JavaScript ile mi basılıyor?
• Blok yüklenirken sayfa zıplıyor mu (CLS)?
• Yorumsuz ürünlerde boş bir kutu mu kalıyor, yoksa blok tamamen gizleniyor mu?
• Yorum kaynağı (Trendyol) kullanıcıya açıkça belirtiliyor mu?

Core Web Vitals etkisi

Yorum bloğu, ürün sayfasının en altında duran ama en çok DOM ve JavaScript üreten bileşenlerden biridir. Üç metriği de etkileyebilir:

Somut eşikler açısından: Google'ın tanımına göre INP değeri 200 ms ve altı iyi, 200-500 ms arası geliştirilmeli, 500 ms üzeri kötü kabul edilir. Yorum bloğunuz eklendikten sonra ürün sayfanızın INP değerini ölçün; ölçmeden yorum yapmayın.

Pratik bir öneri: yorum listesini IntersectionObserver ile, kullanıcı bloğa yaklaştığında yükleyin. Ürün sayfasını açanların önemli bir kısmı yorum bölümüne hiç inmez; onlara hiç yüklememek en hızlı çözümdür. Shopify hız konusunun tamamı için Shopify mağaza hızlandırma rehberi yazısına bakabilirsiniz.

Çoklu dil ve çoklu para birimi mağazalarda davranış

Shopify Markets kullanan mağazalarda aynı ürün sayfası farklı dil ve ülke bağlamlarında açılır. Yorum bloğunun bu bağlamlarda ne yapacağı bilinçli bir karardır, kendiliğinden doğru olmaz.

• Arayüz metinleri: "Yorumlar", "Daha fazla göster", "Doğrulanmış alışveriş" gibi statik metinler theme app extension'ın locales/ klasöründeki çeviri dosyalarından gelmelidir. Shopify burada iki tip dosya ayırır: tema editöründe görünen ayar etiketleri için şema çevirileri, vitrinde görünen metinler için storefront çevirileri.
• Yorum gövdesi: Trendyol'dan gelen yorumlar Türkçedir. İngilizce bir vitrinde bunları otomatik çeviriyle basmak riskli bir tercihtir; makine çevirisi hataları yorumu anlamsızlaştırabilir. Sağlıklı yaklaşım, orijinal metni saklamak ve isteğe bağlı olarak "otomatik çevrildi" etiketiyle çeviriyi göstermektir. Kullanıcıya orijinali görme seçeneği bırakın.
• Tarih biçimi: Yorum tarihini sabit biçimde basmak yerine aktif dile göre biçimlendirin.
• Para birimi: Yorum metni genelde fiyat içermez, ancak "bu fiyata değer" tipi ifadeler bağlam kaybeder. Yorumun içine fiyat bilgisi enjekte etmeyin.
• Metafield çevirisi: Shopify'ın Translate & Adapt aracı tema metinlerini ve tanımlı bazı alanları çevirebilir; ancak yüksek hacimli, sürekli değişen yorum içeriği pratikte bu akışın dışında kalır. Çeviri kararını modül tarafında verin.

SEO ve schema: en sık yapılan hata

Burası dikkatli okunması gereken bölüm, çünkü piyasadaki birçok anlatım yanıltıcı.

Google'ın yapılandırılmış veri dokümantasyonundaki yorum snippet'i kurallarında açık bir madde var: başka sitelerden yorum veya puan toplayıp (aggregate) kendi sayfanızda işaretlemeyin. Google, işaretlenen yorumların sizin kendi kullanıcı tabanınızdan gelmesini bekler. Trendyol'dan aktarılan yorumları Shopify ürün sayfanızda Product şemasının aggregateRating alanına yazmak, bu maddeyle doğrudan çelişir.

Bu ne anlama gelir?

• Yorumları göstermek serbesttir ve değerlidir. Dönüşüm oranı, sayfada kalma süresi ve müşteri güveni için işe yarar. Kimse size "pazaryeri yorumunu siteme koyamaz mıyım" demiyor.
• Riskli olan, bu yorumları kendi yorumunuzmuş gibi schema'ya yazıp arama sonuçlarında yıldız çıkarmaya çalışmaktır. Google'ın manuel işlem uygulaması hâlinde kaybedilen sadece yıldızlar olmaz, sitenin genel güvenilirliği de etkilenebilir.
• Doğru kurgu şudur: Trendyol kaynaklı yorumları kaynağı açıkça belirtilerek gösterin, ancak aggregateRating hesabına yalnızca kendi sitenizde toplanan yorumları dahil edin. Modül her iki havuzu ayrı tutabilmelidir.
• Teknik ayrıntı: aggregateRating kullanıyorsanız ratingValue zorunludur ve ratingCount ya da reviewCount alanlarından en az biri bulunmalıdır. Ayrıca işaretlediğiniz yorum içeriğinin sayfada kullanıcıya görünür olması gerekir; gizli işaretleme kural ihlalidir.
• Not: Google'ın "kendi kendini değerlendirme" yasağı LocalBusiness ve Organization tipleri içindir; ürün, kitap, kurs gibi tipler bu kısıtın dışındadır. Yani sorun "kendi ürününüzü değerlendirmek" değil, başka siteden toplamak.

Shopify özelinde ek bir tuzak var: Dawn dahil birçok Online Store 2.0 teması ürün sayfasına zaten kendi Product JSON-LD çıktısını basar. Yorum modülü ikinci bir JSON-LD daha eklerse aynı sayfada çakışan iki ürün şeması oluşur. Kurulumdan sonra Google Rich Results Test ile sayfayı bir kez kontrol edin. Yorumların dönüşüm ve SEO tarafındaki etkisini ürün yorumlarının dönüşüm ve SEO etkisi yazısında ayrıca ele aldık.

Tema uyumu ve sık karşılaşılan sorunlar

Vintage tema kullanıyorsanız

App block, temanın JSON şablon kullanmasını ve ilgili bölümün @app blok tipini kabul etmesini gerektirir. 2021 öncesi yazılmış vintage temalarda bu yapı yoktur. Bu durumda ya app embed ile çalışırsınız (konumlandırma esnekliği azalır) ya da temayı Online Store 2.0 yapısına taşırsınız. İkincisi doğru yatırımdır, çünkü bugün Shopify ekosistemindeki uygulamaların çoğu bu yapıyı varsayar.

Özel (custom) tema kullanıyorsanız

Ajanslar tarafından sıfırdan yazılan temalarda ürün bölümünün şemasında @app bloğu unutulmuş olabilir. Bu tek satırlık bir eksikliktir ama uygulamanın blok listesinde görünmemesine yol açar. Tema geliştiricinizden ürün bölümünün blocks dizisine @app eklemesini isteyin.

Headless (Hydrogen) mağazalarda

Hydrogen veya başka bir headless kurulumda tema katmanı yoktur; dolayısıyla theme app extension da yoktur. Yorumların Storefront API üzerinden metafield olarak okunması veya modül sağlayıcısının API'sinin doğrudan tüketilmesi gerekir. Bu, ek geliştirme demektir ve teklif alırken açıkça belirtilmelidir.

Uygulama kaldırılırsa ne olur?

Bu, satın alma öncesi sorulması gereken en önemli sorudur. Yorumlar sağlayıcının sunucusundan basılıyorsa, abonelik bittiği gün ürün sayfalarınız yorumsuz kalır. Metafield tabanlı çözümlerde veri mağazanızda kalır ama basacak blok kalkar. İdeal olan, sağlayıcının size dışa aktarma (CSV/JSON) imkânı sunmasıdır.

Soru-cevap tarafını da unutmayın

Trendyol'da yorum kadar değerli ikinci veri kümesi müşteri sorularıdır. Beden, kargo süresi, malzeme gibi soruların cevapları çoğu zaman ürün açıklamasından daha fazla iş görür ve arama motorları için doğal uzun kuyruk içerik üretir. Shopify tarafında bu içerik de aynı theme app extension yapısıyla, ayrı bir blok olarak basılabilir. Detaylar için Trendyol soru-cevaplarını siteye aktarma yazısına bakın.

STools Digital yaklaşımı

STools Digital olarak Trendyol yorum modülünü Ikas, Shopify, Ticimax ve T-Soft altyapıları için geliştiriyoruz. Shopify tarafında izlediğimiz ilkeler şunlar: barkod ve stok kodu önceliğiyle eşleştirme, eşleşmeyenler için manuel eşleştirme ekranı, tema ayarlarından renk ve yazı tipi uyumu, görsellerde tembel yükleme ve blok için yükseklik rezervi, kaynak (Trendyol) etiketinin görünür tutulması. Modülün kapsamı ve kurulum detayları için Trendyol yorum modülü sayfasına, Shopify tema ve tasarım tarafındaki ihtiyaçlarınız için Shopify lisans ve tasarım hizmeti sayfasına bakabilirsiniz. Sorularınız için destek@stools.digital adresine yazabilirsiniz.

Son bir not: yorum aktarma, iyi bir ürün sayfasının yerini tutmaz. Fotoğrafları zayıf, beden tablosu olmayan, kargo süresi belirsiz bir sayfaya 400 yorum eklemek beklediğiniz farkı yaratmaz. Yorum, var olan güveni pekiştiren bir katmandır; güvenin kendisi değil.