Hepsiburada Yorum Modülü

Hepsiburada'da yıllardır satış yapan bir mağazanın en değerli ama en hareketsiz varlığı, o mağazanın ürün sayfalarında biriken müşteri değerlendirmeleridir. Aynı ürünü, aynı kutuda, aynı kargoyla kendi sitenizden de satarsınız; ama kendi ürün sayfanız sıfır yorum ve boş yıldızlarla açılır. Hepsiburada Yorum Modülü tam olarak bu boşluğu kapatır: pazaryerinde biriken sosyal kanıtı kendi vitrininize taşır.

Aşağıda modülün ne yaptığını, Hepsiburada entegrasyonunun Trendyol'dan hangi noktalarda ayrıldığını, ürün eşleştirmenin nasıl kurulduğunu, birden fazla pazaryerinden gelen yorumların tek ürün sayfasında nasıl dürüstçe birleştirildiğini ve kurulumun adımlarını anlatıyoruz. Pazarlama cümlesi yerine doğrulanabilir teknik ayrıntı bulacaksınız.

Hepsiburada Yorum Modülü ne yapar?

Modül dört katmandan oluşur ve her katman bağımsız çalışır:

• Katalog senkronu: Hepsiburada satıcı hesabınızdaki tüm ürünler (merchantSku, hbSku, barkod, ürün adı, görseller, statü) çekilip kendi veritabanınıza yazılır.
• Eşleştirme: Pazaryeri ürünü ile sitenizdeki ürün, kanonik bir ürün kimliği altında bağlanır. Otomatik eşleşmeyen kayıtlar manuel onay kuyruğuna düşer.
• Değerlendirme senkronu: Yıldız puanı, yorum metni, tarih ve varsa satıcı yanıtı artımlı olarak toplanır; mükerrer kayıt benzersiz kısıtla engellenir.
• Gösterim: Ürün sayfasına yerleşen yorum bloğu; kaynak rozeti, yıldız dağılımı, filtreleme ve sayfalama ile birlikte gelir.

Kritik tasarım kararı şu: veri her zaman sizin tarafınızda durur. Pazaryeri tarafında bir alan adı ya da yanıt şeması değişirse senkron durur, yayındaki yorumlar ayakta kalır. Yorumları doğrudan pazaryerinden çağıran istemci taraflı çözümler bu dayanıklılığa sahip değildir.

Hepsiburada entegrasyonu Trendyol'dan nerede ayrılır?

Trendyol modülünü kurmuş bir ekibin en sık yaptığı hata, aynı istemci kodunu Hepsiburada'ya uyarlamaya çalışmaktır. İki pazaryerinin protokolü birkaç temel noktada birbirinden ayrılır:

Zorunlu User-Agent tuzağı

Hepsiburada servisleri User-Agent başlığını zorunlu tutar ve bu başlıkta entegratör kullanıcı adınızın geçmesini bekler. Başlık boşsa ya da HTTP kütüphanenizin varsayılan imzasıysa, kullanıcı adı ve servis anahtarı doğru olsa bile 401 Unauthorized alırsınız. Entegrasyon kuran ekiplerin saatlerini yakan bir numaralı sebep budur; hata mesajı sizi şifreye yönlendirir, sorun ise başlıktadır.

Accept başlığı ve yanıt biçimi

Bazı uç noktalar Accept: application/json gönderilmediğinde XML döner. Yanıtı JSON varsayan bir ayrıştırıcı bu durumda anlamsız bir hata üretir. Modül tüm isteklerde bu başlığı sabitler.

Yorum verisinin kaynağı

Dürüst olmak gerekirse: Hepsiburada'nın satıcılara açtığı resmi entegrasyon başlıkları katalog, listeleme, sipariş ve Satıcıya Sor (soru-cevap) servisleridir. Ürün değerlendirmelerini çekmek için yayınlanmış bir satıcı uç noktası yoktur. Trendyol tarafında da durum aynıdır. Bu yüzden piyasadaki yorum modüllerinin tamamı gibi biz de değerlendirme verisini ürünün herkese açık pazaryeri kaynağından alır, resmi katalog API'sini ise ürün eşleştirmesi için kullanırız. Bu ayrımı bilerek ilerlemek, mimarinizi ve müşteriye verdiğiniz sözü doğru kurmanızı sağlar.

