12 aylık taahhüt planı için abonelerinizin yıllık ödemeyi aylık yapmasını sağlamak amacıyla, App Store Connect’te ve Adapty’de yıllık ürününüze bir 12 aylık taahhüt planı ekleyin.

Başlamadan önce

Commitment planlarını uygulamadan önce şunları yaptığınızdan emin olun:

• Doğru pazarı hedefleyin: Taahhüt planları Amerika Birleşik Devletleri’nde kullanılamaz. Almanya, İsrail, Güney Afrika ve Türkiye’de aboneler, Apple Support aracılığıyla aboneliklerini anında iptal edebilir.
• Doğru işletim sistemi sürümünü hedefleyin: Abonelerin iOS 26.4 veya sonraki bir sürüme, ya da iPadOS, macOS, tvOS veya visionOS’un aynı sürümüne ihtiyacı vardır. Uygulamanızı Xcode 26.5 veya sonraki bir sürümle derleyin.
• Doğru fiyat aralığını hedefleyin: 12 aylık ödemenin toplam değeri, peşin yıllık abonelik değerinin 1 ila 1,5 katı arasında olmalıdır.
• Adapty SDK v4.3 veya sonraki bir sürümü çalıştırın: Daha eski bir SDK içeren uygulama sürümlerinde kullanıcılar yalnızca peşin planı satın alabilir.
• Ürün kimliklerini okuyan kodu güncelleyin: Webhook’lar, entegrasyonlar, veri dışa aktarımları ve Sunucu tarafı API’si, taahhüt planı satın almalarını <product_id>:monthly olarak raporlar. Kodunuz ürün kimliklerini işliyorsa, ilk taahhüt planı satın alımından önce mantığı güncelleyin.

1. App Store Connect yapılandırması

1. App Store Connect’te yıllık bir abonelik açın veya 1 Yıl süreli yeni bir abonelik oluşturun.
2. Availability bölümünde, 1 Year Upfront ve Monthly with 12-Month Commitment altına aynı ülkeleri ekleyin. Apple, taahhüt ücretlendirmesini yalnızca peşin ücretlendirmenin mevcut olduğu yerlerde sunar. Tersi zorunlu değildir: taahhüt planı olmayan ülkelerde de peşin planı sunabilirsiniz.
3. Subscription Prices bölümünde, aboneliğin henüz bir fiyatı yoksa temel bölgeniz için peşin fiyatı belirleyin. Apple, yalnızca taahhüt planını kullanıcılara gösterseniz dahi peşin fiyat belirlemenizi zorunlu kılar.
4. Temel bölgeniz için aylık fiyatı belirleyin. Aylık fiyat, peşin fiyatın 1/12’si ile 1/8’i arasında olmalıdır. Örneğin, €59,99 peşin fiyat ile aylık fiyat €5,00 ile €7,49 arasında olabilir.

App Store Connect, diğer ülkeler için fiyatları temel bölge fiyatlarınızdan hesaplar.

Tam talimatlar için Apple’ın 12 aylık taahhütlü aylık abonelik sunma kılavuzunu izleyin.

2. Adapty yapılandırması

Commitment planını özel paywallarda göstermek için yıllık üründe Adapty’de bu özelliği etkinleştirin. Özel paywall kullanmıyorsanız bu adımı atlayabilirsiniz.

1. Yıllık ürünü açın. Henüz mevcut değilse, App Store Connect’te kurduğunuz aboneliği oluşturun ve bağlayın. Adapty’den yeni bir ürün eklemeyin: bu işlem commitment planı olmayan ayrı bir abonelik oluşturur.

2. App Store sekmesini açın ve Offer monthly payments with a 12-month commitment seçeneğini işaretleyin.

   

3. Açılan pencerede, Monthly price, USD listesinden App Store Connect ile eşleşen taksit fiyatını seçin. Liste yalnızca izin verilen aralıktaki App Store fiyat noktalarını içerir. Bu fiyat bir referans değeridir: Adapty bunu App Store Connect’e göndermez.

   

3. Teklifleri ayarlayın

App Store Connect’te her faturalandırma planının kendine ait başlangıç teklifleri, promosyon teklifleri, geri kazanma teklifleri ve teklif kodları bulunur. Ön ödeme planına ait bir teklif, taahhüt planı için geçerli değildir.

• Ücretsiz denemeler ve diğer başlangıç teklifleri: App Store Connect’te taahhüt planı için teklifi ayarlayın. Adapty, başlangıç tekliflerini otomatik olarak uygular. Başlangıç teklifi sona erdiğinde, abonelerin 12 aylık taahhüt süreci başlar.
• Promosyon ve geri kazanma teklifleri: App Store Connect’te taahhüt planı için promosyon veya geri kazanma teklifleri ayarlayın. Ardından teklifleri Adapty’ye ekleyin ve App Store plan seçeneğini Monthly with 12-month commitment olarak belirleyin. Bir paywall satırı yalnızca kendi fatura planına ait teklifleri listeler. Özel paywall kullanmıyorsanız teklifleri Adapty’ye eklemenize gerek yoktur.
• Teklif kodları: App Store Connect’te taahhüt planı için teklif kodlarını ayarlayın.

4. Özel bir paywalle ekleme

