Android SDK'da Flow & Paywall Builder ile satın almaları etkinleştir

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 paywalllar – ürünleri kullanıcılara sunan ekranlar; no-code Flow & Paywall Builder ile oluşturulur. SDK bunları getFlow aracılığıyla getirir. Kullanıcı arayüzünü kendi kodunuzla oluşturmayı tercih ediyorsanız bkz. Özel paywall uygulama.
Placement’lar – uygulamanızda flow’ları ve paywallları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Bunları kontrol panelinde placement’lara bağlarsınız, ardından kodunuzda placement ID’si ile talep edersiniz. Bu sayede A/B testleri yürütmek ve farklı kullanıcılara farklı içerikler göstermek kolaylaşır.

Adapty, uygulamanızda satın almaları etkinleştirmek için size üç yöntem sunar. Uygulama gereksinimlerinize bağlı olarak birini seçin:

Uygulama	Karmaşıklık	Ne zaman kullanılır
Adapty Flow & Paywall Builder	✅ Kolay	No-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	🟡 Orta	Paywall kullanıcı arayüzünü kendi uygulama kodunuzda siz 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	🔴 Zor	Kendi satın alma altyapınız zaten vardır ve onu kullanmaya devam etmek istersiniz. Observer mode’un Adapty’de bazı kısıtlamaları olduğunu unutmayın. Makaleye bakın.

Important

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

Paywall arayüzünü kendiniz oluşturmayı tercih ediyorsanız, Özel paywall’ları uygulama bölümüne bakın.

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

Flow veya paywallı alın: Adapty’den alın.
Görüntüleyin, satın almaları Adapty yönetsin: View’ı uygulamanızda gösterin.
Buton aksiyonlarını yönetin: Kullanıcı etkileşimlerini uygulamanızın bu etkileşimlere verdiği yanıtlarla 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:

Adapty Kontrol Paneli’nde uygulamanızı Google Play’e bağlayın.
Adapty’de ürünlerinizi oluşturun.
Bir flow veya paywall oluşturun ve buna ürünler ekleyin.
Bir placement oluşturun ve flow ya da paywall’ınızı buna ekleyin.
Uygulama kodunuzda Adapty SDK’yı yükleyin ve etkinleştirin. Bu kılavuzda Adapty Android SDK v4 API’leri kullanılmaktadır.

Tip

Bu adımları tamamlamanın en hızlı yolu hızlı başlangıç kılavuzunu takip etmek ya da Developer CLI kullanarak flow’lar ve placement’lar oluşturmaktır.

1. Flow veya paywall’ı alın

Flow’larınız ve paywall’larınız, kontrol panelinde yapılandırılan 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’ı almak için şunları yapmanız gerekir:

getFlow metodunu kullanarak placement ID’sine göre flow nesnesini alın ve bir görünüm yapılandırmasına sahip olup olmadığını kontrol edin.
Görünüm yapılandırmasını almak için getFlowConfiguration metodunu kullanın. Görünüm yapılandırması, onu görüntülemek için gereken UI öğelerini ve stilini içerir.

Important

Görünüm yapılandırmasını almak için flow veya paywall’ı yayınlayın. Yayınlanmamış düzenlemeleri olan bir flow veya paywall Dirty statüsüne sahip olur ve placement’ı son yayınlanan sürümü sunmaya devam eder.

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    if (result is AdaptyResult.Success) {
        val flow = result.value
        
        if (!flow.hasViewConfiguration) {
            return@getFlow
        }
        
        AdaptyUI.getFlowConfiguration(flow) { configResult ->
            if (configResult is AdaptyResult.Success) {
                val flowConfiguration = configResult.value
            }
        }
    }
}


Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
        
        if (!flow.hasViewConfiguration()) {
            return;
        }
        
        AdaptyUI.getFlowConfiguration(flow, configResult -> {
            if (configResult instanceof AdaptyResult.Success) {
                AdaptyUI.FlowConfiguration flowConfiguration =
                    ((AdaptyResult.Success<AdaptyUI.FlowConfiguration>) configResult).getValue();
                // yüklenen konfigürasyonu kullan
            }
        });
    }
});

2. Flow veya paywallı görüntüleyin

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

