Kanal, alan adı ve anahtarlar

Kanalın oluşturulması, alan adının doğrulanması ve site anahtarı ile sunucu anahtarının oluşturulması.

Siteyi bağlamadan önce panelde üç şey hazırlanır: bir kanal, doğrulanmış bir alan adı ve kanalın anahtarları. Bu adımların tümü Kurulum › Kanallar ekranındaki Yeni kanal kur sihirbazıyla sırasıyla yapılır.

Kanal

Kanal, yorumların toplandığı ve gösterildiği satış noktasıdır; örneğin Türkiye web siteniz, mobil uygulamanız, başka bir ülkedeki siteniz ya da başka bir alan adında, başka bir adla satış yaptığınız siteniz. Bir markanın bütün kanalları aynı panelde yönetilir. Her kanalın üç özelliği vardır:

Alan	Açıklama
Ad	Panelde gösterilen ad; örneğin “Türkiye web sitesi”
Pazar	Kanalın tabi olduğu ülke kuralları. Satın alma kanıtı zorunluluğu, yorum yazma süresi ve izin verilen sıralamalar pazar kurallarıyla belirlenir: Sayproof’un pazar kuralı tabandır, markanız bu sınırlar içinde pazar ya da kanal için kendi kural sürümünü yayınlayabilir. Kanal oluşturulduktan sonra pazar değiştirilemez.
Dil	Davet e-postalarının ve yorum formunun varsayılan dili (`tr` ya da `en`)

Kanal kodu, kanal adından otomatik olarak üretilir ve API’de kanalı tanımlar (örneğin channel=web). Aynı pazardaki kanalların yorumları birlikte gösterilir ve tek bir ortalamada hesaplanır; farklı pazarların yorumları birbirine karışmaz. Bu kural başka bir adla satış yapan kanallarda da geçerlidir: markanızın iki sitesi aynı pazardaysa aynı ürünün yorumları iki sitede de görünür.

Kanalı düzenleme

Kanallar ekranında kanal kartındaki Düzenle düğmesi Kanalı düzenle formunu açar. Formda Adı, Dil ve Davet bağlantısının açılacağı sayfa alanları değiştirilebilir; kanalı kapatmak ya da yeniden açmak formda değil, kanal kartındaki Kanalı kapat ve Kanalı aç düğmeleriyle yapılır (Kanalı kapatma ve kaldırma). Dil, sihirbazdaki gibi listeden seçilir (Türkçe ya da English). Pazar değiştirilemez. Değişiklikler Değişiklikleri kaydet düğmesiyle kaydedilir ve İşlem geçmişi’ne yazılır.

Aynı formdaki üç alan, müşteriye giden e-postalarda bu kanalın hangi adla, hangi adresten ve hangi destek sayfasıyla görüneceğini belirler:

Müşteriye görünen ad: Bu kanalın davet e-postalarında, ret bildirimlerinde ve e-posta almak istememe sayfasında marka adı olarak yazar.
Gönderen e-posta adresi: Bu kanalın davet e-postaları bu adresten gider. Adresin alan adı Gönderen alan adları kartında doğrulanmış olmalıdır; doğrulanmamış alan adındaki adres kaydedilmez (sender_domain_unverified).
Destek sayfası adresi: Bu kanalın davet e-postalarındaki destek bağlantısı bu sayfayı açar (https).

Boş bırakılan alanda markanın adı ve Davet gönderimi › Gönderim yolu bölümündeki gönderen adresi ve destek sayfası kullanılır. E-posta almak istememe kaydı ise markanın geneline uygulanır: bir kanalın e-postasından davet almamayı seçen müşteriye markanın hiçbir kanalından davet gitmez.

