Checkout Blocks içeriğinizdeki hataları giderme

Checkout Blocks içeriğiniz, çeşitli nedenlerle beklendiği gibi görüntülenmeyebilir. Bu durum, öğelerin kaybolmasına veya düzgün çalışmamasına neden olur. Görüntüleme kurallarının karşılanmaması, izin yapılandırmalarındaki hatalar veya bloğun kendi ayarlarıyla ödeme ve hesaplar düzenleyicisine eklenme şekli arasındaki tutarsızlıklar sık karşılaşılan sorunlardır.

Bu kılavuz, sık karşılaşılan Checkout Blocks sorunlarını kendiniz gidermenize ve çözmenize yardımcı olur. Bu kılavuzdaki adımları inceledikten sonra hâlâ sorun yaşıyorsanız yardım için Shopify Destek ekibiyle iletişime geçin.

Bu sayfada

Bloklardaki hataları giderme

Bloklar, ödeme sayfanızda özel alanlar, dinamik içerikler ve banner'lar gibi içerikleri görüntüleyen özelleştirme öğeleridir. Bir blok beklendiği gibi çalışmıyorsa sorunu belirleyip çözmek için aşağıdaki bölümleri kullanın.

Blok, ödeme sayfasında görüntülenmiyor

Düzenleyiciye eklenmeyen bloktaki hatayı giderme

Checkout Blocks uygulamasında blok oluşturmak, bloğu ödemenize otomatik olarak eklemez. Bloğu, ödeme ve hesaplar düzenleyicisini kullanarak ödeme yapılandırmanıza eklemeniz gerekir.

Adımlar:

Shopify yöneticinizden Ayarlar > Ödeme bölümüne gidin.

Yapılandırmalar bölümünde, değiştirmek istediğiniz yapılandırmanın yanındaki Özelleştir seçeneğine tıklayın.

Bloğun görüntülenmesini istediğiniz ödeme sayfasına gidin.

⊕ Blok ekle'ye tıklayın ve uygun blok türünü seçin.

Blok Kimliğini, Checkout Blocks'ta oluşturduğunuz bloğun kimliğiyle eşleşecek şekilde yapılandırın.

Kaydet'e tıklayın.

Etkin olarak ayarlanmayan bloktaki hatayı giderme

Bir bloğun ödeme sayfasında görüntülenmesi için Etkin olarak ayarlanması gerekir. Taslak bloklar müşterilere gösterilmez.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

Etkinleştirmek istediğiniz bloğa tıklayın.

Durum bölümünde Etkin'i seçin.

Kaydet'e tıklayın.

Pazarda veya sayfada yayınlanmayan bloktaki hatayı giderme

Bloğunuz pazara özel yayınlama ayarlarıyla yapılandırılmışsa yalnızca seçtiğiniz pazarlarda görüntülenir. Blok yalnızca belirli ödeme sayfalarında yayınlanmışsa diğer sayfalarda görüntülenmez.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

İncelemek istediğiniz bloğa tıklayın.

Yayınlama bölümünde, bloğun geçerli tüm pazarlarda yayınlandığını doğrulayın.

Ödeme sayfaları bölümünde, bloğun geçerli tüm ödeme sayfalarında görüntülenecek şekilde ayarlandığını doğrulayın.

Kaydet'e tıklayın.

Karşılanmayan görüntüleme kurallarındaki hatayı giderme

Görüntüleme kuralları, bir bloğun ödemede görüntülenmesi için karşılanması gereken koşulları tanımlar. Bir müşterinin ödeme oturumu sırasında bu koşullar karşılanmazsa blok görüntülenmez.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

Görüntülenmeyen bloğa tıklayın.

Blok için yapılandırılmış görüntüleme kurallarını inceleyin.

Test ödemenizin sepet toplamı eşikleri, ürün türleri veya müşteri giriş yapma durumu gibi gerekli tüm koşulları karşılayıp karşılamadığını doğrulayın.

