Ticimax Trendyol Yorum Aktarma: Tema Yönetimi, Barkod Eşleştirme ve Kurulum Rehberi

Ticimax kullanan bir mağazanın en sık yaşadığı çelişki şudur: Trendyol mağazanızda bir ürünün yüzlerce yorumu ve dört buçuğun üzerinde puanı vardır, aynı ürün kendi Ticimax sitenizde tek yorumsuz durur. Kendi sitenizde komisyon ödemediğiniz için genellikle daha iyi fiyat verirsiniz, ama ziyaretçi tereddüt eder çünkü sosyal kanıt yoktur.

Bu yazı, Trendyol yorumlarını Ticimax sitenize aktarmanın Ticimax'e özgü tarafını anlatıyor. Genel yorum entegrasyonu prensiplerini Trendyol yorumlarını siteye aktarma rehberinde zaten ele almıştık; burada odak, panelde kodu nereye ekleyeceğiniz, Ticimax ürün detay sayfasının HTML yapısında hangi alanın eşleştirme anahtarı olduğu, varyasyon değişiminde bloğun neden boş kaldığı ve Ticimax SOAP web servisiyle çalışırken sessizce başarısız olan filtrelerdir.

Ticimax trendyol yorum aktarma nedir?

Ticimax trendyol yorum aktarma; Trendyol mağazanıza ait ürün değerlendirmelerinin (yıldız puanı, yorum metni, tarih, müşteri fotoğrafı, varsa satıcı yanıtı) düzenli aralıklarla toplanıp, Ticimax altyapısındaki sitenizde karşılık gelen ürün sayfasında gösterilmesidir. Üç bileşeni vardır:

1. Toplama: Verinin Trendyol tarafından alınıp kendi veritabanınıza yazılması.
2. Eşleştirme: Trendyol ürününün, Ticimax kataloğunuzdaki hangi ürüne ve hangi varyasyona karşılık geldiğinin belirlenmesi.
3. Gösterim: Yorumların Ticimax ürün detay sayfasına, kaynağı belli olacak şekilde ve sayfa hızını bozmadan yerleştirilmesi.

Ticimax'te ilk ve üçüncü adım nispeten standarttır. Projeyi geciktiren neredeyse her zaman ikinci adımdır ve Ticimax'te bunun tek pratik anahtarı barkod alanıdır.

Ticimax kapalı kaynak bir altyapıdır: bunun anlamı ne?

Shopify'da Liquid şablonlarına, Ikas'ta tema dosyalarına dosya düzeyinde erişebilirsiniz. Ticimax ise barındırılan (SaaS) ve kapalı kaynak bir altyapıdır: sunucudaki şablon dosyalarına FTP ile girip .html düzenleyemezsiniz. Panel size üç tür müdahale alanı bırakır:

• Görsel tasarım ayarları: Renk, yazı tipi, blok gösterim seçenekleri. Kod bilgisi gerektirmez.
• Tema CSS ve JavaScript alanları: Panelde Tasarım menüsü altındaki Tema Yönetimi sayfasından mevcut temaların CSS ve JavaScript kodlarına erişilir. Modül kurulumları buradan yapılır.
• Editör / HTML alanları: Dinamik sayfalar ve bazı içerik bloklarında HTML girebileceğiniz alanlar. Ürün detayının çekirdek şablonunu buradan değiştiremezsiniz.

Bu kısıt, mimariyi doğrudan belirler: Ticimax'te yorum bloğu sunucu tarafında basılamaz, istemci tarafında JavaScript ile eklenir. Yani blok, sayfa yüklendikten sonra DOM'a enjekte edilir. Bunun SEO tarafındaki sonucunu yazının ilerleyen bölümünde ayrıca ele alıyoruz, çünkü çoğu rehber bu noktayı atlıyor.

Ticimax panelinde özel kod alanı tam olarak nerede?

1. Tasarım > Tema Yönetimi

