Akinon
Project Zero ve Omnife Next
Akinon, aynı public yolların arkasında iki farklı çalışma zamanı barındırır. Kurulum, hangisinde olduğunuza göre değişir.
İki yığın
| Yığın | Nedir | Nasıl anlaşılır |
|---|---|---|
| Project Zero | Django tabanlı klasik storefront | Sayfa kaynağında window.GLOBALS bulunur |
| Omnife Next | @akinon/next tabanlı Next.js storefront | pz- önekli özel elementler, akinoncloud.com kaynakları |
Selwise iki yığını da destekler ve çalışma zamanını otomatik olarak tanır.
Script kurulumu
| Yığın | Yer |
|---|---|
| Project Zero | base.html şablonu, body kapanışından önce |
| Omnife Next | _document.tsx veya ortak layout bileşeni |
Sepete ekleme
İki yığının sepet uç noktaları farklıdır:
| Yığın | Uç nokta |
|---|---|
| Project Zero | POST /baskets/basket/ |
| Omnife Next | POST /api/client/baskets/basket/ (proxy üzerinden, özel seçeneklerle) |
Selwise hangi yığında olduğunu tespit edip doğru uç noktayı kullanır; başarısız olursa diğerini dener. Bu davranış otomatiktir, yapılandırma gerektirmez.
CSRF token'ı ham göndermeyin
Project Zero'da window.GLOBALS.csrf_token, adının aksine bir token değildir — şablon onu tam bir gizli input HTML'i olarak render eder. Kendi kodunuzda bu değeri doğrudan X-CSRFToken başlığına koyarsanız sessiz bir 403 alırsınız. Selwise değeri ayrıştırıp içindeki gerçek token'ı kullanır.
dataLayer entegrasyonu
Integrations → Data Layer sayfasından akinon profilini seçin.
Project Zero'nun standart GTM adaptörü, birden fazla farklı olayı aynı event adıyla gönderir: ürün görüntüleme, ürün tıklama ve ürün gösterimlerinin üçü de eeEvent adıyla, dört checkout adımının hepsi eeCheckout adıyla gelir. Gerçek anlam, ecommerce nesnesindeki eylem anahtarındadır.
Akinon profili bu eşlemeyi bilir ve doğru event'e çevirir. Kendi eşlemenizi yazmanız gerekmez.
Sayfa tipi tespiti
Akinon'da sabit URL deseni olan sayfalar sınırlıdır:
| Sayfa | Desen | Güvenilir mi |
|---|---|---|
| Sepet | /baskets/basket, /basket | Evet |
| Ödeme | /orders/checkout | Evet |
| Arama | /list | Evet |
| Ürün | Mağazaya özel | Hayır |
| Kategori | Mağazaya özel | Hayır |
Ürün ve kategori URL'leri her mağazada Omnitron üzerinden serbestçe yapılandırılır ve sunucu tarafında yeniden yazılır. Bu yüzden ürün ve kategori sayfalarını URL deseniyle tespit etmeyin; kendi sitenizin gerçek yollarına bakarak kural yazın.
Varyantlı ürünler
Akinon'da bir ürün zaten SKU seviyesindedir: her beden ve ton kendi pk'sı,
kendi sku'su ve kendi ürün sayfasıyla ayrı bir üründür, base_code ise
yalnızca hangilerinin kardeş olduğunu söyler. Selwise bu modeli birebir alır —
her besleme satırı bir ürün olur.
Sepete ekleme, ürünün numerik pk'sıyla yapılır: POST /baskets/basket/
gövdesi product alanında bunu bekler ve sku'yu reddeder. Akinon hazır
eşleştirmesi bunu Sepete ekleme kodu satırında zaten pk olarak
kurar; kimlik ise sku kalır, çünkü raporlarınızın ve GA4 katmanınızın
tanıdığı kod odur — bkz. Varyant Gruplama.
Ürün beslemesi
Akinon projelerinde hazır bir Selwise beslemesi yoktur; beslemeyi üretmeniz gerekir. Google Merchant Center için ürettiğiniz besleme varsa doğrudan kullanabilirsiniz — bkz. Formatlar.
Mobil uygulama
Akinon mobil uygulamaları için ayrı bir SDK vardır — bkz. Mobil SDK. Uygulama içindeki WebView checkout akışı ayrıca köprülenmelidir: WebView Köprüsü.
Son güncelleme: 10 Eylül 2026