Yalnızca şu durumda göster: Tüm kurallar geçerli ayarını seçtiyseniz her kuralın karşılandığından emin olun. Yalnızca şu durumda göster: Herhangi bir kural geçerli ayarını seçtiyseniz en az bir kuralın karşılandığından emin olun.

Blok Kimliği uyuşmazlığındaki hatayı giderme

Ödeme ve hesaplar düzenleyicisindeki her blok türünün bir Blok Kimliği ayarı vardır. Düzenleyicideki Blok Kimliği, Checkout Blocks uygulamasında oluşturduğunuz bloğun Blok Kimliği ile eşleşmelidir. Kimlikler eşleşmezse blok görüntülenmez.

Örneğin, bloğunuzun Checkout Blocks uygulamasındaki Blok Kimliği 4 ise ödeme ve hesaplar düzenleyicisindeki bloğun Blok Kimliğinin de 4 olarak ayarlanması gerekir.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

Görüntülenmeyen bloğa tıklayın ve Blok Kimliğini not edin.

Ayarlar > Ödeme bölümüne gidin.

Yapılandırmalar bölümünde, kontrol etmek istediğiniz yapılandırmanın yanındaki Özelleştir seçeneğine tıklayın.

Düzenleyicide, içeriğinizi görüntülemesi gereken bloğa tıklayın.

Blok ayarları bölümünde, Blok Kimliğinin 3. adımdaki kimlikle eşleştiğini doğrulayın.

Kimlikler eşleşmiyorsa Blok Kimliğini eşleşecek şekilde güncelleyin.

Kaydet'e tıklayın.

"Blok kimliğini önizle" alanının değer içermesiyle ilgili hatayı giderme

Ödeme ve hesaplar düzenleyicisindeki Blok kimliğini önizle (Test amacıyla) alanı yalnızca test amaçlıdır. Ödemenizi kaydettikten sonra bu alan bir değer içeriyorsa bloğunuzun görüntüleme kurallarını geçersiz kılabilir ve beklenmedik davranışlara neden olabilir.

Adımlar:

Shopify yöneticinizden Ayarlar > Ödeme bölümüne gidin.

Yapılandırmalar bölümünde, kontrol etmek istediğiniz yapılandırmanın yanındaki Özelleştir seçeneğine tıklayın.

Doğru görüntülenmeyen bloğa tıklayın.

Blok kimliğini önizle (Test amacıyla) alanında, alan boş kalacak şekilde tüm değerleri silin.

Kaydet'e tıklayın.

Bunun yerine daha yüksek öncelikli bir bloğun görüntülenmesiyle ilgili hatayı giderme

Çakışan görüntüleme kurallarına sahip, aynı türde birden fazla bloğunuz varsa yalnızca en yüksek öncelikli blok görüntülenir. Blok önceliği hakkında daha fazla bilgi edinin.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

⇅ Önceliği düzenle seçeneğine tıklayın.

Görüntülenmeyen blok türünü seçin.

Öncelik sırasını inceleyin. Daha düşük numaralı blokların önceliği daha yüksektir.

Hangi bloğun ilk olarak görüntüleneceğini değiştirmek için Öncelik numaralarını ayarlayın.

Kaydet'e tıklayın.

Aktif blok sınırına ulaşıldığında hata giderme

Checkout Blocks, her blok türü için en fazla 30 aktif bloğu destekler. Tek bir türde 30'dan fazla aktif bloğunuz varsa (örneğin 35 adet aktif özel alan bloğu), ödeme sayfasında yalnızca ilk 30 blok görüntülenebilir.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Bloklar'a tıklayın.

Hata gidermeye çalıştığınız blok türüne göre filtreleyin.

Aktif blokların sayısını sayın.

30'dan fazla aktif bloğunuz varsa artık ihtiyaç duymadığınız blokları devre dışı bırakın veya silin.

Blok, ödeme sayfasında birden çok kez görüntüleniyor

Paylaşılan bölüme eklenen blokta hata giderme