Aydınlatma metni bağlantısı alanına kişisel verilerin işlenmesi hakkındaki aydınlatma metninizin adresi yazılır (https; adresin doğrulanmış alan adınızda olması gerekmez). Adres girilmişse bu kanalın sitesinde yorum, soru ve cevap formlarının ve sipariş sayfasındaki yorum formunun altında, davet e-postasının da alt bilgisinde Kişisel verilerin işlenmesi hakkında aydınlatma metni bağlantısı gösterilir; bağlantı yeni sekmede açılır. Bu alanın marka geneli karşılığı yoktur: boş bırakılırsa bağlantı gösterilmez. https ile başlamayan adres kaydedilmez (privacy_url_not_https).

Varsayılan bileşenin bu kanalın sitesindeki tasarımı ve düzeni bu formda değil, Kurulum › Mağaza görünümü ekranında seçilir: Mağaza görünümü.

Kanalı kapatma ve kaldırma

Kanal, Kanallar ekranındaki kartında bulunan Kanalı kapat düğmesiyle kapatılır; düğme önce aşağıdaki sonuçları gösterip onay ister. Kapalı kanalın kartında Kanalı aç düğmesi bulunur. Kapalı kanalda:

Script, bu kanalın site anahtarıyla gelen her isteğe channel_inactive döner; sitede yorum görünmez ve yazılamaz. Sunucu anahtarıyla bu kanal için yapılan SSR ve oturumlu müşteri istekleri unknown_channel döner.
Kanal koduyla gelen sipariş gönderimi invalid / channel_unknown ile reddedilir. Kanala bağlı sipariş bağlantısı okuma yapmaz; Şimdi oku 409 channel_inactive döner.
Kanalın siparişleri için yeni davet üretilmez. Bekleyen davet “Kanal kapalı” nedeniyle durur, gönderilmiş davete hatırlatma gitmez.
Ret bildirimleri gönderilmeye devam eder. Yazılmış yorumlar ve geçmiş kayıtlar değişmez.

Kanal yeniden açıldığında sipariş bağlantısı kaldığı yerden okur; yazma süresi dolmamış ve henüz davet gitmemiş siparişler için davet üretilir.

Hiç yorumu, siparişi ve sipariş bağlantısı olmayan bir kanal Kanalı düzenle formundaki Kanalı kaldır düğmesiyle silinir. Kanalla birlikte site anahtarları, görüntülenme sayıları ve bu kanala özel yayınlama yöntemi de silinir; işlem İşlem geçmişi’ne yazılır ve geri alınamaz. Yorumu, siparişi ya da sipariş bağlantısı olan kanal kaldırılamaz (409 channel_in_use); yorumlar ve siparişler saklanması gereken kayıtlar olduğu için bu kanallar kapatılır.

Kanal hakkı

Her marka varsayılan olarak en fazla 3 açık kanal kurabilir; bu sayı Kanal hakkıdır. Kapalı kanallar bu sayıya girmez.

Yönetici, kanal hakkı dolana kadar Yeni kanal kur sihirbazıyla kanal ekler.
Kanal hakkı dolduğunda Yeni kanal kur düğmesinin yerinde Ek kanal iste düğmesi görünür. Düğme, isteğe bağlı bir notla Sayproof ekibine istek gönderir; aynı anda yalnızca bir açık istek bulunabilir (409 channel_request_open). Sayproof ekibi isteği kabul ettiğinde kanal hakkınız artar. İstek ve sonucu İşlem geçmişi’ne kaydedilir.
Bir kanalı kapatmak yer açar. Kapalı bir kanalı yeniden açmak için boş yer gerekir. Kanal hakkı doluyken yeni kanal oluşturulamaz ve kapalı kanal yeniden açılamaz (409 channel_quota).

Alan adı doğrulama

Yorumlar yalnızca doğrulanmış alan adlarındaki sayfalarda görünür. Böylece biri sizin site anahtarınızı kopyalasa bile yorumlarınızı kendi sitesinde gösteremez.

