Bir Shopify İndirim Fonksiyonunu başarıyla dağıtmak, onun çalıştığı anlamına gelmez. Yapı geçer, uygulama yüklenir ve ödeme tam fiyatla ve hata mesajı olmaksızın tamamlanır. Başarısızlığın bu sınıfının tanımlayıcı özelliği budur: tasarım gereği sessizdir, çünkü indirim motoru hiçbir şey döndürdüğünde ödeme kilitlenmesi gerekli değildir.
Shopify Scripts 30 Haziran 2026'da çalışmayı durdurduğundan bu yana, zaman baskısı altında göç ettiren her mağazanın aşağıdaki beş başarısızlık modunun en az birini yaşamıştır. Karmaşık katmanlı fiyatlandırmaya sahip mağazalarda bu beşin de varyantlarında hata ayıklaması yaptım. Tam olarak neye bakmanız gerektiğini anlatayım.
Önemli noktalar
- Doğru şekilde dağıtılan bir Fonksiyon, Admin'de Etkin bir indirim düğümü var olana ve ona bağlanana kadar hiçbir şey yapmaz.
- Ruby Script'inizin okuduğu her alan
input.graphql'de görünmeli veyanulldöner, sessizce koşulunuzu çevirir. combinesWithFonksiyon kodunuzda değil, indirim düğümünde ayarlanır; yanlış yapılandırılmış bir düğüm iki istiflenmiş indirimden sadece birinin ateşlenmesi anlamına gelir.- Fonksiyonlar eş zamanlı olarak çalışır ve birbirinden habersizdir;
selectionStrategytüm mağaza genelinde değil, bir Fonksiyon içinde hangi adayın kazanacağını yönetir. - 2026-04 GraphQL API sürümü, sepet, satır öğesi ve teslimat grubu düzeylerinde tam indirim tahsisi görünürlüğü ekledi; eski bir API sürümündeyseniz mantığınızın bağlı olduğu verileri kaçırıyorsunuz.
Zaman çizelgesi, kısaca
Shopify, Scripts'in kullanımdan kaldırılması son tarihinin Script düzenleme veya yayınlama için 15 Nisan 2026, sert yürütme kesintisi ise 30 Haziran 2026 olduğunu duyurdu. Son tarih bundan önce iki kez uzatılmıştı (aslen Ağustos 2024, sonra Ağustos 2025) ancak Shopify 30 Haziran 2026'nın kesin olduğunu onayladı. Göç etmeyen mağazalar, indirim, kargo ve ödeme mantıklarının ödeme sırasında hiçbir mağaza ön yüzü uyarısı olmaksızın ve hiçbir admin başlığı olmaksızın sessiz hale geldiğini gördüler.
Eğer bunu Temmuz 2026'dan sonra okuyorsanız, Script'leriniz kesinlikle artık çalışmıyor. Soru, değiştirme Fonksiyonlarınızın çalışıp çalışmadığıdır.
Beş sessiz başarısızlık modu
1. Fonksiyon dağıtıldı ama indirim düğümü yok
Bu gördüğüm en yaygın neden. Bir Fonksiyon kendi başına yürütülmez. Yalnızca DiscountAutomaticApp veya DiscountCodeApp düğümü Admin'de mevcut olduğunda, Etkin olarak ayarlandığında ve Fonksiyon ona bağlanmışsa çalışır.
Düğümü Admin'de İndirimler > İndirim oluştur > [uygulamanız] altında veya discountAutomaticAppCreate GraphQL mutasyonuyla oluşturabilirsiniz:
mutation {
discountAutomaticAppCreate(automaticAppDiscount: {
title: "Tiered Volume Discount"
functionId: "YOUR_FUNCTION_ID"
startsAt: "2026-07-01T00:00:00Z"
combinesWith: {
orderDiscounts: true
productDiscounts: false
shippingDiscounts: true
}
}) {
automaticAppDiscount {
discountId
}
userErrors { field message }
}
}
Nasıl doğrulayacaksınız: Admin > İndirimler'e gidin. Fonksiyon destekli indiriminiz için bir satır yoksa veya durum Etkin yerine Zamanlandı olarak gösteriliyorsa, Fonksiyon çağrılmıyor.
2. input.graphql'de gerekli alan eksik
Bu en dayanıklı başarısızlıktır. Fonksiyon mantığınız doğrudur, ancak değerlendirdiği dal null olan bir alanı okuyor çünkü bunu input.graphql'de hiç istemediniz. Fonksiyon sessizce yanlış yolu alır ve indirim döndürmez.
Script'inizdeki her koşulun, giriş sorgusunda görünmesi gereken karşılık gelen bir alanı vardır. Ruby'den göçten sonra yaygın ihmal:
cart.buyerIdentity.customer.hasTags(müşteri etiketine göre kapılı indirimler)lines[].merchandise.product.inAnyCollection(koleksiyona dayalı fiyatlandırma)discountNode.metafield(indirim düğümünün kendisinde depolanan yapılandırma)lines[].sellingPlanAllocation(hariç tutulması gereken abonelik ürünleri)
Somut örnek: Script'iniz vip etiketli müşterilere yüzde 15 indirim verdiyse, değiştirme Fonksiyonunuz input.graphql'de buna ihtiyaç duyar:
query Input {
cart {
buyerIdentity {
customer {
hasTags(tags: ["vip"])
}
}
lines {
id
quantity
merchandise {
... on ProductVariant {
id
price { amount }
}
}
}
}
discountNode {
metafield(namespace: "$app:discount", key: "configuration") {
value
}
}
}
hasTags yoksa, alan null döner, koşulunuz yanlış değer alır ve Fonksiyon { discounts: [], discountApplicationStrategy: FIRST } döndürür. Hata yok. Standart dağıtımda görünen günlük satırı yok.
Nasıl doğrulayacaksınız: İndirim alması gereken bir sepete eşleşen bir örnek yük ile yerel olarak shopify app function run çalıştırın. Ham giriş JSON'unu inceleyin ve mantığınızın dallandığı her alan mevcut ve sıfırdan farklı olduğunu onaylayın.
3. combinesWith indirim düğümünde yanlış yapılandırılmış
Hem satır öğesi indirimi hem de sipariş düzeyinde indirim uygulayan bir Script'i göçerttiğiniz ve bunları iki ayrı Fonksiyon olarak yeniden oluşturduysanız, artık iki indirim düğümünüz var. Her ikisinin de ateşleyip ateşlememesi tamamen her düğümdeki combinesWith ayarlarına bağlıdır.
Tüm indirim Fonksiyonları eş zamanlı olarak çalışır ve birbirinden habersizdir. Shopify indirim motoru daha sonra tüm adayları topladıktan sonra kombinasyonluluk ve istiflenme kurallarını uygular. Bir Sipariş İndirimi bir Kargo İndirimle istiflenebilir, ancak iki Sipariş İndirimi aynı ödemede uygulanmaz. Ürün artı Sipariş artı Kargo, her düğüm buna izin verecek şekilde işaretlendiyse hepsi birleşebilir.
Göçleri en sık kıran kural: combinesWith Fonksiyon kodunda değil, Admin'deki indirim düğümünde ayarlanır. Birçok takım Fonksiyon mantığını doğru şekilde yapılandırır, ardından düğümü varsayılanında bırakır (kombinasyon yapılmasına izin verilmez) ve iki indiriminden neden sadece biri ateşleniyor diye merak eder.
| İndirim sınıfı kombinasyonu | Varsayılan olarak izin verildi | Notlar |
|---|---|---|
| Ürün + Sipariş | Hayır (opt-in) | Sipariş indirim düğümünde productDiscounts: true ayarlayın |
| Ürün + Kargo | Hayır (opt-in) | Ürün indirim düğümünde shippingDiscounts: true ayarlayın |
| Sipariş + Kargo | Hayır (opt-in) | Sipariş indirim düğümünde shippingDiscounts: true ayarlayın |
| Sipariş + Sipariş | Asla | Ayarlardan bağımsız olarak ödeme başına yalnızca bir sipariş indirim yuvası |
| Kargo + Kargo | Asla | Sipariş başına yalnızca bir kargo indirimi |
Nasıl doğrulayacaksınız: Admin'de her indirim düğümünü açın, Kombinasyonlara gidin ve onay kutularının amacınızı yansıttığını onaylayın. Mutasyonlar için, GraphQL Admin API aracılığıyla DiscountAutomaticApp veya DiscountCodeApp düğümündeki combinesWith alanını inceleyin.
4. Mağaza başına aktif indirim sınırına çarpmak
Shopify, mağaza başına aktif otomatik indirim Fonksiyonlarını 25'le sınırlandırır (İndirim Fonksiyonu API belgelerinde onaylandı). Bu sınır, tüm yüklü uygulamalar ve birleştirilmiş özel uygulamalar arasında paylaşılır. Birçok uygulamaya sahip mağazalarda sınır gerçektir.
Göçertme mağazalarını yakalayan daha dayanıklı bir sınır vardır: topluluk, özellikle her biri kendi indirim düğümünü oluşturan çok sayıda uygulama olduğunda, belgelenmiş 25 sınırından bağımsız olarak ortaya çıkan 5 aktif uygulamadan oluşturulan otomatik indirim tavanını belgelemiştir. Yanında birden fazla indirim uygulaması olan özel bir Fonksiyonunuz varsa, burada rekabet ile karşılaşabilirsiniz.
Belirtiler: indirim düğümü var, Etkindir, combinesWith doğrudur, ama Fonksiyon bazı sepetler için çalışmıyor gibi görünür. Admin > İndirimler'de toplam aktif otomatik indirim sayısını kontrol edin, Otomatik üzerine filtre yaparak.
5. Giriş şemasında API sürümü uyumsuzluğu
GraphQL API sürümü 2026-04 itibariyle, Shopify Fonksiyonları, fonksiyon giriş yükünden doğrudan sepet, satır öğesi ve teslimat grubu düzeylerinde indirim tahsislerini okuyabilir. Ödeme işlem hattında indirim uygulamasından sonra yürütülen Fonksiyonlar tam tahsis verisi alır; daha erken çalışanlar almaz.
Fonksiyonunuz 2026-04 öncesi bir API sürümüne sabitlenmişse, geçerli şemada bulunan alanları kaçırıyorsunuz. Fonksiyon hata vermez; alanlar basitçe null döner. Bu, Fonksiyon mantığınız başka indirimler ne zaman uygulandığına bağlı olduğunda önemlidir (örneğin, "sadece promosyonal indirim bu satırda zaten etkinse sadece benim sadakat indirimimi uygula").
Nasıl doğrulayacaksınız: shopify.extension.toml'deki api_version alanını kontrol edin. Bunu 2026-04 veya daha yeni sürüme güncelleyin, shopify app generate extension ile türleri yeniden oluşturun ve oluşturulan input.graphql türlerini yeni kullanılabilir alanları bulmak için geçerli sorgunuza karşı karşılaştırın.
Göç yaklaşımı karşılaştırması
| Yaklaşım | Ne zaman kullanılmalı | Ana uzlaşma |
|---|---|---|
| Yerel Admin indirimi (BOGO, hacim) | Standart BOGO veya hacim sınırı, özel koşul yok | Sıfır geliştirme işi; sınırlı mantık derinliği |
| Genel App Store uygulaması Fonksiyonlarda | Yaygın desenler (katmanlı fiyatlandırma, bedava hediye, paketler) | Daha hızlı dağıtım; uygulama satıcısının güncelleme döngüsüne bağlısınız |
| Özel Fonksiyon (JS/TypeScript) | Orta düzey karmaşıklık; takım JS'de rahat | Özel uygulamalar için Plus gerekir; gerçek dünyadaki 10-30ms yürütme |
| Özel Fonksiyon (Rust/Wasm) | Yüksek karmaşıklık, büyük sepetler, sıkı yürütme bütçeleri | Daha hızlı (3-5ms); daha dik öğrenme eğrisi; WebAssembly'ye derlenmiş |
Yürütme sırası önemlidir
Fonksiyonlar ödeme işlem hattında aynı anda çalışmaz. Belgelenmiş sıra: Cart Transform Fonksiyonları önce, ardından İndirim Fonksiyonları. İndirriminiz dönüştürülen sepet satırlarına bağlıysa (örneğin, Cart Transform tarafından yapılan bir paket birleşmesi) ve İndirim Fonksiyonunuz dönüşüm tamamlanmadan önce çalışırsa, dönüştürülmemiş sepeti görecektir.
İndirim Fonksiyonlarını Cart Transform sonrasında sepet durumunda çalışacak şekilde tasarlayın ve sadece statik sepet yükünü hedef alan birim testlerle değil, tam ödeme akışıyla test edin.
Hata ayıklama kontrolü listesi
Herhangi bir kodu değiştirmeden önce bunların arasından sırasıyla geçin:
- İndirim düğümünün Admin > İndirimler'de mevcut olduğunu ve Etkin olduğunu onaylayın.
- Düğümdeki Fonksiyon Kimliğini dağıtılan Fonksiyonla onaylayın. Partner Dashboard uygulama sıfırlama sonrası yeniden dağıtım, Fonksiyon Kimliğini değiştirebilir.
input.graphql'yi mantığınız okuduğu her alan karşı karşıya getirin. JS/Rust'da okunan ama sorguda olmayan herhangi bir alannull'dur.- İndirimi tetiklemesi gereken bir sepet yüküyle
shopify app function runçalıştırın. Ham çıktı nesnesini inceleyin.discountsboş bir dizi ise, Fonksiyon çalıştı ama hiçbir şey döndürmedi; komut hata veriyorsa, Fonksiyon başarısız oldu. - Aynı ödemede yer alan her indirim düğümünde
combinesWithkontrol edin. - Aktif otomatik indirim sayısını 25 Fonksiyon sınırına karşı kontrol edin.
shopify.extension.toml'deki API sürümünü onaylayın ve türleri yeniden oluşturun.
Fonksiyonları metafields ile yapılandırmak için indirim kurallarının yeniden dağıtım olmaksızın nasıl değişmesi gerektiğinin işletilmiş dökümü için, lintelagency.com/journal adresindeki Fonksiyonları metafields ile yapılandırmak hakkındaki yazı yapılandırma modelini ayrıntılı olarak kapsar.
İstiflenme modeli değişikliğine dair bir not
Şunu işaretlemeye değer: mid-2026 öncesinde yazılan bazı göç kılavuzları, sabit-satır-öğe-başına-bir-indirim tavanını kalıcı Fonksiyonlar sınırlaması olarak tanımlar. O tavan mid-2026'da revize edildi. Aynı satır öğesine birden fazla ürün indirimi artık her indirim düğümünde kombinasyon ayarları açıkça etkinleştirildiğinde birleşebilir. Göç kılavuzunuz bu değişiklikten önce tarihleniyorsa, iki ürün indiriminin bir arada olamayacağı sonucuna varmadan önce indirim düğümlerinizin kombinasyon bölümünü tekrar okuyun.
Kontrol edilecek mekanikler aynı kalır: düğümdeki combinesWith, indirim sınıfı (ürün, sipariş veya kargo) ve mağaza seviyesi 25 Fonksiyon tavanı.
Sonuç
Yukarıdaki başarısızlık modlarının hepsi aynı belirtiyi üretir: ödeme tamamlanır, müşteri tam fiyat öder, hiçbir yerde hata görünmez. Tanı döngüsü, ne kontrol edeceğinizi bildiğiniz zaman hızlıdır. Admin'deki indirim düğümü ile başlayın, giriş sorgusundan alan alana gidin, ardından kombinasyonluluk ayarlarını doğrulayın. Fonksiyon kodu kendisi genellikle sorun değildir. Etrafındaki yapılandırma sorun.
Bu işi dışarıya vermek isterseniz, stüdyom Lintel Shopify Functions geliştirme hizmeti veriyor.
Sıkça sorulan sorular
Shopify İndirim Fonksiyonum neden hatasız dağıtılıyor ama indirim uygulanmıyor?
En yaygın nedenler, Admin'de Fonksiyona bağlı Etkin bir indirim düğümü olmaması veya mantığınız bağlı olan bir alanın input.graphql'de eksik olması ve null döneceğidir. Gerçek bir sepet yüküyle yerel olarak shopify app function run çalıştırın ve Fonksiyonun tam olarak ne aldığını ve ne döndürdüğünü görmek için.
Shopify Fonksiyonlarında selectionStrategy ile combinesWith arasındaki fark nedir?
selectionStrategy (FIRST, MAXIMUM veya ALL), Fonksiyonunuzun birden fazla olası satır hedefini değerlendirirken hangi aday indirimini seçmesi gerektiğini kontrol eder. combinesWith Admin'deki indirim düğümünde ayarlanır ve indiriminiz ödeme düzeyinde başka düğümlerden indirimleri istifleyip istifleyemeyeceğini kontrol eder. Tamamen ayrı ayarlar.
Bir Shopify mağazasında kaç İndirim Fonksiyonu aktif olabilir?
Shopify, tüm uygulamalar ve özel Fonksiyonlar arasında paylaşılan mağaza başına maksimum 25 aktif İndirim Fonksiyonuna izin verir. Müşteriler sipariş başına 5 ürün veya sipariş indirim koduna artı 1 kargo indirim koduna kadar uygulayabilir ve bu sınırlar Fonksiyon sınırının üzerine uygulanır.