Trendyol Yorum Modülü

Trendyol'da yıllardır satış yapan bir mağazanın en değerli varlığı stok değil, biriken yorumlardır. Aynı ürünü kendi sitenizde de satıyorsanız o ürün Trendyol'da 800 yorum ve 4,7 puanla listelenirken, kendi sitenizde sıfır yorumla duruyordur. Trendyol Yorum Modülü tam olarak bu boşluğu kapatır: pazaryerinde kazandığınız sosyal kanıtı, kendi alan adınızda da görünür hale getirir.

Trendyol yorum modülü ne işe yarar?

Modül üç somut işi yapar. Birincisi, Trendyol Satıcı API'si üzerinden mağazanızın ürün kataloğunu çeker ve bu ürünleri kendi sitenizdeki ürünlerle eşleştirir. İkincisi, eşleşen her ürün için Trendyol'daki yorumları, yıldız puanlarını, müşteri fotoğraflarını ve puan dağılımını toplar. Üçüncüsü, bu veriyi ürün detay sayfanıza ve kategori/liste sayfalarınıza yerleştirir; ürün kartlarının altında yıldız ve yorum sayısı, ürün sayfasında ise filtrelenebilir tam yorum listesi görünür.

Kritik nokta şu: modül yorumları sizin mağazanıza ait olanlarla sınırlar. Trendyol'da bir ürün sayfası (içerik sayfası) birden fazla satıcı tarafından paylaşılır. Aynı sayfada sizin, rakibinizin ve Trendyol'un kendi satışının yorumları birlikte durur. Satıcı kimliği filtresi uygulanmazsa kendi sitenize rakibinizin yorumlarını taşımış olursunuz. Bu, elle kopyalamada ve basit kazıyıcı çözümlerde en sık yapılan hatadır.

Nasıl çalışır? Trendyol Satıcı API akışı

Modül, Trendyol'un iki ayrı uç noktasını birlikte kullanır. Ürün verisi için entegrasyon API'si, yorum verisi için Trendyol'un ürün değerlendirme servisi. Akış şöyle ilerler:

1. Satıcı kimlik doğrulaması

Trendyol Satıcı Paneli üzerinden oluşturduğunuz API Key ve API Secret, Base64 ile kodlanarak Basic yetkilendirme başlığına dönüştürülür. İsteklerde ayrıca satıcı numaranızı (supplier ID / merchant ID) içeren bir User-Agent gönderilir; Trendyol bu başlığı zorunlu tutar ve eksik gönderilen isteklerde yetkilendirme hatası döner.

2. Ürün kataloğunun çekilmesi

Ürünler /integration/product/sellers/{supplierId}/products uç noktasından sayfalanarak alınır. Trendyol sayfa başına en fazla 50 kayıt döndürür, bu yüzden 5.000 ürünlük bir katalog 100 sayfa demektir. Modül bu sayfaları paralel olarak, eşzamanlılık sınırı ve üstel geri çekilmeli yeniden deneme ile çeker; böylece büyük kataloglarda hız kaybı ve hız limiti hatası yaşanmaz. Sonraki senkronlarda tüm katalog yeniden taranmaz: dateQueryType=LAST_MODIFIED_DATE parametresiyle yalnızca son çalışmadan bu yana değişen ürünler istenir.

3. Ürünlerin içerik kimliğine bağlanması

Her Trendyol ürününün bir barkodu ve bir de içerik kimliği (contentId) vardır. Yorumlar barkoda değil, içerik kimliğine bağlıdır. Modül önce barkod üzerinden ürünü kendi kaydına yazar, ardından o ürünün içerik kimliğini saklar. Yorum çekimi bu kimlik üzerinden yapılır.

4. Yorumların toplanması

Her içerik kimliği için değerlendirme servisi, sayfa başına 20 yorum döndürecek şekilde ve son değişiklik tarihine göre azalan sırada sorgulanır. Dönen her yorum kaydında satıcı bilgisi bulunur; modül bu bilgiyi kendi satıcı numaranızla karşılaştırır ve eşleşmeyenleri atar. Bir sayfada size ait tek bir yorum bile çıkmıyorsa, sonraki sayfalarda da çıkmayacağı için tarama o üründe erken sonlandırılır. Bu detay, 10.000 yorumlu popüler bir içerik sayfasında senkron süresini dakikalar mertebesinden saniyelere indirir.