Sihirbazın Alan adı doğrulama adımında ya da Kanallar › Alan adları sekmesindeki Alan adları kartında alan adını ekleyin; örneğin www.markaniz.com.
Doğrulama bekleyen her alan adı için panel “<alan adı> nasıl doğrulanır?” başlığı altında Doğrulama yolu seçimini gösterir: Sitenize dosya ya da DNS kaydı. İki yol da aynı doğrulama metnini kullanır; sizin için kolay olanı seçin.
Sitenize dosya yolunda panel Dosyanın adresi ve Dosyanın içindeki metin değerlerini kopyalama düğmeleriyle gösterir. Geliştiriciniz sitenize, bu adreste açılan ve içinde yalnızca bu metin yazan küçük bir metin dosyası koyar:
```
https://www.markaniz.com/.well-known/sayproof-domain-verification
```
DNS kaydı yolunda panel Kayıt türü (TXT), Ad ve Değer satırlarını gösterir; Ad ve Değer kopyalama düğmeleriyle gelir. Alan adınızın DNS ayarlarına (alan adını aldığınız firmanın ya da Cloudflare gibi bir hizmetin panelinde) bu adla, değeri doğrulama metni olan bir TXT kaydı eklenir. Ad, alan adının önüne _sayproof-verification eklenerek oluşur:
```
_sayproof-verification.www.markaniz.com
```
Bazı DNS panelleri alan adını adın sonuna kendisi ekler; orada adın yalnızca alan adınızdan önceki kısmı yazılır (_sayproof-verification.www). Shopify, Wix gibi sitenize dosya koyamadığınız hazır altyapılarda bu yolu kullanın.
Dosya ya da kayıt yerindeyse Doğrula düğmesine basın. Sayproof önce dosyayı okur, dosya yoksa ya da içeriği eşleşmezse DNS kaydına bakar; ikisinden biri doğrulama metniyle eşleşirse alan adı doğrulanır.

Doğrulama kuralları:

Adres https üzerinden açılmalı ve 200 yanıtı vermelidir. Yönlendirmeler izlenmez; dosya doğrudan bu adreste bulunmalıdır.
Her alan adı ayrı doğrulanır: markaniz.com ve www.markaniz.com iki ayrı alan adıdır. Yorumların gösterileceği her adresi ekleyin.
Alan adı kanala değil, markaya bağlıdır. Doğrulanan bir alan adı tüm kanallarınızda geçerlidir.
Yerel ağ adresine çözümlenen alan adlarında dosya okunmaz; bu alan adları yalnızca DNS kaydıyla doğrulanabilir.
DNS kaydının değeri yalnızca doğrulama metninden oluşmalıdır; aynı adda başka TXT kayıtları da bulunabilir. Yeni bir DNS kaydının görünmesi birkaç dakika ile birkaç saat sürebilir; kayıt bulunamadıysa bir süre sonra yeniden Doğrula’ya basın.
Doğrulama olmazsa panel nedenini yazar: dosyanın içeriği beklenenle aynı değilse “sitenizdeki dosyanın içeriği beklenenle aynı değil”, ne dosya ne kayıt bulunduysa “sitenizde ne doğrulama dosyası ne de DNS kaydı bulundu”, kayıt bulunup değeri farklıysa “DNS kaydı bulundu ama değeri beklenenle aynı değil”, dosya yokken alan adının DNS sunucusuna ulaşılamadıysa “alan adının DNS sunucusuna ulaşılamadı; biraz sonra yeniden deneyin”.

Doğrulanmamış bir alan adındaki sayfada yorumlar görünmez: istek geri çevrilir ve Bağlantı kayıtları ekranına “Site doğrulanmamış” sonucuyla kaydedilir.

Davet bağlantısının açılacağı sayfa

Aynı adımda, müşteri davet e-postasındaki bağlantıya tıkladığında açılacak sayfa girilir; örneğin https://www.markaniz.com/yorum-yaz. Kurallar:

Sayfa doğrulanmış alan adlarınızdan birinde olmalı ve https ile başlamalıdır.
Sayfada yorum container’ı bulunmalıdır. Sayproof token’ı bağlantının # işaretinden sonraki bölümüne ekler (https://www.markaniz.com/yorum-yaz#review_token=…); script bu değeri gördüğünde yorum formunu otomatik olarak açar ve değeri adres çubuğundan siler. Eski davetlerdeki ?review_token=… biçimi de okunur. Container bulunmayan bir sayfada (örneğin ana sayfada) bağlantı formu açmaz.
Sayfa girilmemişse bağlantı, ürünün katalogdaki sayfa adresini açar (bkz. Ürünler). İkisi de yoksa davet gönderilmez ve “Davet bağlantısının açılacağı sayfa girilmemiş” nedeniyle kaydedilir.

Bir ürün sayfasını ya da container içeren ayrı bir “yorum yaz” sayfasını kullanabilirsiniz.

Alan adını kaldırma

Kanallar › Alan adları sekmesindeki Alan adları kartında her satırın Kaldır düğmesi, doğrulanmış ya da doğrulama bekleyen alan adını onaydan sonra siler. Kaldırılan alan adındaki sayfalarda yorumlar bundan sonra gösterilmez. Bir kanalın Davet bağlantısının açılacağı sayfa adresi bu alan adındaysa alan adı kaldırılamaz (409 domain_in_use; ayrıntıda o kanalların kodları yazar); önce kanalın adresini değiştirin. Bir kanalın yöntem beyanı adresi bu alan adındaysa da kaldırılamaz (409 domain_in_statement; ayrıntıda kanal kodu ve dil yazar); önce Pazar kuralları › Yöntem beyanı’ndaki adresi değiştirin. Kaldırma İşlem geçmişi’ne yazılır.

Gönderen alan adları

Davet e-postalarının markanızın adresinden (örneğin yorum@markaniz.com) gitmesi için adresin alan adı Kanallar › Alan adları sekmesindeki Gönderen alan adları kartında doğrulanır. Gönderen adresi Davet gönderimi › Gönderim yolu bölümündeki Gönderen e-posta adresi alanına, kanala özel adres ise Kanalı düzenle formundaki aynı adlı alana yazılır (Kanalı düzenleme); doğrulanmamış bir alan adındaki adres bu alanlara kaydedilemez (sender_domain_unverified).

Gönderen alan adı ekle düğmesi üç adımlık sihirbazı açar:

Alan adı: E-postaların gideceği adresin @ işaretinden sonraki kısmı; örneğin markaniz.com.
DNS kayıtları: Alan adınızın DNS yönetim ekranına eklenecek dört TXT kaydı listelenir. Değerler sihirbazda gösterilir ve kopyalanabilir; bir kaydın değeri boş gösteriliyorsa (“Değeri e-posta hizmetiniz verir”) o değeri e-posta hizmetinizden alın.
Denetim: Kayıtları denetle düğmesi kayıtların alan adınızda görünüp görünmediğine bakar ve her kayıt için “Bulundu” ya da “Bulunamadı” sonucunu gösterir.

Kayıt	Tür	Ad	Aranan değer
Sahiplik kaydı (Sayproof)	`TXT`	`_sayproof.markaniz.com`	Sihirbazda gösterilen `sayproof-verification=…` değeri. Değer markanıza ve alan adına özeldir; alan adının size ait olduğunu gösterir.
Gönderme izni (SPF)	`TXT`	`markaniz.com`	`v=spf1` ile başlayan kayıt; sihirbazda bir `include:` değeri gösteriliyorsa kayıt bu değeri de içermelidir
İmza anahtarı (DKIM)	`TXT`	`<seçici>._domainkey.markaniz.com`; seçici sihirbazda gösterilir	Açık anahtarı (`p=`) içeren kayıt
Alan adı kuralı (DMARC)	`TXT`	`_dmarc.markaniz.com`	`v=DMARC1` ile başlayan kayıt; sihirbaz `v=DMARC1; p=none` önerir