Yönetim panelinde Tasarım menüsü altındaki Tema Yönetimi sayfası, sistemdeki temaların CSS ve JavaScript kodlarına erişim sağlar. Yorum modülünün tek satırlık script etiketi buraya, temanın JavaScript alanına eklenir. Ticimax'in kendi dokümantasyonu ve konuyla ilgilenen ajanslar bu alan için aynı uyarıyı yapar: yanlış bir kod satırı sitenin çalışmamasına yol açabilir, bu alana hakim değilseniz yalnızca görsel düzenleme ayarlarını kullanın.

2. Önce temayı kopyalayın

Bu, kurulumun en önemli ve en çok atlanan adımıdır. Tema Yönetimi sayfasında Yeni Ekle diyerek mevcut temanın bir kopyasını oluşturun ve değişikliği kopya üzerinde yapın. Bir hata durumunda saniyeler içinde orijinal temaya dönebilirsiniz. Canlı temada doğrudan çalışmak, en iyi ihtimalle stresli bir akşam demektir.

3. Script etiketini nereye koymalı?

Yorum bloğu ürün detayının DOM'una müdahale ettiği için script'in sayfa içeriği hazır olduktan sonra çalışması gerekir. İyi yazılmış bir modül scripti bunu kendisi halleder (document.readyState kontrolü ve DOMContentLoaded beklemesi ile), fakat yine de defer özniteliğiyle eklemek en güvenlisidir:

Kural: yorum scripti render engelleyici olmamalı. Senkron yüklenen bir script, ürün detay sayfanızın ilk boyanma süresini doğrudan geciktirir.

4. Panel sürümüne göre isimlendirme değişebilir

Ticimax panelinde menü adlandırmaları ve alanların yerleşimi paket ile sürüme göre farklılık gösterebilir. Bazı kurulumlarda Tema Yönetimi doğrudan Tasarım altında, bazılarında tasarım ayarları içinde bir alt sekmede bulunur. Panelinizde göremiyorsanız, alanın paketinize açık olup olmadığını Ticimax destek ekibine sormak en hızlı yoldur; ajans erişimiyle çözülmeye çalışılan sorunların bir kısmı aslında yetki sorunudur.

Ticimax ürün detay sayfasının yapısı ve eşleştirme anahtarı

Ticimax temalarının ürün detay sayfası, sürümler arasında görsel olarak çok farklı görünse de belirli kimlik ve sınıf adlarını büyük ölçüde korur. Yorum modülünün ürünü tanıyabilmesi ve bloğu doğru yere yerleştirebilmesi için bu alanlara ihtiyacı vardır. Aşağıdaki tablo, STools Trendyol Yorum Modülünün Ticimax sürümünde fiilen kullandığı seçicileri gösterir:

Buradaki kritik satır ilkidir. Ticimax ürün detayında barkod, divBarkod kimlikli kapsayıcının içindeki spnBarkod alanında yayınlanır. Modül bu değeri okur ve Trendyol tarafındaki barkodla eşleştirir.

En sık yaşanan sorun: barkod alanı kapalı

Kurulum sonrası "script ekledim ama hiçbir şey görünmüyor" şikayetlerinin büyük çoğunluğunun tek bir sebebi vardır: ürün detay sayfasında barkod alanı gösterilmiyordur.

Ticimax'te ürün detayında hangi bilgilerin görüneceği tema ve ürün detay ayarlarından yönetilir. Barkod gösterimi kapatıldığında ilgili alan sayfaya hiç basılmaz; yani #spnBarkod DOM'da yoktur. Script barkodu okuyamayınca ürünü tanıyamaz, ürünü tanıyamayınca yorum çekemez ve blok görünmez. Ekranda hata da çıkmaz, çünkü teknik olarak bir hata oluşmamıştır.

Çözüm sırası:

1. Ürün detay ayarlarında barkod alanının gösterimini açın.
2. Ürün kartlarında barkodun dolu olduğundan emin olun. Alan açık ama değer boşsa sonuç aynıdır.
3. Barkodun görünmesini estetik olarak istemiyorsanız alanı kaldırmayın; temanın CSS alanından #divBarkod { display:none } ile gizleyin. Böylece değer DOM'da kalır, script okumaya devam eder.
4. Ürün sayfasında tarayıcı konsolunu açıp document.querySelector('#spnBarkod') yazın. null dönüyorsa sorun kesinlikle buradadır.

Üçüncü madde, sahada en çok işe yarayan pratik hiledir: barkodu müşteriye göstermek istemeyen mağazalar alanı kapatıp modülü çalışmaz hale getirir. Gizlemek ile kapatmak aynı şey değildir.

Varyasyon değişince yorumlar neden kayboluyor?

Ticimax'te renk veya beden seçildiğinde sayfa çoğu zaman yeniden yüklenmez; ürün detayındaki alanlar (fiyat, stok ve barkod) yerinde güncellenir. Sayfa açıldığında barkodu bir kez okuyup bırakan bir script, varyasyon değiştiğinde eski ürünün yorumlarını göstermeye devam eder ya da blok boşalır.

Doğru davranış, barkod alanını sürekli izlemektir. STools tarafında bu, #divBarkod kapsayıcısına bağlanan bir MutationObserver ile yapılır; gözlemci kurulamadığı durumlar için saniyede bir çalışan bir yedek kontrol devreye girer. Barkod değeri değiştiği anda yorumlar sıfırlanıp yeni varyasyon için tekrar çekilir.

Burada bir tasarım kararı da vermeniz gerekir: yorumlar varyasyon düzeyinde mi, ürün düzeyinde mi gösterilecek? Trendyol'da her renk ayrı bir barkoda karşılık geldiği için varyasyon bazlı gösterim teknik olarak daha kolaydır, ama yeni eklediğiniz renk sıfır yorumla kalır. Çoğu mağaza için doğru kurgu, yorumları ürün düzeyinde toplayıp varyasyon bilgisini yorumun içinde etiket olarak göstermektir.

Ticimax kataloğunu web servisle çekmek: bilmeniz gereken tuzaklar

Yorum eşleştirmesini tek tek elle yapmak yerine, Ticimax kataloğunuzu toplu olarak çekip Trendyol ürünlerinizle otomatik eşleştirmek isteyebilirsiniz. Ticimax bunun için SOAP tabanlı web servisleri sunar. Panelde web servis kullanıcı bilgisi (üye kodu) tanımlandıktan sonra UrunServis.svc üzerindeki SelectUrun metodu ile ürün kartlarını sayfalayarak çekebilirsiniz.

Bu servislerle çalışırken sahada doğruladığımız, dokümanlarda kolayca göremeyeceğiniz tuzaklar şunlardır:

1. Filtre alanlarının sırası alfabetik olmak zorundadır

Servis WCF üzerinde çalışır ve veri sözleşmesi alanlarını alfabetik sırada bekler. Sırayı bozarsanız hata almazsınız; bozulan alandan sonraki tüm filtreler sessizce yok sayılır. Örneğin ürün filtresinde doğru sıra Aktif, Firsat, Indirimli, KategoriID, MarkaID, UrunKartiID, Vitrin şeklindedir. Vitrin alanını KategoriID öncesine koyarsanız kategori, marka ve ürün kartı filtreleri hiç uygulanmaz; servis yine 200 döner ve siz filtrenin çalıştığını sanırsınız. Bu, entegrasyonda saatlerce sürebilen ve teşhisi en zor hatalardan biridir.

2. Tek kayıt obje, çok kayıt dizi döner

Sorgu tek ürün döndürdüğünde XML çözümleyicisi size bir nesne, birden fazla ürün döndüğünde dizi verir. Kodunuzda daima diziye normalize eden bir yardımcı fonksiyon kullanın; aksi halde tek sonuçlu senkronlar beklenmedik şekilde çöker.

3. Mantıksal alanlar metin olarak gelir

