Shopify’da sepete ekleme çalışmıyor: sorun nerede aranmalı?

Shopify’da sepete ekleme çalışmıyorsa önce belirtinin ne olduğunu ayırın: düğme kullanılamıyor mu, yanlış seçenek mi ekleniyor, istek hata mı veriyor, yoksa ürün eklendiği halde sepet görünümü mü değişmiyor? Ardından aynı ürünü, varyantı, miktarı ve cihazı kullanarak sorunu tekrarlayın. Ürün verisi, stok, tema ve uygulama katmanlarını bu kanıta göre ayırın.

Bu rehber Shopify temasıyla çalışan online mağazalar içindir. Özel geliştirilmiş farklı vitrinlerin sepet altyapısı ayrıca incelenir. Burada satın alma adımının doğruluğu ele alınır; genel sayfa hızı, ödeme sağlayıcısı kurulumu ve ödeme sayfası özelleştirmesi ayrı işlerdir.

İlk ayrım: ne oldu, ne olmadı?

“Düğme çalışmıyor” ifadesini gözlenen davranışa çevirin. Ürünün sepete gidip gitmediğiyle, sağdan açılan sepet panelinin güncellenip güncellenmediğini ayırmak ilk kontrolü ciddi biçimde daraltır.

Bu tablo bir mağazada yapılmış testin sonucu değildir. Nereden kanıt toplanacağını gösterir; çözüm gerçek bulguya göre seçilir.

1. Aynı sorunu kısa adımlarla tekrarlayın

Tek bir ürünle başlayın. Varyant, ürünün beden, renk veya hacim gibi satın alınabilir seçeneğidir. Ürün adının yanında o seçeneği ve miktarı da yazın. “Siyah / M, 1 adet” kaydı, yalnız ürün bağlantısından daha açıklayıcıdır.

Sayfayı açın, seçimi yapın, bir kez ekleyin ve sonucu görün. Başlangıçta sepette aynı ürün olup olmadığını kaydedin. Sonra yeni bir tarayıcı oturumuyla karşılaştırın. Önbellek veya uzantı olasılığını görmek için farklı tarayıcı ve cihaz kullanın; tek bir cihazda düzelmesi bütün müşterilerde çözüldüğünü göstermez.

Sorun yalnız koleksiyon kartındaki hızlı eklemede, yalnız ürün sayfasının altındaki sabit alanda veya yalnız uygulama içi tarayıcıda olabilir. Ana ürün formu çalışıyor diye bu yolları otomatik olarak sağlıklı saymayın. Shopify’ın tema sorunlarını araştırma rehberi, cihazı ve temayı karşılaştırmayı bu ayrım için önerir.

2. Ürün seçeneği gerçekten satılabilir mi?

Ürünün Aktif olmasını, Online Store kanalında yayımlanmasını ve seçilen varyantın mevcut olmasını kontrol edin. Katalogda artık olmayan bir seçeneğe eski bir düğme veya uygulama hâlâ işaret ediyor olabilir. Bu durumda başka bir varyantı gelişigüzel göndermek müşterinin istediği ürünü değiştirebilir.

Stokta sıfır görülen seçeneğin eklenememesi, stok yokken satış kapalıysa beklenen davranıştır. Shopify’ın stok yokken satış belgesi bu koşulu açıklar. Hatayı aşmak amacıyla stok takibini kapatmayın veya satışa devam seçeneğini açmayın. Bu seçenek ancak markanın gerçekten karşılayabildiği ön sipariş veya tedarik düzenine göre belirlenmelidir.

Birden fazla konum varsa toplam stoku online sipariş için kullanılabilir stokla karıştırmayın. Fiziksel mağazaya ayrılmış adetler online satışa açık olmayabilir. Shopify’ın çok konumlu stok belgesi, online sipariş karşılamayan konumların stoklarının online miktara dahil olmadığını açıklar.

Müşterinin sepetinde aynı varyanttan zaten birkaç adet bulunması da yeni miktarın kabul edilmesini etkileyebilir. “Bir adet daha eklenmiyor” ile “ürün hiç alınamıyor” aynı durum değildir. Paket, abonelik veya miktar kuralı kullanan üründe o kurala uygun seçim yapıldığını da doğrulayın.

3. İstek mi başarısız, ekrandaki görünüm mü?

Bu bölüm gerektiğinde geliştiriciyle birlikte uygulanabilir. API, Application Programming Interface, uygulama programlama arayüzüdür; tarayıcıdaki temanın Shopify’dan sepete ürün eklemesini veya sepet içeriğini istemesini sağlayan iletişim yoludur. Mağaza sahibinin temel kontrolü, seçilen ürünle sepet satırını karşılaştırmaktır; geliştirici bu iletişimi inceleyerek kaynağı daraltır.

Tarayıcının geliştirici araçlarındaki Network, yani ağ istekleri bölümünde tek ekleme işleminin sonucuna bakılır. Tema sayfayı yenilemeden ekliyorsa sepet ekleme isteğinin gidip gitmediği, gönderilen varyant ve miktar, yanıt kodu ve hata açıklaması birlikte incelenir. Bazı temalar normal form gönderimi kullanabilir; her mağazada aynı istek görünümünü beklemeyin.

