Kanal Anahtarı

Kanal anahtarı, Selwise'in gelen isteğin hangi kanala ait olduğunu anladığı 32 karakterlik değerdir.

Panelde nerede

Sol menüde Kanallar → kanalın kartı. Anahtar orada görünür ve kopyalanabilir.

API'de adı hâlâ siteKey

Panel bu değeri "kanal anahtarı" olarak adlandırır; HTTP yolunda, script özniteliğinde ve SDK seçeneklerinde adı siteKey olarak kalır:

GET /api/v1/public/sites/SITE_KEY/config

Bunun nedeni, bu ismin müşterilerin vitrinlerinde çalışan her yerleştirme kodunda ve yayınlanmış bir npm paketinin public API'sinde bulunmasıdır. Yeniden adlandırmak, dünyadaki her müşteriyle eşzamanlı bir sürüm gerektirir. Kanal ekranındaki hazır kodları kopyalarsanız doğru ismi zaten kullanırsınız.

Nerede kullanılır

Web kanalı — script etiketinde:

<link rel="preconnect" href="https://widget.selwise.com" crossorigin>
<link rel="preconnect" href="https://api.selwise.com" crossorigin>
<script>window.Selwise=window.Selwise||{};window.Selwise.q=window.Selwise.q||[];['track','trackOrder','identify','setTraits','pushDataLayer','grantConsent','revokeConsent','endJourney'].forEach(function(m){if(!window.Selwise[m])window.Selwise[m]=function(){window.Selwise.q.push([m,arguments])}});</script>
<script async src="https://widget.selwise.com/client.js" data-site-key="SITE_KEY"></script>

Uygulama kanalı — SDK başlatmasında, bir API anahtarıyla birlikte:

await selwise.init({
  channelKey: 'CHANNEL_KEY',
  apiKey: 'swpk_live_...',
});

Gizli değildir

Kanal anahtarı, web kanalında sayfanızın kaynak kodunda herkese görünür. Bu bir sorun değildir, çünkü tek başına hiçbir yetki vermez:

• Web kanalında her public istek ayrıca Origin / Referer başlığına bakılarak kanalın doğrulanmış alan adına karşı kontrol edilir. Başka bir alan adından sizin anahtarınızla istek atılırsa reddedilir.
• Uygulama kanalında karşılaştırılacak bir alan adı yoktur; her istek ayrıca bir API anahtarı sunmak zorundadır. Kanal anahtarı tek başına hiçbir kapıyı açmaz.

Değişir mi

Kanal anahtarı, kanal oluşturulduğunda üretilir ve kendiliğinden değişmez. Alan adını değiştirseniz bile aynı kalır — bu yüzden kurulumu bir kez yapmanız yeterlidir.

Anahtarı elle yenileyebilirsiniz (kanal kartındaki yenileme düğmesi), ama bu bir sert değişimdir: eski anahtar önbellekleri boşaldığı anda çalışmayı bırakır. Yenilemeden önce yerleştirme kodunu ve SDK başlatmasını güncellemeye hazır olun.

Yanlış kanal anahtarı belirtileri

Belirti	Sebep
config isteği 404 dönüyor	Anahtar hatalı veya kanal silinmiş
config isteği 403 dönüyor	Anahtar doğru ama alan adı doğrulanmamış, ya da istek başka bir alan adından geliyor
Uygulamadan her istek 403 dönüyor	Uygulama kanalında API anahtarı eksik veya yetkileri yetersiz — bkz. Uygulama Kanalları
Widget hiç görünmüyor, konsol sessiz	Script etiketinde data-site-key özniteliği hiç yok

Teşhis: Widget Görünmüyor.