iOS SDK'da Flow & Paywall Builder ile satın almaları etkinleştirme

Uygulama içi satın almaları etkinleştirmek için üç temel kavramı anlamanız gerekir:

  • Ürünler – kullanıcıların satın alabileceği her şey (abonelikler, consumable’lar, süresiz erişim)
  • Flow’lar ve paywall’lar – ürünleri kullanıcılara sunan ekranlar; no-code Flow & Paywall Builder ile oluşturulur. SDK bunları getFlow aracılığıyla alır. Kullanıcı arayüzünü kendi kodunuzla oluşturmayı tercih ederseniz Özel paywall’ları uygulama bölümüne bakın.
  • Placement’lar – uygulamanızda flow’ları ve paywall’ları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Bunları kontrol panelinden placement’lara bağlar, ardından kodunuzda placement ID’si ile çağırırsınız. Bu sayede A/B testi yapmak ve farklı kullanıcılara farklı içerikler göstermek çok kolaylaşır.

Adapty, uygulamanızda satın alımları etkinleştirmeniz için üç yol sunar. Uygulama gereksinimlerinize göre birini seçin:

UygulamaKarmaşıklıkNe Zaman Kullanılır
Adapty Flow & Paywall Builder✅ KolayNo-code builder’da eksiksiz, satın almaya hazır bir flow veya paywall oluşturursunuz. Adapty bunu otomatik olarak render eder ve tüm karmaşık satın alma mantığını, makbuz doğrulamasını ve abonelik yönetimini arka planda halleder.
Özel paywalllar🟡 OrtaPaywall arayüzünü uygulama kodunuzda kendiniz uygularsınız, ancak ürün tekliflerinde esnekliği korumak için flow nesnesini yine de Adapty’den alırsınız. Kılavuza bakın.
Observer mode🔴 ZorKendi satın alma altyapınız zaten var ve onu kullanmaya devam etmek istiyorsunuz. Observer mode’un Adapty’de bazı sınırlamaları olduğunu unutmayın. Makaleye bakın.
Important

Aşağıdaki adımlar, Adapty Flow & Paywall Builder’da oluşturulmuş bir flow veya paywall’un nasıl uygulanacağını gösterir.

Paywall arayüzünü kendiniz oluşturmayı tercih ediyorsanız, bkz. Özel paywall’ları uygulama.

Adapty Flow & Paywall Builder’da oluşturulmuş bir flow veya paywall’u uygulamanızda görüntülemek için yalnızca şunları yapmanız gerekir:

  1. Flow veya paywall’ı alın: Adapty’den alın.
  2. Görüntüleyin, satın alma işlemlerini Adapty yönetir: Görünümü uygulamanızda gösterin.
  3. Buton eylemlerini yönetin: Kullanıcı etkileşimlerini uygulamanızın yanıtlarıyla ilişkilendirin. Örneğin, kullanıcılar butonlara tıkladığında bağlantıları açın veya paywall’ı kapatın.

Başlamadan önce

Başlamadan önce şu adımları tamamlayın:

  1. Adapty Kontrol Paneli’nde uygulamanızı App Store’a bağlayın.
  2. Adapty’de ürünlerinizi oluşturun.
  3. Bir flow veya paywall oluşturun ve ürünleri ekleyin.
  4. Bir placement oluşturun ve flow ya da paywall’unuzu ekleyin.
  5. Uygulama kodunuza Adapty SDK’yı yükleyin ve etkinleştirin. Bu kılavuz Adapty iOS SDK v4 API’lerini kullanmaktadır.

1. Flow veya paywall’ı edinin

Flow’larınız ve paywall’larınız, kontrol panelinde yapılandırılmış placement’larla ilişkilidir. Placement’lar, farklı kitleler için farklı flow’lar veya paywall’lar çalıştırmanıza ya da A/B testleri yapmanıza olanak tanır.

Adapty Flow & Paywall Builder’da oluşturulan bir flow veya paywall’ı edinmek için şunları yapmanız gerekir:

  1. getFlow metodunu kullanarak placement ID’siyle flow nesnesini alın ve bir görünüm yapılandırması içerip içermediğini kontrol edin.
  2. getFlowConfiguration metodunu kullanarak görünüm yapılandırmasını edinin. Bu yapılandırma, görüntüleme için gereken UI öğelerini ve stilini içerir.

func loadFlow() async {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")

    guard flow.hasViewConfiguration else {
        print("Flow doesn't have a view configuration")
        return
    }

    flowConfiguration = try await AdaptyUI.getFlowConfiguration(forFlow: flow)
}

2. Flow veya paywall’ı görüntüleme

Artık flow yapılandırmasına sahip olduğunuzda, flow veya paywall’ınızı görüntülemek için yalnızca birkaç satır kod eklemeniz yeterli.

Info

Bir flow veya paywall’ın nasıl görüntüleneceğine dair daha fazla ayrıntı için kılavuzumuza bakın.

3. Buton eylemlerini yönetin

Kullanıcılar butona tıkladığında, iOS SDK satın alma, geri yükleme, ekranı kapatma ve linkleri açma işlemlerini otomatik olarak yönetir.

Ancak diğer butonların özel veya önceden tanımlanmış ID’leri vardır ve kodunuzda eylemlerin yönetilmesini gerektirir. Ya da varsayılan davranışlarını geçersiz kılmak isteyebilirsiniz.

Örneğin, kapatma butonunu şu şekilde yönetebilirsiniz. UIKit’te SDK, .close tetiklendiğinde controller’ı otomatik olarak kapatır — yalnızca özel bir davranış istiyorsanız geçersiz kılın. SwiftUI’da ise isPresented binding’inizi kendiniz false olarak ayarlamanız gerekir.

Tip

Buton aksiyonlarını ve olayları nasıl yöneteceğinize dair kılavuzlarımızı okuyun.

Sonraki adımlar

Tip

Sorularınız mı var ya da sorunlarla mı karşılaşıyorsunuz? Sık sorulan soruların yanıtlarını bulabileceğiniz veya kendi sorularınızı sorabileceğiniz destek forumumuza göz atın. Ekibimiz ve topluluğumuz yardımcı olmak için burada!

Flow veya paywallınız uygulamada gösterilmeye hazır. Test satın alma işlemini tamamlayabildiğinizden emin olmak için sandbox modunda satın almalarınızı test edin.

Şimdi, doğru kullanıcılara paywall gösterdiğinizden veya ücretli özelliklere erişim verdiğinizden emin olmak için kullanıcıların access level’ını kontrol etmeniz gerekiyor.

Tam örnek

Bu rehberdeki tüm adımların uygulamanıza birlikte nasıl entegre edileceği aşağıda gösterilmektedir.