5. Veritabanına yazım ve tekrar engelleme

Yorumlar, satıcı numarası ve Trendyol yorum kimliğinden oluşan bileşik bir tekillik kuralıyla kaydedilir. Aynı yorum ikinci kez geldiğinde yeni satır açılmaz; yalnızca son değişiklik zaman damgası farklıysa güncellenir, aynıysa hiç dokunulmaz. Sonuç olarak modül günde birkaç kez çalışsa bile aynı yorum sitenizde ikinci kez görünmez ve veritabanı gereksiz yazma yükü almaz.

6. Sitede gösterim

Veri hazır olduğunda, sitenize eklediğiniz tek satırlık script ürün sayfası yüklendikten sonra ilgili ürünün yorumlarını API'den ister ve sayfaya yerleştirir. Puan dağılımı, fotoğraflı yorum filtresi, yıldıza göre filtreleme ve sayfalama bu katmanda çalışır.

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

Yorum çekmek teknik olarak kolay taraf. Projelerin tıkandığı yer neredeyse her zaman eşleştirmedir. Trendyol'daki ürün ile sitenizdeki ürünün aynı ürün olduğunu kanıtlayacak ortak bir anahtara ihtiyacınız var.

Barkod birincil anahtardır. Trendyol her varyant için tekil barkod ister; sitenizde de barkod alanı doluysa eşleştirme neredeyse hatasız çalışır. Barkod boşsa sırasıyla stok kodu (stockCode), model kodu (productMainId) ve ürün kodu (productCode) yedek anahtar olarak denenir. Hiçbiri yoksa geriye ürün adı üzerinden bulanık eşleştirme kalır ki bu, yanlış ürüne yorum bağlama riski taşıdığı için otomatik değil, onaylı çalıştırılmalıdır.

Varyantlı ürünlerde davranış farklıdır. Bir tişörtün S, M, L bedenleri Trendyol'da üç ayrı barkoddur ama tek bir içerik kimliğini paylaşır. Yorumlar da içerik kimliği seviyesinde tutulduğu için beden bazında ayrışmaz. Doğru yaklaşım, üç varyantı da aynı içerik kimliğine bağlayıp yorumları ana ürün sayfasında birleşik göstermektir. Yorumları beden başına bölmeye çalışmak yapay olarak seyrekleşmiş, ikna gücü düşük bir liste üretir.

Set ve paket ürünler ayrı bir dert. Trendyol'da 3'lü paket olarak sattığınız ürünü sitenizde tekli satıyorsanız bunlar farklı ürünlerdir ve barkodları da farklıdır. Otomatik eşleşme kurulmaz. Burada iki seçenek vardır: ya set ürününü sitenizde de ayrı ürün olarak açarsınız, ya da panelden manuel eşleştirme tanımlayarak tekli ürünün sayfasında paket yorumlarını gösterirsiniz. İkinci yol yorum sayısını artırır ama yorumların bir kısmı "paket halinde geldi" gibi bağlamla ilgili olacağından müşteri kafası karışabilir. Kararı ürün bazında vermek gerekir.

Aynı ürünün birden çok Trendyol kaydı varsa (zamanla açılmış mükerrer listeler), yorumlar bölünmüş demektir. Modül birden fazla içerik kimliğini tek site ürününe bağlayabilir; bu sayede dağılmış yorumlar tek listede toplanır.

Senkron sıklığı ve veri tazeliği

Senkron zamanlanmış görev olarak çalışır ve mağaza büyüklüğüne göre ayarlanır. Tipik kurulumda ürün kataloğu ve yorumlar günde bir kez taranır; yorum hacmi yüksek, günde onlarca yeni yorum alan mağazalarda sıklık artırılır. Artımlı çalıştığı için sıklığı yükseltmenin maliyeti düşüktür: ikinci ve sonraki çalıştırmalarda yalnızca değişen ürünler ve yeni yorumlar işlenir.

Beklentiyi doğru kurmakta fayda var: bu bir anlık yansıtma değildir. Müşteriniz Trendyol'a yorum yazdığında yorum önce Trendyol'un moderasyonundan geçer, yayına alınır, ardından ilk senkronda sitenize gelir. Uçtan uca gecikme genellikle bir günü bulur.

Görsel, puan ve dağılım aktarımı