Aktiflik gibi alanlar true / false değerlerini metin olarak taşır. JavaScript tarafında Boolean(deger) yazarsanız "false" metni de doğru sonucunu verir ve pasif ürünleri aktif sanırsınız. Metin karşılaştırması yapın.

4. Delta senkron için stok güncelleme tarihini kullanın

Her turda tüm kataloğu çekmek yerine, varyasyon servisinde stok güncelleme tarihi başlangıcı parametresiyle yalnızca değişenleri alabilirsiniz. Tarih formatı milisaniyesiz ISO biçimindedir (örnek: 2026-07-23T15:00:00). Güvenlik payını abartmayın; doksan saniyelik örtüşme yeterlidir, daha genişi aynı ürünleri her turda gereksiz yere tazeler.

5. Her metot aynı kimlik parametresini almaz

Ürün, sipariş ve üye servislerinde üye kodu parametresi beklenirken bazı metotlar bunu almaz ve gönderdiğinizde SOAP 500 hatası döner. Kod yazmadan önce servisin WSDL çıktısını çekip ilgili metodun alanlarını doğrulamak, deneme yanılmadan çok daha hızlıdır.

Ticimax'te eşleştirme anahtarı seçimi

Hangi alanı ana anahtar yapacağınız, projenin sonraki altı ayını belirler. Ticimax tarafındaki seçenekler ve pratik değerlendirmeleri:

Pratik kural: barkodu birincil, stok kodunu ikincil anahtar yapın; ikisi de tutmayan ürünleri otomatik eşleştirmeye zorlamak yerine panelde manuel onay kuyruğuna alın. Otomatik eşleşme oranı hiçbir projede yüzde yüz olmaz. Kalan kuyruğu bir insanın yirmi dakikada temizleyebileceği bir ekran, aylarca uğraşacağınız bir benzerlik algoritmasından daha değerlidir.

Ticimax ile diğer altyapılar arasındaki kurulum farkları

Aynı modülü birden fazla altyapıda kullanacaksanız farkları baştan bilmek işinizi kolaylaştırır:

Özetle: Ticimax'te esneklik daha az, ama kurulum daha kısa. Tema dosyalarıyla uğraşmadığınız için modül kurulumu tek bir script satırına iner; buna karşılık sunucu tarafında içerik basamadığınız için SEO tarafında farklı bir strateji izlemeniz gerekir.

SEO tarafı: iki ayrı konuyu karıştırmayın

Yorum modülü satan pek çok sayfa "Google'da yıldız kazanın" vaat eder. Burada iki ayrı konu var ve ikisinin cevabı farklı.

Yıldızlı sonuç (yapılandırılmış veri)

Google'ın değerlendirme snippet'i politikası, başka sitelerden toplanan yorum ve puanların işaretlenmemesi gerektiğini söyler. Yani Trendyol'dan aldığınız dört yüz yorumu kendi ürününüzün toplu puan işaretlemesine dahil etmek politikayla çelişir; zengin sonuç kaybına ya da manuel işleme yol açabilir. Doğru kurgu: pazaryeri yorumlarını sayfada gösterin, ancak yapılandırılmış veriye dahil etmeyin. Kendi sitenizde doğrulanmış müşteri yorumu toplamaya ayrıca başlayın ve yalnızca onları işaretleyin.

İçerik olarak taranabilirlik

Ticimax'te blok JavaScript ile eklendiği için yorum metinleri sayfanın ilk HTML çıktısında yer almaz. Google modern tarayıcı motoruyla JavaScript'i büyük ölçüde işleyebilir; ancak bu işlem gecikmeli ve garantisizdir. Yapay zekâ tabanlı tarayıcıların önemli bir kısmı ise JavaScript'i hiç çalıştırmaz, yalnızca ham HTML'i okur. Sonuç: Ticimax'te aktarılan yorumlar, kendi sitenizde toplanan yorumlar kadar güçlü bir içerik sinyali üretmez.