Dört kaydın dördü de bulunduğunda alan adı doğrulanır. Yeni bir DNS kaydının yayılması birkaç dakika ile birkaç saat sürebilir; bir kayıt bulunamadıysa bir süre sonra listeden alan adını açıp yeniden denetleyin. Alan adının DNS sunucusuna ulaşılamazsa ya da DNS sunucusu geçici bir hata verirse kayıtlar “Bulunamadı” sayılmaz; 502 sender_domain_check_failed / dns_unreachable yanıtı döner ve denetim daha sonra yeniden yapılabilir.

Doğrulanan alan adının satırında ilk doğrulama zamanı yazar; kayıtlar yerinde kaldıkça yeniden denetim bu zamanı değiştirmez. Satırdaki Davet gönderimi › Gönderim yolu’na git düğmesi Davet gönderimi ekranını açar.

Davet gönderimi ekranındaki ya da herhangi bir kanalın gönderen adresinde kullanılan alan adı kaldırılamaz (409 sender_domain_refused / sender_domain_in_use); önce gönderen adresini değiştirin.

Anahtarlar

Bir kanal için iki anahtar yeterlidir:

Değer	Gizli mi	Bulunduğu yer	İşlevi
Site anahtarı	Hayır	Sayfanın kodunda, tarayıcıda	Script’in yorumları getirmesini ve yorum formunu açmasını sağlar. Yalnızca doğrulanmış alan adlarında çalışır.
Sunucu anahtarı	Evet	Yalnızca mağazanızın sunucusunda	Siparişlerin ve teslimatların Sayproof’a gönderilmesini, yorumların sayfayla birlikte sunucuda hazırlanmasını (SSR) ve oturum açmış müşterinin durumunun sorgulanmasını sağlar.

İkisi de Kanallar › Anahtarlar sekmesinde ve kanal kurulum sihirbazının Anahtarlar adımında (“Sitenizin ve sunucunuzun kullanacağı iki anahtar”) oluşturulur. Siparişleri imzalayarak göndermek isteyen ekipler için isteğe bağlı bir imzalı gönderim şifresi de vardır.

Site anahtarı

Site anahtarı kanala bağlıdır ve sayfa kaynağında görünmesinde bir sakınca yoktur. Tek başına yorum yazılmasını sağlamaz; yorum yazmak için sipariş doğrulaması ya da davet bağlantısı gerekir.

Site anahtarı kanalın kurulum sihirbazında ya da Kanallar › Anahtarlar sekmesindeki Site anahtarları kartında Yeni site anahtarı düğmesiyle oluşturulur; kartta birden fazla kanalınız varsa önce Kanal seçilir. Bir kanalın kullanımdaki bütün site anahtarları iptal edilene kadar çalışır. Kurulum ekranları (kanal sihirbazı, Entegrasyon ve geliştiriciyle paylaşılan kurulum belgesi) kanalın en yeni anahtarını gösterir.

Sunucu anahtarı

Sunucu anahtarı sipariş ve teslimat aktarımında, SSR’da ve oturum açmış müşteri özelliğinde kullanılır; aynı anahtar hepsine yeter. Sunucu anahtarı kanala değil markaya bağlıdır: aynı anahtar bütün kanallarınızda kullanılabilir, isteğin hangi kanala ait olduğu istekteki kanal koduyla belirlenir. Anahtar Sunucu anahtarları kartında Anahtarın adı girilip Sunucu anahtarı oluştur düğmesiyle oluşturulur. Panelden oluşturulan sunucu anahtarı “Sipariş gönderme” (orders) ve “Sayfayı sunucuda hazırlama” (ssr) izinlerini kendiliğinden taşır; panelde ayrıca izin seçilmez. Anahtar Admin API’yi kullanamaz.