Fotoğraflı yorumlar dönüşüm açısından metin yorumlardan daha etkilidir, bu yüzden modül medya dosyalarını da taşır. Her yorumun görselleri için tam boy adres, küçük önizleme adresi ve medya tipi saklanır. Görseller Trendyol'un kendi görsel ağı üzerinden servis edilir; kendi sunucunuza kopyalanmadığı için depolama ve bant genişliği maliyeti oluşturmaz.

Puan tarafında ayrım önemlidir. Trendyol'un döndürdüğü ortalama puan ve yıldız dağılımı o içerik sayfasındaki tüm satıcıların toplamıdır. Sizin yorumlarınızın sayısı ise satıcı filtresinden geçmiş, yalnızca size ait olan kümedir. Modül bu iki değeri ayrı ayrı saklar. Sitenizde 4,7 ortalama ve 800 değerlendirme gösterip yorum listesinde 120 yorum listelemek tutarsız görünür; doğru olan, gösterdiğiniz sayının aktardığınız yorum kümesiyle uyumlu olmasıdır. Yıldız bazlı filtre sayaçları ve fotoğraflı yorum sayaçları da bu nedenle kendi verinizden hesaplanır.

Platform bazlı kurulum farkları

Dört altyapının da script yerleştirme mantığı farklıdır. Modül her biri için ayrı derlenmiş bir istemci dosyası kullanır.

Ortak nokta, script'in yorumları nereye basacağını belirleyen CSS seçicisidir. Varsayılan seçiciler yaygın temalar için çalışır; özel tasarlanmış temalarda yerleşim noktası kurulum sırasında tanımlanır. Kategori sayfasındaki ürün kartlarına yıldız eklenmesi de aynı mantıkla, kart seçicisi üzerinden yapılır.

Sayfa hızına etkisi

Yorum modülleri kötü yazıldığında sayfa hızını gerçekten düşürür. Bu modülde etkiyi sınırlayan birkaç tercih var: istemci dosyası saf JavaScript ile yazılmıştır, jQuery veya herhangi bir arayüz kütüphanesi yüklemez; tek dosya olarak CDN üzerinden sıkıştırılmış servis edilir; ve sayfanın ilk boyaması tamamlandıktan sonra çalışır, yani sayfanın açılmasını bloklamaz.

Yorumlar ilk açılışta tamamı değil, ilk 10 tanesi çekilir; devamı kullanıcı istedikçe sayfalanır. Fotoğraflar geç yükleme ile gelir. Pratikte ölçülebilir etki, ürün sayfasında birkaç yüz milisaniyelik ek istek süresidir ve bu istek ana içerik göründükten sonra gerçekleştiği için Largest Contentful Paint değerini doğrudan etkilemez. Sayfa hızı sizin için kritikse Shopify mağaza hızlandırma rehberi yazısındaki ölçüm yöntemiyle kurulum öncesi ve sonrası karşılaştırma yapmanızı öneririz.

Yorum schema'sında kritik uyarı

Bu konuda sektörde çok yanlış bilgi dolaşıyor, net olalım. Google'ın yapılandırılmış veri kurallarında yorum zengin sonuçları için açık bir madde var: başka sitelerden toplanan yorum veya puanların işaretlenmemesi gerekir. Trendyol'dan aktardığınız yorumları kendi sitenizde AggregateRating veya Review şemasıyla işaretleyip arama sonuçlarında yıldız çıkarmayı ummak, doğrudan bu kuralın ihlalidir. Kısa vadede yıldız görünebilir, ancak manuel işlem riski taşır.

Doğru yaklaşım şudur: aktarılan Trendyol yorumları kullanıcıya gösterilir, sosyal kanıt görevini görür, sayfada gerçek metin içeriği oluşturur ve dolaylı SEO faydası sağlar; ancak yıldız zengin sonucu için işaretlenmez. Kendi sitenizde topladığınız yorumlar ise işaretlenebilir. İki kaynağı ayrı tutmak, hem kurallara uygun kalmanızı hem de zamanla kendi yorum havuzunuzu büyütmenizi sağlar. Konunun dönüşüme etkisi tarafını ürün yorumlarının dönüşüm ve SEO etkisi yazısında ayrıntılı ele aldık.

KVKK ve anonimleştirme

Yorumlar kişisel veri içerebilir. İyi haber, Trendyol müşteri adlarını kaynakta zaten maskeleyerek döndürür; tam ad yerine kısaltılmış biçim gelir. Modül bu maskeli veriyi olduğu gibi taşır, orijinal ada erişmez ve saklamaz. Ad bilgisi eksik gelen kayıtlarda tamamen anonim gösterim yapılır.