Bu, aktarmanın anlamsız olduğu anlamına gelmez. Yorumların asıl işi arama motoruna sinyal vermek değil, sayfaya gelen ziyaretçiyi ikna etmektir. Dönüşüm etkisini ürün yorumlarının dönüşüm ve SEO etkisi yazısında ayrıca ele aldık. Buna karşılık üç şeyi yapabilirsiniz:

• Ürün açıklamasına, yorumlarda tekrar eden gerçek soruların cevaplarını elle ekleyin. Bu metin ham HTML'de yer alır.
• Toplam puan ve yorum sayısını sayfa metninde de geçirin.
• Trendyol soru-cevaplarını da taşıyorsanız, sık sorulan soruları ürün açıklamasında ayrıca özetleyin. Soru-cevap aktarımının teknik tarafını ayrı yazıda anlattık.

Sayfa hızı: Ticimax'te dikkat edilmesi gerekenler

Ticimax temaları genellikle jQuery ve birden fazla eklenti barındırır. Buna bir de ağır bir yorum bloğu eklerseniz mobil skorunuz düşer. Kurulumda uyulması gereken kurallar:

• Script'i defer ile yükleyin. Render engelleyici bir script, ilk boyanma süresini doğrudan geciktirir.
• Blokta ilk on yorumu gösterin, kalanını "daha fazla göster" ile çekin. Dört yüz yorumu tek seferde DOM'a basmak mobilde fark edilir bir donma yaratır.
• Görselleri tembel yükleyin. Müşteri fotoğrafları yorum modülünün en ağır kısmıdır; ilk birkaç görsel öncelikli, kalanı boşta kalan sürede yüklenmelidir.
• Görselleri boyutlandırılmış çekin. Trendyol'un görsel dağıtım ağı yeniden boyutlandırmayı destekler; orijinal boyutlu fotoğrafları çekmek gereksiz megabaytlar demektir.
• Yorumsuz ürünlerde bloğu tamamen gizleyin. Boş bir kutu, hiç kutu olmamasından daha kötüdür.
• Kategori sayfasındaki yıldızları toplu çekin. Listede kırk ürün varsa kırk ayrı istek atmayın; ürünleri gruplayıp tek istekte alın ve tarayıcı tarafında kısa süreli önbellekleyin.

Hız konusunun tamamı için mağaza hızlandırma rehberimizdeki prensiplerin çoğu Ticimax için de geçerlidir.

Adım adım kurulum kontrol listesi

1. Trendyol satıcı hesabınızdaki mağaza bilgisini ve ürün listenizi hazırlayın.
2. Ticimax panelinde Tasarım > Tema Yönetimi sayfasına girin ve mevcut temanın kopyasını oluşturun.
3. Kopya temanın JavaScript alanına modül script etiketini defer ile ekleyin.
4. Ürün detay ayarlarında barkod alanının gösterimini açın; görünmesini istemiyorsanız CSS ile gizleyin, kapatmayın.
5. Ürün kartlarında barkod alanlarının dolu olduğunu doğrulayın; boş olanları toplu güncelleyin.
6. Bir ürün sayfasında tarayıcı konsolunu açıp #spnBarkod değerinin okunduğunu ve isteğin başarılı döndüğünü kontrol edin.
7. Varyasyonlu bir üründe renk değiştirip yorumların yenilendiğini test edin.
8. Mobil görünümü ayrıca kontrol edin; blok hedefi mobil temada farklı sarmalayıcıda olabilir.
9. Yorum senkronunu günlük artımlı çalışacak şekilde kurun; kaynak ve yorum kimliği ikilisine benzersiz kısıt koyarak mükerrer kaydı engelleyin.
10. Kişisel veri maskelemesini ve spam filtresini kayıt anında uygulayın, gösterim anında değil.
11. Yapılandırılmış veriyi yalnızca kendi topladığınız yorumlar için üretin; pazaryeri yorumlarını kapsam dışında bırakın.
12. Kopya temayı yayına alın ve birkaç gün orijinal temayı silmeden bekletin.