Ürün eşleştirme: projenin gerçekten pahalı kısmı

Ekipler genellikle veriyi çekmenin zor olduğunu sanır. Pratikte projeyi geciktiren neredeyse her zaman eşleştirmedir. Hepsiburada tarafında elinizde üç aday anahtar vardır ve üçü de tek başına yeterli değildir:

1. barcode: En güvenilir anahtardır, ancak her mağazada dolu değildir. Bazı hesaplarda barkod alanı sistem tarafından üretilmiş anlamsız bir değerle doldurulmuş olabilir; bu durumda barkod eşleşmesi sessizce yanlış sonuç üretir.
2. merchantSku: Sizin verdiğiniz stok kodudur ve genellikle kendi sitenizdeki ürün koduyla birebir aynıdır. Pratikte en yüksek isabetli anahtar budur.
3. hbSku: Hepsiburada'nın ürüne verdiği kimliktir. Kendi sitenizde karşılığı yoktur, ama pazaryeri tarafında değişmez bir referans olduğu için eşleşmeyi saklamak için idealdir.

Modül bu yüzden üç aşamalı ilerler: önce merchantSku, sonra barkod, en sonda manuel onay. Ürün adı benzerliğine göre otomatik eşleştirme yapılmaz. Kulağa pratik gelir ama sonucu, bir müşterinin yanlış ürünün altında alakasız bir yorum okumasıdır; bu, sıfır yorum göstermekten daha zararlıdır. Eşleşmeyen ürünler panelde bir kuyruğa düşer ve tek tıkla bağlanır.

Varyantlı ürünlerde ek bir karar vardır: pazaryerinde her renk ve beden çoğu zaman ayrı bir listing'dir, sitenizde ise tek üründür. Modül varsayılan olarak varyant yorumlarını ana üründe toplar ve yorumun ait olduğu varyantı yorum satırında belirtir. Böylece kırmızı ürünün altında sadece dört yorum yerine, tüm renklerin toplam sosyal kanıtı görünür.

Çoklu pazaryeri: tek ürün sayfasında Trendyol ve Hepsiburada

Aynı ürünü hem Trendyol'da hem Hepsiburada'da satan mağazalarda modül tek kanonik ürün katmanını paylaşır. Yani sitenizdeki bir ürüne birden fazla pazaryeri kaydı bağlanabilir ve yorumlar tek listede toplanır. Burada üç kural uygulanır:

• Kaynak rozeti zorunludur. Her yorumun yanında hangi pazaryerinden geldiği yazar. Kaynağı gizlemek, ziyaretçiye o yorumun kendi sitenizde alınmış doğrulanmış bir yorum olduğunu ima eder; bu hem güven hem mevzuat açısından yanlıştır.
• Ortalama doğru hesaplanır. İki pazaryerinin ortalamasının ortalaması alınmaz. Toplam puan, toplam yorum sayısına bölünür. 4,8 ortalamalı 400 yorum ile 4,2 ortalamalı 20 yorumun aritmetik ortalaması 4,5 çıkar; doğru sonuç 4,77'dir.
• Filtre kullanıcıda kalır. Ziyaretçi yorumları kaynağa, yıldıza ve tarihe göre filtreleyebilir. Yeni bir pazaryeri eklemek, mimariye yeni bir kaynak satırı eklemekten ibarettir.

Buybox mantığı nedeniyle pazaryerlerinde değerlendirmeler çoğu zaman satıcıya değil ürüne aittir. Yani aynı üründe başka bir satıcının teslimatına dair yorumlar da bulunabilir. Modül, kargo ve paketleme temalı yorumları ayrı bir sınıfta işaretler ve isterseniz gösterimden çıkarır; ürün özelliğine dair yorumlar ise doğrudan taşınır. Bu, hem daha dürüst hem de daha faydalı bir sonuç verir.

Moderasyon, KVKK ve içerik bütünlüğü

Modül yorumları olduğu gibi taşır; metni yeniden yazmaz, cilalamaz. Yapılan tek müdahale güvenlik ve mevzuat kaynaklıdır:

• Kişisel veri maskeleme senkron anında yapılır, gösterim anında değil. Yorum metnine yanlışlıkla yazılmış telefon numarası, adres parçası veya sipariş numarası veritabanına hiç ham girmez.
• Müşteri adı pazaryerinde göründüğü kısaltılmış haliyle kalır. Tam ad üretilmez, müşteri kimliği alanları saklanmaz.
• Spam ve anlamsız içerik filtresi tek karakterlik, tekrar eden veya bağlantı içeren yorumları otomatik olarak beklemeye alır.
• Yayın kararı sizde kalır. Otomatik yayın modunda tüm yorumlar doğrudan görünür; onaylı mod açıksa yeni yorumlar panelde kuyruğa düşer.

Bir uyarı: olumsuz yorumları toptan gizleme özelliği bilinçli olarak sunulmaz. Yalnızca beş yıldızlı yorum gösteren bir sayfa ziyaretçide güven değil şüphe yaratır ve ürün sayfasında kalma süresini düşürür. Doğru yaklaşım, olumsuz yorumun altına satıcı yanıtınızı basmaktır; modül Hepsiburada'da verdiğiniz satıcı yanıtlarını da taşır.

Senkron sıklığı ve sayfa performansı

Yorumlar dakikalık değişen bir veri değildir. Modülün varsayılanı günde bir kez artımlı senkrondur: yalnızca son çekim tarihinden sonraki kayıtlar alınır, tüm geçmiş her seferinde yeniden taranmaz. Yüksek hacimli mağazalarda sıklık günde birkaç keze çıkarılabilir. Katalog senkronu ürün sayısına göre sayfalanır ve eşzamanlılık bilinçli olarak düşük tutulur; Hepsiburada yayınlanmış bir hız limiti duyurmadığı için 429 ve 5xx yanıtlarında üstel geri çekilme uygulanır.

Gösterim tarafında iki ölçüt gözetilir. Birincisi, ilk yorumların sayfa HTML'i içinde yer alması; tamamen JavaScript ile sonradan yüklenen yorumları arama motorları ve AI tarayıcıları çoğu zaman görmez. İkincisi, yüzlerce yorumu tek seferde basmamak; blok sayfalanarak yüklenir, böylece Largest Contentful Paint metriğiniz bozulmaz. Modül görselleri tembel yükler ve yorum bloğunun kendi CSS'i sayfanın tema stilinden bağımsızdır.

Senkron sağlığı nasıl izlenir?

Sessizce bozulan bir senkron, hiç kurulmamış bir senkrondan daha tehlikelidir; çünkü sayfanız aylarca eski veriyle yayında kalır ve kimse fark etmez. Modül her çalıştırmanın sonucunu kaydeder: alınan yeni yorum sayısı, atlanan mükerrer kayıt sayısı, eşleşmeyen ürün sayısı ve alınan HTTP hata kodları. Arka arkaya iki çalıştırma sıfır yeni kayıtla ve hata koduyla sonuçlanırsa panelde uyarı üretilir. Servis anahtarı rotasyonu da bu şekilde yakalanır: satıcı panelinden yeni servis anahtarı oluşturduğunuzda eskisi geçersiz olur ve senkron 401 vermeye başlar; uyarı olmadan bunu haftalar sonra fark edersiniz.

Yorum bloğunda ziyaretçi tam olarak ne görür?

Modülün ürün sayfasına eklediği blok, tek bir yorum listesinden ibaret değildir. Standart kurulumda şu bileşenler gelir:

• Özet satırı: Ortalama puan, toplam yorum sayısı ve yorumların hangi kaynaklardan geldiği.
• Yıldız dağılımı: Beşten bire kaç yorum olduğunu gösteren çubuklar; tıklandığında listeyi o yıldıza filtreler.
• Kaynak rozeti: Her yorumun yanında pazaryeri adı. Ziyaretçi yorumun nereden geldiğini tahmin etmek zorunda kalmaz.
• Varyant etiketi: Yorumun hangi renk ya da bedene ait olduğu, varyantlı ürünlerde satır içinde belirtilir.
• Satıcı yanıtı: Pazaryerinde verdiğiniz cevap varsa yorumun altında ayrı bir blokta görünür.
• Sıralama ve sayfalama: En yeni, en yüksek puan ve en düşük puan seçenekleri; liste sayfalanarak yüklenir.

Blok kendi stil dosyasıyla gelir ve tema CSS'inden bağımsız çalışır, ancak ana renk ve köşe yarıçapı gibi değişkenler panelden düzenlenebildiği için tasarımınızın parçası gibi durur. Mobilde yıldız dağılımı katlanır, yorum kartları tek sütuna iner.