Görsel flow’u cihaz ekranında görüntüleyebilmek için önce yapılandırmanız gerekir. Bunu yapmak için AdaptyUI.getFlowView() metodunu çağırın ya da AdaptyFlowView’ı doğrudan oluşturun:

   val flowView = AdaptyUI.getFlowView(
       activity,
       flowConfiguration,
       null, // products = null means auto-fetch
       eventListener,
   )

   val flowView =
        AdaptyFlowView(activity) // or retrieve it from xml
   ...
   with(flowView) {
       showFlow(
           flowConfiguration,
           null, // products = null means auto-fetch
		   eventListener,
       )
   }

AdaptyFlowView flowView = AdaptyUI.getFlowView(
        activity,
        flowConfiguration,
        null, // products = null means auto-fetch
        eventListener
);

AdaptyFlowView flowView =
  new AdaptyFlowView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
flowView.showFlow(flowConfiguration, products, eventListener);

<com.adapty.ui.AdaptyFlowView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

View başarıyla oluşturulduktan sonra, onu görünüm hiyerarşisine ekleyebilir ve cihaz ekranında görüntüleyebilirsiniz.

Tip

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 flow veya paywall’daki butonlara tıkladığında Android SDK; satın alma, geri yükleme, ekranı kapatma ve bağlantı açma işlemlerini otomatik olarak gerçekleştirir.

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

Örneğin, aşağıda kapat butonunun varsayılan davranışı gösterilmektedir. Bunu koda eklemenize gerek yoktur, ancak gerektiğinde nasıl yapıldığını buradan görebilirsiniz.

Tip

Buton action’ları ve event’leri nasıl yöneteceğinizi anlatan kılavuzlarımızı okuyun.

override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
    when (action) {
        AdaptyUI.Action.Close -> (context as? Activity)?.onBackPressed() // default behavior
    }
}

@Override
public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
    if (action instanceof AdaptyUI.Action.Close) {
        if (context instanceof Activity) {
            ((Activity) context).onBackPressed();
        }
    }
}

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’unuz veya paywallınız uygulamada görüntülenmeye hazır. Flow üzerinden test satın alma işlemini tamamlayabildiğinizden emin olmak için Google Play Store’da satın almalarınızı test edin.

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

Tam örnek

Tüm bu adımları uygulamanızda nasıl bir araya getirebileceğiniz aşağıda gösterilmektedir.

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        Adapty.getFlow("YOUR_PLACEMENT_ID") { flowResult ->
            if (flowResult is AdaptyResult.Success) {
                val flow = flowResult.value

                if (!flow.hasViewConfiguration) {
                    // Use custom logic
                    return@getFlow
                }

                AdaptyUI.getFlowConfiguration(flow) { configResult ->
                    if (configResult is AdaptyResult.Success) {
                        val flowConfiguration = configResult.value

                        val flowView = AdaptyUI.getFlowView(
                            this,
                            flowConfiguration,
                            null, // products = null means auto-fetch
                            object : AdaptyFlowDefaultEventListener() {
                                override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
                                    when (action) {
                                        is AdaptyUI.Action.Close -> {
                                            (context as? Activity)?.onBackPressed()
                                        }
                                    }
                                }
                            }
                        )

                        setContentView(flowView)
                    }
                }
            }
        }
    }
}

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        Adapty.getFlow("YOUR_PLACEMENT_ID", flowResult -> {
            if (flowResult instanceof AdaptyResult.Success) {
                AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) flowResult).getValue();

                if (!flow.hasViewConfiguration()) {
                    // Use custom logic
                    return;
                }

                AdaptyUI.getFlowConfiguration(flow, configResult -> {
                    if (configResult instanceof AdaptyResult.Success) {
                        AdaptyUI.FlowConfiguration flowConfiguration =
                            ((AdaptyResult.Success<AdaptyUI.FlowConfiguration>) configResult).getValue();

                        AdaptyFlowView flowView = AdaptyUI.getFlowView(
                            this,
                            flowConfiguration,
                            null, // products = null means auto-fetch
                            new AdaptyFlowDefaultEventListener() {
                               @Override
                                    public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
                                        if (action instanceof AdaptyUI.Action.Close) {
                                            if (context instanceof Activity) {
                                                ((Activity) context).onBackPressed();
                                            }
                                        }
                                    }
                            }
                        );

                        setContentView(flowView);
                    }
                });
            }
        });
    }
}