Ödeme ve hesaplar düzenleyicisinde bir bloğu nereye eklediğinize bağlı olarak, blok ödeme işleminin her adımında görüntülenebilir. Sipariş özeti bölümü ve Devam et veya geri dön düğmesine ekli alan, tüm ödeme sayfalarında tutarlıdır.

Bir bloğu yalnızca belirli bir adımda görüntülemek için bloğu o adımın ana içerik alanına ekleyin.

Adımlar:

Shopify yöneticinizden Ayarlar > Ödeme bölümüne gidin.

Yapılandırmalar bölümünde, değiştirmek istediğiniz yapılandırmanın yanındaki Özelleştir'e tıklayın.

Birden çok kez görüntülenen bloğa tıklayın.

Bloğun hangi bölümde olduğuna dikkat edin. Blok, Sipariş özeti bölümündeyse veya Devam et veya geri dön düğmesine ekliyse her ödeme sayfasında görüntülenir.

Bloğu yalnızca belirli bir sayfada görüntülemek için bloğu mevcut bölümden kaldırın ve istediğiniz ödeme sayfasının ana içerik alanına ekleyin.

Kaydet'e tıklayın.

Eklenen birden fazla blok örneğinde hata giderme

Satır öğesi düzenleme blokları gibi bazı blok türlerinin genellikle ödeme sayfasına yalnızca bir kez eklenmesi gerekir. Blok, farklı senaryolar için farklı içerikler görüntülemek üzere görüntüleme kurallarına dayanır. Blok içeriği yineleniyorsa bloğu yanlışlıkla gerekenden daha fazla sayıda eklemiş olabilirsiniz.

Adımlar:

Shopify yöneticinizden Ayarlar > Ödeme bölümüne gidin.

Yapılandırmalar bölümünde, kontrol etmek istediğiniz yapılandırmanın yanındaki Özelleştir seçeneğine tıklayın.

Ödeme sayfanızın her sayfasında gezinin ve eklenmiş olan blokları inceleyin.

Aynı türde ve Blok Kimliğinde yinelenen bloklar bulursanız bloğa tıklayıp Bloğu kaldır'ı seçerek fazlalıkları kaldırın.

Kaydet'e tıklayın.

Blokları oluştururken veya kaydederken karşılaşılan hataları giderme

Bir bloğu oluşturmaya veya kaydetmeye çalışırken bir hatayla karşılaşırsanız aşağıdaki bölümleri inceleyin.

"Form gönderiminizle ilgili bazı sorunlar vardı" hatasını giderme

Bu hata genellikle personel hesabınızın Checkout Blocks'ta blok oluşturmak için gereken izinlere sahip olmadığını gösterir.

Gerekli izinler:

Mağaza izinleri > İçerik: Personelin, meta nesne tanımlarını Görüntüleme ve Oluşturma ve düzenleme iznine, ayrıca girdileri Görüntüleme ve Oluşturma ve düzenleme iznine sahip olması gerekir.
Mağaza izinleri > Mağaza ayarları: Personelin, Ayarları yönet iznine sahip olması gerekir.
Uygulama izinleri: Personelin en azından Checkout Blocks için izinlere sahip olması gerekir.

Adımlar:

Shopify yöneticinizden Ayarlar > Kullanıcılar ve izinler bölümüne gidin.
Hatayla karşılaşan personel hesabına tıklayın.
Mağaza izinleri'nin altında İçerik bölümünü genişletin.
Meta nesne tanımları için Görüntüleme ve Oluşturma ve düzenleme izinlerinin seçili olduğunu doğrulayın.
Girdiler için Görüntüleme ve Oluşturma ve düzenleme izinlerinin seçili olduğunu doğrulayın.
Mağaza ayarları'nın altında Ayarları yönet'in seçili olduğunu doğrulayın.
Uygulama izinleri'nin altında Checkout Blocks'un seçili olduğunu doğrulayın.
Kaydet'e tıklayın.