Yine de sorumluluk sizde: aktardığınız yorumların kaynağını sayfada açıkça belirtmek doğru olan yaklaşımdır. Yorum bloğunun başına Trendyol mağazanızdan aktarıldığını yazan bir ibare koymak hem şeffaflık sağlar hem de kullanıcı güvenini artırır. Ayrıca gizlilik politikanızda pazaryeri kaynaklı yorum verisi işlediğinizi belirtmeniz gerekir. Modül, talep halinde tekil yorumları gizleme imkânı sunar; bir müşteri yorumunun sitenizden kaldırılmasını isterse o kayıt senkronda tekrar geri gelmeyecek şekilde işaretlenebilir.

Elle kopyalama, hazır modül ve özel geliştirme karşılaştırması

Üç yol da uygulanabilir. Seçim, ürün sayınıza ve yorum hacminizin ne hızla büyüdüğüne bağlıdır.

Özel geliştirmede en sık atlanan kalem bakımdır. Trendyol'un uç noktaları ve yanıt alanları zaman içinde değişir; kendi kodunuzu yazdıysanız her değişiklikte müdahale etmeniz gerekir. Elle kopyalamada ise asıl sorun süre değil, verinin donmasıdır: altı ay sonra Trendyol'da 400 yorumunuz varken sitenizde hâlâ ilk kopyaladığınız 60 yorum durur.

Sık karşılaşılan sorunlar ve çözümleri

• Yorumlar hiç gelmiyor. Çoğunlukla API yetkilendirmesi kaynaklıdır. API Key/Secret çiftinin doğru kodlandığını ve satıcı numarasını içeren User-Agent başlığının gönderildiğini kontrol edin; Trendyol bu başlık olmadan yetkilendirme hatası döner.
• Ürünler eşleşmiyor. Sitenizdeki barkod alanı boştur veya Trendyol'daki barkoddan farklıdır. Önce eşleşmeyen ürünlerin listesini alıp barkodları düzeltmek, sonra tam senkron çalıştırmak en hızlı yoldur.
• Rakip yorumları görünüyor. Satıcı filtresi devrede değildir. Aynı içerik sayfasını paylaşan diğer satıcıların yorumları ayıklanmalıdır.
• Yorum sayısı ile ortalama puan uyuşmuyor. Ortalama puan tüm satıcıların, yorum listesi sizin. Gösterimde hangi sayının kullanılacağı kurulumda netleştirilmelidir.
• Yorumlar sayfada yanlış yere basılıyor. Tema seçicisi tutmamıştır. Ürün detay şablonundaki hedef elemanın seçicisi güncellenmelidir.
• Tema güncellemesinden sonra yorumlar kayboldu. Shopify ve T-Soft tarafında tema dosyasına eklenen script güncellemede silinmiş olabilir; script tekrar eklenmelidir.
• Aynı yorum iki kez görünüyor. Aynı ürünü birden fazla içerik kimliğine bağladıysanız ve o kimlikler aynı yorum havuzunu paylaşıyorsa oluşur. Eşleştirme tablosu gözden geçirilmelidir.
• Çok yavaş senkron. Katalog büyükse ilk tam tarama uzun sürer, bu normaldir. Sonraki çalıştırmalar artımlı olduğu için belirgin biçimde kısalır.

Yorumdan sonrası: soru-cevap ve diğer pazaryerleri

Trendyol ürün sayfalarında yorumların yanında bir de alıcı soruları ve satıcı cevapları birikir. Bu içerik çoğu zaman yorumlardan daha satın alma odaklıdır, çünkü müşteri tam olarak tereddüt ettiği noktayı sorar. Aynı mantıkla siteye aktarılabilir; ayrıntılar Trendyol soru-cevaplarını siteye aktarma yazısında. Birden fazla pazaryerinde satış yapıyorsanız Hepsiburada yorumlarının aktarımı da benzer bir eşleştirme mantığıyla çalışır. Trendyol tarafındaki yorum ve soruları yönetme pratikleri için cevaplama rehberimize göz atabilirsiniz.

Teknik ayrıntıların tamamını, yöntem karşılaştırmalarını ve uygulama notlarını Trendyol yorumlarını siteye aktarma teknik rehberinde bulabilirsiniz.