Android SDK'da Flow Builder ile satın alımları etkinleştirme

Uygulama içi satın alımları 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 – ürünleri kullanıcılara sunan ekran dizileri; no-code Flow Builder ile oluşturulur. SDK bunları getFlow aracılığıyla alır. Arayüzü kendi kodunuzla oluşturmayı tercih ediyorsanız bunun yerine paywall kullanın — bkz. Paywall’ları manuel olarak uygulama.
Placement’lar – flow’ların uygulamanızda nerede ve ne zaman gösterileceği (main, onboarding, settings gibi). Flow’ları kontrol panelinde placement’lara bağlar, ardından kodunuzda placement ID’siyle talep edersiniz. Bu sayede A/B testleri çalıştırmak ve farklı kullanıcılara farklı flow’lar 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 Builder | ✅ Kolay | No-code builder’da satın almaya hazır eksiksiz bir flow oluşturursunuz. Adapty bunu otomatik olarak render eder; tüm karmaşık satın alma akışını, makbuz doğrulamasını ve abonelik yönetimini arka planda kendisi halleder. | | Manuel oluşturulan paywall’lar | 🟡 Orta | Paywall arayüzünüzü 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 modu | 🔴 Zor | Kendi satın alma altyapınız zaten mevcuttur ve bunu kullanmaya devam etmek istersiniz. Observer modunun Adapty’de bazı sınırlamaları olduğunu unutmayın. Makaleye bakın. |

Aşağıdaki adımlar, Adapty Flow Builder’da oluşturulan bir flow’un nasıl hayata geçirileceğini göstermektedir.

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

Adapty Flow Builder’da oluşturulan bir flow’u görüntülemek için uygulama kodunuzda yalnızca şunları yapmanız gerekir:

Flow’u alın: Adapty’den alın.
Görüntüleyin, satın alma işlemlerini Adapty yönetsin: Görünümü uygulamanızda gösterin.
Buton eylemlerini yönetin: Kullanıcı etkileşimlerini uygulamanızın bu etkileşimlere verdiği yanıtlarla ilişkilendirin. Örneğin, kullanıcılar butona tıkladığında bağlantıları açın veya flow’u 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 oluşturun ve buna ürün ekleyin.
Bir placement oluşturun ve flow’unuzu ekleyin.
Uygulama kodunuza Adapty SDK’yı yükleyin ve etkinleştirin. Bu kılavuzda Adapty Android SDK v4 (beta) API’leri kullanılmaktadır.

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’u alın

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

Adapty Flow Builder’da oluşturduğunuz bir flow’u 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.
getFlowConfiguration metodunu kullanarak görünüm yapılandırmasını alın. Görünüm yapılandırması, flow’u görüntülemek için gereken UI öğelerini ve stil bilgilerini içerir.

Görünüm yapılandırmasını almak için Flow Builder’da Show on device geçişini açmanız gerekir. Aksi takdirde boş bir görünüm yapılandırması alırsınız ve flow görüntülenmez.

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();
                // use loaded configuration
            }
        });
    }
});

2. Flow’u göster

Artık flow yapılandırmanız hazır olduğunda, flow’unuzu görüntülemek için birkaç satır kod eklemeniz yeterlidir.

Görsel flow’u cihaz ekranında gösterebilmek için önce yapılandırmanız gerekir. Bunun için AdaptyUI.getFlowView() metodunu çağırın ya da doğrudan AdaptyFlowView 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, view hiyerarşisine ekleyebilir ve cihaz ekranında görüntüleyebilirsiniz.

Bir flow’un nasıl görüntüleneceğine ilişkin daha fazla ayrıntı için kılavuzumuza bakın.

3. Buton eylemlerini yönetme

Kullanıcılar flow içindeki butonlara tıkladığında, Android SDK satın alma, geri yükleme, flow’u kapatma ve bağlantı açma işlemlerini otomatik olarak gerçekleştirir.

Ancak bazı butonların özel veya önceden tanımlanmış ID’leri vardır ve bu eylemler kodunuzda ele alınmalıdır. 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 eklemeniz gerekmez, ancak gerekirse nasıl yapıldığını buradan görebilirsiniz.

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

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!

Paywall’ınız uygulamada görüntülenmeye hazır. Paywall üzerinden test satın alımı tamamlayabildiğinizden emin olmak için Google Play Store’da satın alımlarınızı test edin.

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

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);
                    }
                });
            }
        });
    }
}