Personel izinlerini değiştirme izniniz yoksa mağaza sahibiyle veya kullanıcı yönetimi izinlerine sahip bir personelle iletişime geçin.

Özel indirimlerle ilgili hata giderme

Checkout Blocks'ta oluşturulan özel indirimler, çeşitli faktörler nedeniyle beklendiği gibi uygulanmayabilir.

Aktif otomatik indirim sınırına ulaşıldığında hata giderme

Shopify, yüklü tüm uygulamalardan gelen uygulama tabanlı indirimler de dahil olmak üzere, aynı anda en fazla 25 aktif otomatik indirime izin verir. Bu sınır yalnızca Checkout Blocks için değil, tüm mağazanız için geçerlidir.

26. bir otomatik indirimi etkinleştirmeye çalışırsanız bu indirim, ödeme sayfasında uygulanmaz.

Adımlar:

Shopify yöneticinizden İndirimler bölümüne gidin.
Yalnızca Otomatik indirimleri görüntülemek için filtreleyin.
Şu anda kaç tane otomatik indirimin aktif olduğunu sayın.
25 veya daha fazla aktif otomatik indiriminiz varsa yenilerini etkinleştirmeden önce artık ihtiyaç duymadığınız indirimleri devre dışı bırakın veya silin.

İndirimleri birleştirirken geçerli olan sınırlamalar hakkında daha fazla bilgi edinin.

İndirimin aktif olmamasıyla ilgili hata giderme

Ödeme sayfasında uygulanabilmesi için özel bir indirimin Aktif olarak ayarlanması gerekir. Ayrıca, yapılandırılan başlangıç ve bitiş tarihlerine göre indirimin süresinin dolmamış olması gerekir.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

İndirimler'e tıklayın.

Uygulanmayan indirime tıklayın.

Durum bölümünde, indirimin Aktif olarak ayarlandığını doğrulayın.

Aktif tarihler bölümünde, geçerli tarihin, yapılandırılmış başlangıç ve bitiş tarihleri aralığında olduğunu doğrulayın.

Kaydet'e tıklayın.

İndirim kurallarının karşılanmamasıyla ilgili hata giderme

Checkout Blocks'taki özel indirimler, indirimin ne zaman uygulanacağını belirleyen ayrıntılı koşullu kurallara sahip olabilir. Müşterinin ödeme oturumu sırasında bu koşullar karşılanmazsa indirim uygulanmaz.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

İndirimler'e tıklayın.

Uygulanmayan indirime tıklayın.

İndirim için yapılandırılmış kuralları ve koşulları inceleyin.

Test ödemenizin minimum sipariş değeri, belirli ürünler veya koleksiyonlar ya da müşteri uygunluğu gereklilikleri gibi gerekli tüm koşulları karşılayıp karşılamadığını doğrulayın.

İndirim kurallarını gerektiği gibi ayarlayın.

Kaydet'e tıklayın.

Teslimat ve ödeme yöntemi özelleştirmelerinde hata giderme

Teslimat veya ödeme yöntemleri beklendiği gibi gizlenmiyor, yeniden adlandırılmıyor ya da yeniden sıralanmıyorsa aşağıdaki bölümleri inceleyin.

Özelleştirmenin etkin olmaması sorununu giderme

Bir teslimat veya ödeme yöntemi özelleştirmesinin, ödeme sayfasında uygulanabilmesi için Etkin olarak ayarlanması gerekir.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Functions'a tıklayın.

Çalışmayan özelleştirmeye tıklayın.

Durum bölümünde, özelleştirmenin Etkin olarak ayarlandığını doğrulayın.

Kaydet'e tıklayın.

Etkin Functions sınırına ulaşılması sorununu giderme

Shopify Functions'ta, tür başına sahip olabileceğiniz etkin işlevlerin sayısı sınırlıdır. Her mağazada en fazla 25 ödeme kişiselleştirme işlevini etkinleştirebilirsiniz. Bu sınırı aşarsanız şu hatayı alabilirsiniz: Kişiselleştirme etkinleştirilemedi. Lütfen tekrar deneyin veya destek ekibiyle iletişime geçin.