Anahtarın tamamı yalnızca oluşturulduğu anda bir kez gösterilir. Sayproof anahtarı saklamaz; anahtarı kaybederseniz yeni bir anahtar oluşturmanız gerekir.
Anahtar Authorization: Bearer … header’ı ile gönderilir ve hiçbir zaman tarayıcıya ulaşmamalıdır. Tarayıcıya aktarılan bir ortam değişkenine (örneğin NEXT_PUBLIC_…) yazılmamalıdır.
Bu anahtarla herhangi bir e-posta adresi için oturum açmış müşteri sorgusu yapılabilir: adresin bir ürünü satın alıp almadığı ve yorum yazıp yazmadığı öğrenilir. Anahtarı bir parola gibi koruyun ve yalnızca sunucuda tutun; açığa çıktığından şüpheleniyorsanız hemen iptal edin. Ayrıntılar için: Anahtarlar ve erişim.

İmzalı gönderim şifresi

İsteğe bağlıdır. Siparişler sunucu anahtarıyla gönderilir; isteklerini ayrıca bir şifreyle imzalamak isteyen ekipler Kanallar › Anahtarlar sekmesinin altındaki kapalı Gelişmiş: imzalı gönderim şifreleri bölümünü açıp İmzalı gönderim şifreleri kartında Şifrenin adı girerek Şifre oluştur düğmesine basar.

İmzalı gönderim şifresi iki parçadan oluşur: şifre kimliği (her istekte X-Sayproof-Secret header’ında gönderilir) ve şifrenin kendisi (yalnızca imzayı hesaplamak için kullanılır, hiçbir istekte gönderilmez). Şifre yalnızca oluşturulduğu anda bir kez gösterilir. Oluşturma sonrasında açılan kartta Şifre kimliği ve Şifre birlikte yer alır. Kimlik gizli değildir; daha sonra da İmzalı gönderim şifreleri tablosunun Şifre kimliği sütununda görünür ve kopyalanabilir. Adı sütunundaki ad yalnızca şifreyi tanımanız içindir; header’da ad değil kimlik gönderilir. Kullanımı için: Sipariş ve teslimat aktarımı › İmza.

Aynı tabloda iki özel amaçlı şifre de yer alır. Bu şifreler sipariş aktarımını imzalayamaz; yalnızca kendi amaçları için kullanılır:

Bildirim adresi şifresi: Davetleri kendi sisteminiz gönderiyorsa, Sayproof’un sisteminize gönderdiği bildirimleri imzalar. Bkz. Davetleri kendi sisteminizle göndermek.
E-posta teslim bildirimi şifresi: E-posta hizmetinizin teslim ve açılma olaylarını Sayproof’a bildirmesi için kullanılır. Bkz. E-posta teslim bildirimleri.

Anahtar yenileme

İptal edilen bir anahtar ya da şifre kalıcı olarak kapanır ve geri alınamaz; onu kullanan sistem hemen çalışmayı durdurur. Kesinti olmadan yenilemek için:

Yeni anahtarı ya da şifreyi oluşturun (şifreye yeni bir ad verin). Site anahtarı için Site anahtarları kartındaki Yeni site anahtarı düğmesini kullanın.
Sisteminizi yeni değere geçirin (site anahtarında sitenizdeki kodu yeni anahtarla güncelleyin) ve Bağlantı kayıtları ekranından ya da Entegrasyon › Sipariş aktarımı sekmesindeki Son istekler listesinden çalıştığını doğrulayın.
Eski anahtarı ya da şifreyi iptal edin.

Bir değerin sızdığından şüpheleniyorsanız beklemeden iptal edin ve yenisini oluşturun.

Deneme

Sihirbazın son adımı, bu kanal için sitenizden gelen son isteği ve bu kanala aktarılan sipariş sayısını (Aktarılan sipariş) gösterir. Kodu ekledikten sonra bir ürün sayfasını açın ve Yeniden kontrol et düğmesine basın. Aynı bilgi daha sonra Entegrasyon › Sitede gösterim sekmesinde kanal seçilerek “Sitede görüldü mü?” bölümünde de gösterilir.