1. Özel paywallde yıllık ürünü ekleyin ve Billing plan olarak Monthly seçin. Aynı paywall’da peşin planı da satmak istiyorsanız, yıllık ürünü tekrar ekleyin ve bu sefer Upfront fatura planını seçin.
   • Peşin planı satın alan kullanıcılara taahhüt planının geçerli olmadığı durumlarda (daha eski bir SDK sürümünde veya taahhüt planının uygulanamadığı hallerde) peşin teklif sunmak için Fallback offer altından ilgili teklifi seçin.
2. Uygulamanızda fiyatı product.subscriptionPricingTerms üzerinden gösterin. Taahhüt planını satın alabilecek kullanıcılar için Adapty SDK, o planın fiyatlandırmasını döndürür. Diğer kullanıcılar için ise peşin planın fiyatlandırmasını döndürür:
   • SDK’nın hangi planı döndürdüğünü anlamak için product.subscriptionPricingTerms?.billingPlan değerini kontrol edin. Taahhüt planı için .monthly, peşin plan için .upFront değerini alırsınız.
   • Taksit fiyatını göstermek için subscriptionPricingTerms.localizedBillingPrice ve subscriptionPricingTerms.billingPeriod kullanın.
   • Yıllık toplamı göstermek için subscriptionPricingTerms.commitmentInfo.localizedPrice ve subscriptionPricingTerms.commitmentInfo.period kullanın. Taahhüt planında product.localizedPrice ve product.subscriptionPeriod de aynı yıllık değerleri döndürür.

Kullanıcılar aşağıdaki durumlarda taahhüt planını satın alamaz:

• Desteklenmeyen işletim sistemi sürümü veya ülke: Kullanıcının Apple cihazı 26.4’ten eski bir sistem sürümü çalıştırıyor ya da plan kullanıcının App Store ülkesinde mevcut değil. Adapty SDK bu durumda ön ödemeli planın fiyatlandırmasını döndürür.
• Mevcut ön ödemeli abonelik: StoreKit, kullanıcının zaten abone olduğunu bildiriyor. Plan değiştirmek için aboneler Apple abonelik ayarlarını kullanır.
• Uygulama içi satın alma promosyonu: Kullanıcı ürünü App Store’da seçer, ardından Adapty SDK satın alma işlemini uygulamanızda başlatır. Bu tür satın almalarda SDK yalnızca ön ödemeli planı destekler.

Taahhüt planını sunmayı durdurmak için özel paywalllarınızda yıllık ürünün Billing plan değerini Upfront olarak ayarlayın ya da Monthly satırını kaldırın. Adapty’de Offer monthly payments with a 12-month commitment onay kutusunu temizleyemezsiniz. Mevcut aboneler, App Store Connect’te yıllık abonelik için Remove Monthly Billing seçeneğine tıklamadığınız sürece her yıl yeni bir taahhütle yenilenmeye devam eder. Taahhüdü zaten başlamış aboneler ise taahhüt süresi bitene kadar ödemeyi sürdürür.

5. Planı sandbox ortamında test edin

İki sandbox hesabıyla sandbox test kılavuzunu takip edin:

• Taahhüt planını sunduğunuz bir ülkenin hesabı: Paywall’da taahhüt planı, aylık fiyatın yanı sıra toplam fiyatla birlikte gösterilmelidir. Satın alma işleminden sonra sandbox kullanıcısının profilinde yıllık ürünün access level’ı görünmelidir.
• Bir ABD hesabı: Paywall’da yalnızca peşin plan gösterilmelidir.

Kodunuz webhook’lardan veya Server-side API’den ürün kimliklerini işliyorsa, taahhüt planı satın almalarının <product_id>:monthly olarak alındığını doğrulayın.

Satın alma mantığını yerel olarak test etmek için Xcode’da StoreKit Testing 26.5 veya üstünü kullanın. StoreKit Testing’deki satın almalar Adapty’e ulaşmaz.

Sorun Giderme

• Aylık ödeme onay kutusu eksik: Offer monthly payments with a 12-month commitment onay kutusu yalnızca App Store ürün kimliğine sahip Annual ürünlerde görünür. Ürünün bir Price (USD) değeri girilene kadar etkin olmaz.
• Kullanıcılar taahhüt planı için ücretsiz deneme veya başka bir teklif görmüyor: App Store Connect’te her teklif bir ödeme planına aittir. Taahhüt planı için teklifi ayarlayın. Promosyon teklifi veya geri kazanma teklifi için teklifin Adapty’deki App Store plan ayarını da Monthly with 12-month commitment olarak belirleyin.
• Her kullanıcı peşin fiyatı görüyor: Aşağıdakilerin her ikisini de doğrulayın:
  • Uygulama Xcode 26.5 veya sonraki bir sürümle derleniyor. Daha eski bir Xcode sürümüyle Adapty SDK her zaman peşin planın fiyatlandırmasını döndürür.
  • Özel paywallda yıllık ürünün Billing plan değeri Monthly olarak ayarlanmış.
• Bazı kullanıcılar peşin fiyatı görüyor: Bu kullanıcılar taahhüt planını satın alamaz.
• Paywall taksit fiyatı yerine yıllık toplamı gösteriyor: Taahhüt planında product.localizedPrice yıllık toplamı döndürür. Taksit fiyatını göstermek için subscriptionPricingTerms.localizedBillingPrice kullanın.