Shopify Komut Dosyalarına yönelik gereklilikler ve sınırlamalar

Güvenliği artırmak ve komut dosyalarının belirli bir zamanda mağazanızı kullanan müşteri sayısından bağımsız olarak çalışmasını sağlamak için Shopify Komut Dosyaları'na yönelik bazı sınırlamalar vardır. Shopify mağazanız için komut dosyaları geliştiriyorsanız aşağıdaki sınırlamaları göz önünde bulundurun.

Bu sayfada

Online mağaza ve Vitrin API'si

Bir komut dosyası oluştururken veya düzenlerken, bu komut dosyasının yalnızca online mağazanızda veya online mağazanızın yanı sıra aşağıdaki uygulamalarda da çalışmasını tercih edebilirsiniz:

Storefront API, JavaScript Buy SDK'sı veya Mobile Buy SDK'sı' (Android and iOS) ile geliştirilen özel uygulamalar
Ödeme sayfaları oluşturulan özel uygulamalar
Tapcart ve Plobal Apps mobil uygulama geliştiricileri

Komut dosyalarının çalışması için web sitenizin yerleşik bir alışveriş sepeti işlevine sahip olması gerekir. Bu nedenle, Satın Al Düğmeleri veya Facebook and Instagram by Meta satış kanalları ile komut dosyalarını kullanamazsınız.

Yayınlanmış komut dosyaları

Her komut dosyası türü için tek seferde yalnızca bir komut dosyası yayınlanabilir. Örneğin, bir satır öğesi ve bir kargo ücreti komut dosyası yayınlayabilirsiniz ancak aynı anda iki farklı satır öğesi komut dosyası yayınlayamazsınız.

Maksimum Shopify Komut Dosyası sayısı

En fazla 200 Shopify Komut Dosyası oluşturabilirsiniz.

Taslak siparişler

Satır öğesi komut dosyaları, kargo ücreti komut dosyaları ve ödeme komut dosyaları, taslak siparişlerde veya taslak siparişlerin ödeme sayfalarında çalışmaz.

Meta alanlar

Shopify Komut Dosyalarının Meta alanlara erişimi yoktur.

Sepet/ödeme sayfası özellikleri

Shopify Komut Dosyaları, Shopify Liquid sepet özelliklerine erişemez. Müşterilerinizden ilave bilgi toplamak için bu özellikleri sepet sayfalarınıza ekleyebilirsiniz ancak özellikleri kullanan bir komut dosyası oluşturamazsınız.

İndirim kodları

Komut dosyaları bir indirim kodunun uygulanıp uygulanmadığına, indirim tutarına ve indirim türüne (sabit tutar, yüzdelik tutar veya kargo indirimi gibi) erişebilir. Komut dosyaları, indirim kodunun uygulanma yöntemine (örneğin, sepete veya satır öğesine özel indirimler) erişemez. Bu, Komut Dosyalarının indirim sonrası toplamlara veya otomatik indirimlere erişemeyeceği anlamına gelir.

Sepete uygulanan indirimlere erişen satır öğesi ve kargo komut dosyaları, indirim kombinasyonlarıyla uyumlu değil. .discount_code yöntemi tek bir indirim kodu döndürebilir. İndirim kombinasyonlarının kullanıldığı birden fazla indirim kodu içeren sepetler desteklenmez.

Satır öğeleri

Komut dosyaları, sepete ürün ekleyemez veya bir ürünün fiyatını artıramaz.

Kargo ücretleri

Komut dosyaları, bir kargo ücretinin fiyatını artıramaz.

Çoklu para birimi

Komut dosyalarınız, çoklu para birimiyle beklendiği gibi çalışmayabilir. Komut dosyalarınızın, mağazanızın birincil para biriminden farklı para birimlerindeki sepetler veya ödemelerle çalışacağından emin olmak için komut dosyalarınızı Shopify Functions'a taşımanız gerekir.

Normal ifadeler

Normal ifade eşleştirme işlemi desteklenmemektedir. Bir satır öğesi komut dosyası oluşturacaksanız geçici bir çözüm olarak aşağıdaki yöntemlerden birini kullanabilirsiniz:

split yöntem
start_with ve end_with yöntemleri
include yöntem

Temalar

Komut dosyalarınızı desteklemek ve müşterilerinizin kafa karışıklığı yaşamasını önlemek için Liquid temanızı güncellemeniz gerekebilir. Örneğin, bazı temalar sepette satır öğesi indirimlerini göstermez. Siz de bu durumu yaşıyorsanız temanızı, sepetinizde satır öğesi indirimlerini gösterecek şekilde düzenlemeniz gerekir. Liquid temalarınızda yapabileceğiniz değişiklik türleri hakkında daha fazla bilgi edinin.

Kaynaklar

Bir komut dosyasına ayrılan işlemci ve bellek miktarı sınırlıdır. Bir komut dosyası için ayrılan kaynaklar, sepetin boyutuna ve komut dosyasının gerektirdiği hesaplama miktarına bağlıdır. Shopify, komut dosyalarınızın beklediğiniz şekilde çalışmasını sağlamak için bu kaynak sınırlarını yakından takip eder.

Siz bir komut dosyasını test ederken, Script Editor konsolu, komut dosyasına ayrılan kaynakların yüzdesini yazdırır.

Girdi/çıktı

Birkaç istisna dışında Shopify Komut Dosyaları girdi/çıktı özelliğine sahip değildir. Yani komut dosyaları, web taleplerini veya veritabanı çağrılarını yürütemez ve kullanıcıdan girdi alamaz.

Script Editor uygulamasının konsoluna metin yazdırmak için puts yöntemi kullanılabilir.

Zaman ve rastgelelik

Komut dosyaları rastgele veya zamana dayalı hesaplamalar içeremez. Time nesnesi ve rand yöntemine Shopify Komut Dosyaları erişemez.

Komut dosyaları bir sepetin toplam tutarındaki tüm yeniden hesaplanma işlemlerinde çalıştığı için zamana veya rastgele sayı oluşturmaya dayalı komut dosyaları, müşteriniz sepetinde çok sayıda değişiklik yaptığı zaman öngörülemez veya kafa karıştırıcı sonuçlar doğurabilir. Ancak Launchpad uygulamasını kullanarak komut dosyalarının etkinlikler boyunca çalışmasını planlayabilirsiniz.

Komut dosyası karakter sınırı

En fazla 40.960 karakterden oluşan komut dosyaları oluşturabilirsiniz.

Abonelik siparişleri

Satır öğesi ve kargo komut dosyalarınız bir abonelik ürünü için indirim oluşturursa bu indirim aşağıdaki ödemelere uygulanır:

Planlanan siparişlere uygulanmadan, yalnızca teslimat başına ödeme işleminin ilk ödemesi
Önceden ödenmiş bir abonelik sipariş tutarının tamamı

Abonelikler ve komut dosyaları hakkında daha fazla bilgi edinin.

Hızlı ödemeler

Hızlı ödeme içeren Shopify Komut Dosyaları kullanıyorsanız kargo ücreti indirimleri müşteriniz bir hızlı ödeme yöntemi seçtikten sonra uygulanır. Bu nedenle sipariş fiyatındaki değişiklikler müşterinin cihazına veya tarayıcısına yansımaz. Müşteriler, hızlı ödeme sayfasında orijinal fiyatı görmelerine rağmen doğru olan indirimli fiyatı öderler.

Shopify Point of Sale (POS)

Shopify Komut Dosyaları, Shopify Point of Sale (POS) ile çalışmaz.

Ödeme ağ geçitlerini yeniden adlandırma

Ağ geçidi adı olarak görsel veya logoların görüntülendiği ödeme ağ geçitlerini yeniden adlandıramazsınız. Adlarının yanında logo görselleri olan ödeme ağ geçitlerini yeniden adlandırabilirsiniz.

Ödeme sayfasında bölünmüş kargolar

Kargo komut dosyaları, Shopify Checkout'taki bölünmüş kargolarla uyumlu değildir. Kargo komut dosyalarını kullanıyorsanız ve bölünmüş kargoları etkinleştirirseniz ödemede müşterilerinize bölünmüş kargolar görüntülenmez.