Bu sınırlar, ödeme sayfasının yüksek performansı sürdürmesini sağlamaya yardımcı olur. Sınırın altında kalmak için özelleştirmeleri birleştirmeniz veya kaldırmanız gerekir.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Functions'a tıklayın.

Teslimatla ilgili hata gideriyorsanız kaç tane etkin teslimat yöntemi özelleştirmeniz olduğunu, ödemeyle ilgili hata gideriyorsanız ise kaç tane etkin ödeme yöntemi özelleştirmeniz olduğunu sayın.

Bu tür için sınıra ulaştıysanız artık ihtiyaç duymadığınız özelleştirmeleri devre dışı bırakın veya silin.

Yeni özelleştirmenizi yeniden etkinleştirmeyi deneyin.

Özelleştirme kurallarının karşılanmaması sorununu giderme

Teslimat ve ödeme yöntemi özelleştirmeleri, özelleştirmenin ne zaman uygulanacağını belirleyen kurallara dayanır. Bir müşterinin ödeme oturumu sırasında bu koşullar karşılanmazsa özelleştirme geçerli olmaz.

Adımlar:

Shopify yöneticinizden Uygulamalar > Checkout Blocks bölümüne gidin.

Functions'a tıklayın.

Çalışmayan özelleştirmeye tıklayın.

Özelleştirme için yapılandırılan kuralları inceleyin.

Test ödemenizin gerekli tüm koşulları karşılayıp karşılamadığını doğrulayın.

Kuralları gerektiği gibi ayarlayın.

Kaydet'e tıklayın.

Değişikliklerinizi test ödemesiyle doğrulama

Checkout Blocks özelleştirmelerinize canlı bir ortamda güvenmeden önce, bir test ödemesi kullanarak bunların beklendiği gibi çalıştığını doğrulamanız gerekir.

Adımlar:

Online mağazanızdan, test etmek istediğiniz bloklar, indirimler veya özelleştirmelerin koşullarıyla eşleşen ürünleri sepetinize ekleyin.
Ödeme sayfasına ilerleyin ancak satın alımı tamamlamayın.
Ödeme sayfasının her adımını inceleyin ve aşağıdakileri doğrulayın:
- Blokların doğru içerikle doğru konumlarda görüntülenmesi.
- Uygunluk gereklilikleri karşılandığında özel indirimlerin uygulanması.
- Teslimat ve ödeme yöntemi özelleştirmelerinin beklendiği gibi çalışması.
Sepet toplamına dayalı görüntüleme kurallarını test ediyorsanız blokların doğru eşiklerde görünüp kaybolduğunu doğrulamak için farklı sepet değerlerini deneyin.
Müşteri tabanlı görüntüleme kurallarını test ediyorsanız hem oturum açmış hem de misafir olarak ödeme senaryolarını test edin.

Sıkça sorulan sorular

Aynı anda kaç bloğu etkinleştirebilirim?

Blok türü başına en fazla 30 etkin bloğunuz olabilir. Örneğin, aynı anda 30 etkin özel alan, 30 etkin dinamik içerik bloğu ve 30 etkin satır öğesi düzenleme bloğunuz olabilir. Bir türde 30'dan fazla blok oluşturabilirsiniz ancak ödeme sayfasında yalnızca ilk 30 etkin blok görüntülenebilir.

Checkout Blocks'u kullanmak için neden belirli personel izinlerine ihtiyacım var?

Checkout Blocks, blok yapılandırmalarını depolamak için meta nesne tanımları oluşturur. Personel üyelerinin, uygulamada blokları kaydedebilmek için meta nesne tanımları ve girişleri oluşturma ve düzenleme izinlerine ihtiyacı vardır. Ayrıca personelin, Checkout Blocks için Mağaza ayarları altındaki Ayarları yönetme iznine ve açık Uygulama izinlerine ihtiyacı vardır.

Shopify Plus planında değilsem Checkout Blocks'u kullanabilir miyim?

