Kurulum seçenekleri

Sayproof’un bir siteye bağlanması birbirinden bağımsız iki işten oluşur ve ikisi de gereklidir:

1. Gösterim. Ürün sayfası yorumları gösterir ve yorum formunu açar. Bu iş sayfanın kodunda yapılır.
2. Sipariş aktarımı. Siparişler ve teslimatlar Sayproof’a ulaşır: Akinon, Shopify ya da WooCommerce kullanan mağazalarda Sayproof bunları platformdan kendisi okur, diğer mağazalarda mağaza sisteminiz gönderir. Yorum yazma hakkı ve davet e-postaları bu bilgiye dayanır; sipariş aktarılmazsa kimse yorum yazamaz.

Gösterim hangi yöntemle kurulursa kurulsun sipariş aktarımı aynıdır: Akinon siparişleri, Shopify siparişleri, WooCommerce siparişleri ya da Sipariş ve teslimat aktarımı.

Mağazanıza pazaryerlerinde yazılmış yorumları da göstermek isterseniz bu, sitenize kod eklemeden panelden bağlanan ayrı ve isteğe bağlı bir özelliktir: Pazaryeri yorumları.

Gösterim seçenekleri

Seçenek	Yorumların hazırlandığı yer	Sayfanın ilk yanıtında yorumlar	Gerekenler	Uygun olduğu durum
Script	Ziyaretçinin tarayıcısı	Yok; script yüklendikten sonra gelir	Bir <script> etiketi ve bir container	Her site; en hızlı başlangıç
Server-side rendering (SSR) + script	Mağazanın sunucusu Sayproof’tan hazır HTML alır; script ardından devralır	Var; metin ve yapılandırılmış veri (JSON-LD) dahil	Sunucu anahtarı ve sunucu tarafında birkaç satır kod	Arama motoru görünürlüğünün önemli olduğu siteler (önerilen)
Headless	Veriyi siz alır, kendi bileşenlerinizle gösterirsiniz; script yalnızca yorum yazma akışını yürütür	Sizin tercihinize bağlı	Geliştirme emeği; zorunlu öğelerin sizin tarafınızdan gösterilmesi	Kendi tasarım sistemi olan markalar

Üç seçenek de aynı script’i ve aynı endpoint’leri kullanır. Script ile başlayıp daha sonra SSR’a ya da headless kullanıma geçebilirsiniz; sayfadaki container ve site anahtarı değişmez.

Proje tipine göre

Proje	SSR	Script
Next.js App Router (örneğin Akinon Next)	Next.js sayfası ve hazır kit	Aynı kit, SSR yanıtı verilmeden
Django ya da Jinja şablonları	Django / Jinja sayfası ve hazır kit	Aynı kit, sunucu anahtarı tanımlanmadan
Diğer siteler	Server-side rendering sayfasındaki Node.js, Python ve PHP örnekleri	Script sayfası

Hazır kitler mağaza projesine kopyalanır; paket kurulumu gerektirmez. Panelde Entegrasyon › Sitede gösterim sekmesi, seçilen Kurulum yoluna göre kurulumda kullanılacak değerleri (site anahtarı, Sayproof adresi, script adresi ya da kanal kodu) ve bu dokümantasyondaki ilgili sayfayı açan Adım adım kurulum (dokümantasyon) düğmesini gösterir. Kod örnekleri bu dokümantasyondadır.

Seçim

• Sitenizin sunucusunda kod çalıştıramıyorsanız (hazır site oluşturucu, yalnızca etiket yöneticisi): script.
• Sunucuda kod çalıştırabiliyorsanız: SSR + script. Yorum metni sayfa kaynağında yer alır; arama motorları ve bağlantı önizlemeleri script’i beklemeden içeriği görür.
• Yorum bölümünün görünümünü tamamen kendiniz belirlemek istiyorsanız: headless. Yalnızca varsayılan bileşenin görünümünü değiştirmek istiyorsanız önce Özelleştirme sayfasına bakın; çoğu durumda CSS yeterlidir.

Hata durumunda sayfanın korunması

Gösterim katmanlı çalışır; bir katman çalışmazsa bir alttaki devreye girer ve sayfanın geri kalanı etkilenmez:

1. SSR ile hazırlanan HTML geldiyse yorumlar ilk yanıtta görünür; script yüklendiğinde etkileşimi devralır.
2. Sunucunun Sayproof’a gönderdiği istek zamanında yanıt almazsa sayfa beklemez; script yorumları tarayıcıda kendisi getirir.
3. Script de yorumları alamazsa container’a data-review-failed attribute’u eklenir. Sayfanın geri kalanı etkilenmez; bu attribute ile container’ı gizleyebilirsiniz.

Sunucudan gönderilen isteğe kısa bir zaman aşımı verin (1,5 saniye önerilir). Sayproof’a ulaşılamaması sayfanızın açılmasını geciktirmemelidir.

Oturum açmış müşteri (isteğe bağlı)

Müşteri sitenizde oturum açmışsa yorum formu sipariş numarası sorulmadan açılabilir. Bunun için sunucunuz, oturumdaki e-posta adresiyle müşterinin bu ürüne yorum yazıp yazamayacağını Sayproof’a sorar. Aynı yöntemle sipariş detayı sayfasında siparişin ürünleri sayfanın içinde değerlendirilebilir. Ayrıntılar için: Oturum açmış müşteri.

Kurulum sırası

1. Panelde kanalı oluşturun, alan adını doğrulayın ve anahtarları oluşturun: Kanal, alan adı ve anahtarlar.
2. Sipariş aktarımını başlatın ve birkaç deneme siparişi gönderin.
3. Ürün sayfasına yorum gösterimini ekleyin.
4. Paneldeki Entegrasyon › Sitede gösterim sekmesinde “Sitede görüldü mü?” bölümünü ve Bağlantı kayıtları ekranını kontrol edin.
5. Teslim edilmiş bir deneme siparişiyle yorum yazın; yorum Onay bekleyenler listesine gelir.

Kurulumu bir geliştirici yapacaksa ona panel hesabı açmanız gerekmez: panelde Entegrasyon › Geliştiriciyle paylaş sekmesinden kanalınızın adreslerini, site anahtarını ve kod örneklerini içeren, süreli bir kurulum belgesi bağlantısı gönderebilirsiniz. Belgede gizli anahtar yer almaz.

Adım adım liste için: Hızlı kurulum.