Sık karşılaşılan sorunlar ve gerçek sebepleri

Şeffaflık, KVKK ve mevzuat tarafı

Bu bölüm rakip içeriklerin çoğunda hiç yok; oysa bir denetimde ilk sorulacak yer burasıdır.

• Kaynağı gösterin: Her yorumun yanında ya da bloğun altında verinin Trendyol kaynaklı olduğu açıkça belirtilmelidir. Bu hem güven hem de içeriğin size ait olmadığını ortaya koyan bir atıftır.
• Seçici gösterimden kaçının: Ticari Reklam ve Haksız Ticari Uygulamalar Yönetmeliği, tüketici değerlendirmelerinin sunumuna ilişkin hükümler içerir. Yalnızca olumlu yorumları yayınlayıp olumsuzları gizlemek uygulamada yanıltıcı ticari uygulama olarak değerlendirilebilir. Filtreleme yapacaksanız küfür ve spam temizliği gibi tarafsız kriterlerle yapın ve kriteri sayfada açıklayın. Sınırda bir durumdan emin değilseniz hukuki görüş alın.
• KVKK: Müşteri adını pazaryerinde göründüğü kısaltılmış haliyle bırakın, tam ad üretmeyin. Yorum metnine yanlışlıkla yazılmış telefon, adres ya da sipariş numarası gibi bilgileri senkron sırasında maskeleyin. İhtiyacınız olmayan müşteri kimliği alanlarını veritabanınıza hiç almayın.
• Metni değiştirmeyin: Yorumu düzeltmek, kısaltmak ya da olumlu hale getirmek hem etik hem hukuki olarak sorunludur. Yalnızca maskeleme ve zararlı içerik temizliği yapın.
• Veri sizde dursun: Yorumları çektiğiniz anda kendi veritabanınıza yazın. Kaynak tarafında bir değişiklik olduğunda senkron durur ama yayındaki içerik ayakta kalır.

STools tarafında nasıl çözüyoruz

Yukarıdaki mimariyi sıfırdan kurmak yerine hazır bir çözüm tercih ediyorsanız, Trendyol Yorum Modülü Ticimax sürümünde tek script satırıyla kurulur. Barkod tabanlı eşleştirme, varyasyon değişiminin izlenmesi, mobil ve masaüstü için ayrı yerleşim hedefleri, kategori sayfasında toplu yıldız gösterimi, fotoğraflı yorum filtresi, puan filtresi ve yorum içinde arama hazır gelir. Blok, kaynağın Trendyol olduğunu her ekranda belirtir.

Aynı ürün sayfasında soru-cevapları da göstermek isterseniz modül, yorumlar ve sorular arasında sekmeli bir yapı sunar; ürünün hiç yorumu ve sorusu yoksa blok tamamen gizlenir. Modüller Ticimax'in yanı sıra Shopify, Ikas ve T-Soft altyapılarıyla da çalışır. Ticimax temanız özelleştirilmişse ve standart yerleşim hedefleri bulunmuyorsa, tema tarafındaki uyarlamayı da yapıyoruz.

Özet

Ticimax'te Trendyol yorum aktarma projesi, teknik olarak diğer altyapılardan daha basit ama daha az esnektir. Kod tek bir yere eklenir: Tasarım > Tema Yönetimi altındaki JavaScript alanına, tercihen temanın bir kopyası üzerinde. Eşleştirme tek bir alana bağlıdır: barkod. Kurulum sonrası yaşanan sorunların büyük çoğunluğu da bu iki cümlenin içindedir: ya kod yanlış yere eklenmiştir, ya barkod alanı kapalıdır. Sunucu tarafında içerik basamadığınız için SEO beklentinizi yıldızlı sonuç üzerine değil, dönüşüm üzerine kurun. Kurulum sırasında takıldığınız bir nokta olursa destek@stools.digital adresinden yazabilirsiniz.