SEO tarafında sınırı doğru çizmek

Pazaryeri yorumlarını sayfada göstermek serbesttir ve içerik zenginliği açısından değerlidir. Ancak Google'ın değerlendirme snippet'i dokümantasyonu teknik kılavuzunda açık bir kural içerir: başka web sitelerinden toplanan yorum ve puanları birleştirip işaretlemeyin. Yani Hepsiburada'dan aldığınız yorumları kendi ürününüzün AggregateRating yapılandırılmış verisine dahil etmek politikayla çelişir.

Modülün varsayılan davranışı bu yüzden şudur: pazaryeri yorumları sayfada gösterilir, kaynak rozetiyle sunulur, ancak yapılandırılmış veri işaretlemesine dahil edilmez. Kendi sitenizde doğrulanmış müşteri yorumu topluyorsanız yalnızca onlar işaretlenir. SEO faydası yıldız rozetinden değil, ürün sayfasına eklenen gerçek kullanıcı dilinden, uzun kuyruk sorularının doğal karşılıklarından ve sayfada kalma süresindeki artıştan gelir. Bu konuyu ürün yorumlarının dönüşüm ve SEO etkisi yazısında ayrıntılı ele aldık.

Altyapıya göre kurulum farkları

Modül Ikas, Shopify, Ticimax ve T-Soft üzerinde çalışır. Veri katmanı dört altyapıda da aynıdır; değişen yalnızca gösterim tarafıdır:

• Shopify: Yorum bloğu tema bölümü olarak eklenir. Yorumlar metafield'a değil kendi sunucumuza yazılır; binlerce yorumda metafield yönetimi hem sınırlara hem bakım yüküne takılır.
• Ikas: Tema tarafına eklenen bir blokla gösterilir. Eşleştirmede ikas ürün kimliğini kanonik anahtar olarak kullanmak en temiz sonucu verir.
• Ticimax: Ürün detay şablonuna eklenen alan üzerinden çalışır; şablon düzenleme yetkisi gerekir.
• T-Soft: Ürün sayfası şablonuna eklenen alanla aynı mantıkta kurulur.

Dört altyapıda da kural aynıdır: veri bizim tarafımızda durur, tema yalnızca gösterir. Kurulum ortalama olarak yarım gün sürer ve büyük kısmı ilk katalog senkronunun tamamlanmasını beklemekle geçer.

Bu modül ne zaman gereksizdir?

Dürüst cevap: Hepsiburada'da toplam yorum sayınız üç haneli değilse, kazanç sınırlı kalır. Kırk yorumu bir siteye taşımak ölçülebilir bir dönüşüm farkı yaratmaz; bu durumda önce pazaryerinde yorum biriktirmeye ya da kendi sitenizde satın alma sonrası yorum talebi kurmaya odaklanmak daha mantıklıdır. Aynı şekilde ürün kataloğunuz pazaryerinde ve sitenizde birbirinden tamamen farklıysa (farklı setler, farklı paketler), eşleştirilebilir ürün oranı düşük olacağı için beklentiyi buna göre kurmak gerekir.

Kurulum öncesi hızlı bir ölçüm yapın: Hepsiburada'daki ürünlerinizin kaçının merchantSku değeri sitenizdeki ürün koduyla aynı? Bu oran yüzde yetmişin üzerindeyse eşleştirme büyük ölçüde otomatik tamamlanır ve kurulum aynı gün biter. Yüzde otuzun altındaysa manuel bağlama işi ciddi zaman alır; bu durumda önce pazaryeri stok kodlarınızı kendi sisteminizle hizalamak, modülü kurmaktan daha öncelikli bir iştir. Aynı hizalama ileride sipariş ve stok entegrasyonlarınızı da kolaylaştırır.

İlgili modüller ve kaynaklar

Aynı ürün sayfasında Trendyol değerlendirmelerini de birleştirmek isterseniz Trendyol Yorum Modülü aynı kanonik ürün katmanını paylaşır. Müşteri sorularını da taşımak için Trendyol Soru Cevap modülüne bakabilirsiniz. Konunun kendin yap tarafını merak ediyorsanız Hepsiburada yorumlarını siteye aktarma rehberi API ayrıntılarını ve hata kodlarını uçtan uca anlatıyor.