Basic planındaki veya daha yüksek bir plandaki satıcılar, dinamik içerik ve statik içerik bloklarını yalnızca Teşekkür ve Sipariş durumu sayfalarında kullanabilir. Özel alanlar, özel indirimler ve teslimat/ödeme yöntemi kişiselleştirmeleri dahil olmak üzere diğer tüm Checkout Blocks özellikleri için Shopify Plus planı gerekir.

Hangi Blok Kimliğini kullanacağımı nasıl anlarım?

Checkout Blocks uygulamasında bir blok oluşturduğunuzda bu bloğa bir Blok Kimliği atanır (varsayılan değer 0'dır). Düzenleyicinin hangi bloğu görüntüleyeceğini bilmesi için bu blok türünü düzenleyicide ödemenize eklerken aynı Blok Kimliğini ayarlamanız gerekir. Aynı türdeki farklı blokları farklı konumlarda görüntülemek isterseniz her bloğa benzersiz bir Blok Kimliği atayın ve bu kimlikleri düzenleyicide eşleştirin. Blok Kimlikleri hakkında daha fazla bilgi edinin.

Checkout Blocks indirimlerini diğer indirimlerle birleştirebilir miyim?

Checkout Blocks'ta oluşturulan özel indirimler, Shopify Functions tarafından desteklenen otomatik indirimlerdir. Diğer otomatik indirimlerle aynı indirim birleştirme kurallarına uyarlar. Checkout Blocks'ta ve diğer uygulamalarda oluşturulanlar da dahil olmak üzere mağazanız genelinde en fazla 25 adet etkin otomatik indiriminiz olabilir.

Checkout Blocks hakkında Shopify Destek ekibiyle iletişime geçmeden önce

Yukarıdaki hata giderme adımlarını denemenize rağmen Checkout Blocks sorununuz devam ediyorsa yardım için Shopify Destek ekibiyle iletişime geçebilirsiniz. Shopify Destek ekibiyle iletişime geçmeden önce, sorununuzu daha hızlı çözmeye yardımcı olması için Checkout Blocks'a özgü aşağıdaki bilgileri toplayın:

Blok ayrıntıları: Çalışmayan bloğun adı, türü (özel alan, dinamik içerik veya satır öğesi düzenleme gibi) ve Blok Kimliği
Yapılandırma ekran görüntüleri: Görüntüleme kuralları, yayınlama ayarları ve durumu da dahil olmak üzere, bloğun Checkout Blocks uygulamasındaki ayarlarının ekran görüntüleri
Düzenleyici ekran görüntüleri: Blok Kimliği ve Önizleme bloku kimliği alanları da dahil olmak üzere, bloğun ödeme ve hesaplar düzenleyicisinde nasıl yapılandırıldığına ilişkin ekran görüntüleri
Hata mesajları: Blokları oluştururken, kaydederken veya önizlerken aldığınız tüm hata mesajlarının ekran görüntüleri veya tam metni
Test ödemesi URL'si: Sorunun yeniden oluşturulabildiği bir test ödemesi veya yarım bırakılmış ödeme bağlantısı ve görüntüleme kurallarını tetiklemek için kullanılan sepet içerikleri.
Beklenen davranış ve gerçekleşen davranış: Ödeme sayfasında ne olmasını beklediğiniz ile gerçekte ne olduğuna ilişkin net bir açıklama.
Tamamlanan hata giderme adımları: Bu kılavuzdan hangi bölümleri incelediğiniz ve neleri denediğiniz.
Personel izinleri: Hesabınızın İçerik (meta nesne tanımları ve girişleri), Mağaza ayarları (Ayarları yönetme) ve Uygulama izinleri (Checkout Blocks) için gerekli izinlere sahip olduğunun doğrulanması

Checkout Blocks'a özgü bu bilgileri hazır bulundurmanız, Shopify Destek ekibinin sorununuzu daha verimli bir şekilde teşhis edip çözmesine yardımcı olur.