Shopify’ın sepet teknik belgesi, bulunamayan varyant, tükenmiş ürün ve mevcut miktarı aşma gibi durumların hata açıklamalarını ayrı verir. Miktar stoktan fazlaysa kullanılabilir miktar eklenirken hata dönmesi mümkündür. Bu nedenle hata görmek “sepette kesinlikle hiçbir şey değişmedi” demek değildir.

Başarılı yanıt da istenen varyantın gönderildiğini tek başına kanıtlamaz. Yanlış seçenek başarıyla eklenebilir. Ekrandaki seçim, gönderilen veri ve sepet satırı üçlü olarak karşılaştırılmalıdır.

4. Tema ile uygulama etkisini kontrollü karşılaştırın

Sorunun ilk görüldüğü zamanla son tema/uygulama değişikliklerini karşılaştırın. Zaman yakınlığı sebebi kanıtlamaz; ancak ilk denemeyi daraltabilir. Kullanılan temanın kopyasını alın ve değişiklikleri yayımlanmamış önizlemede inceleyin. Gerekirse temiz, güncel bir tema önizlemesinde aynı ürünü ve seçeneği deneyin.

Özel temada hata olup temiz temada olmaması, araştırmayı tema kodu ve o temada çalışan uygulama parçalarına yönlendirir. Bütün temalarda görülmesi ise ürün, stok, hesap koşulu veya tüm mağazayı etkileyen uygulama davranışını araştırmayı gerektirir. Bu karşılaştırma tek başına belirli bir uygulamanın suçlu olduğunu göstermez.

Tema kopyası katalog, stok ve uygulamanın yönetim tarafındaki ayarlarını ayrı bir mağazaya taşımaz. Bu nedenle kopyada çalışırken de ürün stoklarını veya uygulamanın genel kurallarını değiştirmenin canlı etkisini değerlendirin. Önce yalnız tema içindeki ilgili blok veya uygulama yerleşimini kontrollü biçimde karşılaştırın. Canlı mağazadaki bütün uygulamaları aynı anda kaldırmak hem yeni sorun yaratabilir hem hangi değişikliğin etkili olduğunu belirsiz bırakır.

Hata belirli bir eski dosyaya kadar daraltıldıysa eski sürümü geri almak değerlendirilebilir. Bütün dosyayı değiştirmek daha yeni ve geçerli düzenlemeleri de silebilir; mevcut kaynağı koruyup hangi farkın geri alınacağını belirleyin. Genel tema yenileme kararı için tema güncellemesi rehberi ayrı kapsam sunar.

Dolu teşhis örneği: ürün ekleniyor, yan sepet boş kalıyor

Temsili bir gömlek mağazasında M/siyah seçimi sonrası düğme bekleme durumunda kalsın. Kullanıcı yeniden basınca miktar ikiye çıksın. Bu varsayımsal örnek gerçek bir müşteri kaydı değildir.

1. Yeni oturumda tek tıklamayla deneyin. Tam sepet sayfasında M/siyah, 1 adet bulunduğunu; yan panelin ise boş kaldığını varsayalım.
2. Ağ kaydında bir ekleme isteği ve başarılı yanıt görülüyorsa ilk araştırma alanı stok değildir. Panelin sonucu neden göstermediği ve düğmenin bekleme durumundan neden çıkmadığı incelenir.
3. Yayımlanmamış tema kopyasında son sepet görünümü değişikliğini karşılaştırın. Hangi farkın sorunu oluşturduğu kanıtlanmadan bütün temayı geri almayın.
4. Düzeltmeden sonra panelin doğru satırı gösterdiğini, sayacın güncellendiğini ve düğmenin yeniden kullanılabilir olduğunu kontrol edin. Tek tıklamada iki adet eklenmediğini de doğrulayın.
5. Sonucu “aynı senaryoda doğru ürün bir kez ekleniyor ve görünür geri bildirim oluşuyor” diye kaydedin. Buradan satış artışı veya bütün sepet yollarının düzeldiği sonucu çıkarmayın.

Bu örnek, yeniden deneme alışkanlığının neden doğru teşhisten önce gelmemesi gerektiğini gösterir. Önce sepetin gerçek içeriğine bakın.

Düzeltmeyi hangi senaryolarla kabul edeceksiniz?

Tek başarılı tıklama yeterli kontrol değildir. Hatanın görüldüğü yolu yeniden deneyin; ardından o değişikliğin etkileyebileceği yakın alışveriş yollarını kontrol edin. Her ürünü rastgele denemek yerine farklı durumları temsil eden küçük bir küme seçin.

Destek talebine ürün bağlantısı, varyant, miktar, tarayıcı, kısa tekrar adımları, beklenen/gerçek sonuç ve hata açıklamasını ekleyin. Sepet anahtarı, müşteri bilgisi veya özel oturum verisi içeren kayıtları açık ortamda paylaşmayın; destek için gereken bölümü ayırın.

Sorun birden fazla geliştirme isteğiyle birlikte duruyorsa geliştirme işlerini önceliklendirme rehberini kullanın. Tekrar üretilebilen satın alma hatasını Shopify tasarım ve geliştirme kapsamında, hangi işlemin yeniden doğru çalışacağı açık bir kabul koşuluyla ele almak mümkündür. İşlevin düzeldiği kontrol edilir; satış etkisi için ayrıca uygun veri gerekir.