# Kurulum seçenekleri

> Sayproof'u sitenize bağlamanın yolları ve sitenize uygun seçeneğin belirlenmesi.

Kaynak: /tr/integrate/overview/

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](/tr/integrate/akinon.md), [Shopify siparişleri](/tr/integrate/shopify.md), [WooCommerce siparişleri](/tr/integrate/woocommerce.md) ya da [Sipariş ve teslimat aktarımı](/tr/integrate/orders.md).

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ı](/tr/features/marketplace-reviews.md).

## Gösterim seçenekleri

| Seçenek | Yorumların hazırlandığı yer | Sayfanın ilk yanıtında yorumlar | Gerekenler | Uygun olduğu durum |
|---|---|---|---|---|
| [Script](/tr/integrate/script.md) | 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)](/tr/integrate/server-rendering.md) + 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](/tr/integrate/headless.md) | 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](/tr/integrate/nextjs.md) sayfası ve hazır kit | Aynı kit, SSR yanıtı verilmeden |
| Django ya da Jinja şablonları | [Django / Jinja](/tr/integrate/django.md) sayfası ve hazır kit | Aynı kit, sunucu anahtarı tanımlanmadan |
| Diğer siteler | [Server-side rendering](/tr/integrate/server-rendering.md) sayfasındaki Node.js, Python ve PHP örnekleri | [Script](/tr/integrate/script.md) sayfası |

Hazır kitler mağaza projesine kopyalanır; paket kurulumu gerektirmez. Panelde **Entegrasyon › Sitede gösterim** sekmesi, seçilen **Kurulum yolu**na 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](/tr/customize/overview.md) 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](/tr/integrate/signed-in-customers.md).

## Kurulum sırası

1. Panelde kanalı oluşturun, alan adını doğrulayın ve anahtarları oluşturun: [Kanal, alan adı ve anahtarlar](/tr/integrate/channels-and-keys.md).
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](/tr/start/quickstart.md).