Android SDK'da Observer modunda flow'ları sunma

Observer modu kullanıyorsanız, kendi satın alma mantığınızdan siz sorumlusunuz. Ancak paywall arayüzünü Flow & Paywall Builder’a devredebilirsiniz.

Ekranı builder’da tasarlayın; Adapty SDK onu yerel olarak render eder. Metin, düzen ve fiyatlandırmayı istediğiniz zaman, uygulama güncellemesi gerektirmeden değiştirin. Kullanıcı bir satın alma düğmesine dokunduğunda SDK, satın almayı tamamlaması için kodunuzu çağırır.

Bu kılavuz, bu ekranın nasıl sunulacağını ve satın alma çağrısının nasıl yönetileceğini gösterir. Satın almaları Adapty sizin için tamamlıyorsa bunun yerine Flow ve paywall’ları görüntüleme bölümüne bakın.

Başlamadan önce

Şunlara ihtiyacınız var:

Adapty Android SDK v4 veya üzeri: Önceki sürümler flow’ları render edemez. Mevcut bir uygulamayı v3’ten taşımak için migration guide adresine bakın.
observerMode true olarak ayarlanmış: Android SDK kurulum kılavuzuna bakın.
İlk mağaza entegrasyonu: Adapty’yi Google Play ile yapılandırın.
Ürünlerle yayınlanmış bir flow: Flow & Paywall Builder’da oluşturun ve ürünleri atayın.
Bir flow placement’ı: Bir placement oluşturun ve flow’unuzu atayın.
Uygulamanızda çekilen flow: Flow’u sunmadan önce flow’u ve yapılandırmasını alın.

Uygulama

AdaptyUiObserverModeHandler öğesini uygulayın.

onPurchaseInitiated olayı, kullanıcının bir satın alma işlemi başlattığını size bildirir. Bu callback’e yanıt olarak kendi özel satın alma flow’unuzu tetikleyebilirsiniz:

val observerModeHandler =
 AdaptyUiObserverModeHandler { product, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

Observer mode’da geri yüklemeleri işlemek için getRestoreHandler() metodunu override edin. Varsayılan olarak null döndürür; bu da Adapty’nin yerleşik Adapty.restorePurchases() flow’unu kullanır. Kendi geri yükleme implementasyonunuzu sağlamak için:

val observerModeHandler = object : AdaptyUiObserverModeHandler {
    override fun onPurchaseInitiated(
        product: AdaptyPaywallProduct,
        onStartPurchase: AdaptyUiObserverModeHandler.PurchaseStartCallback,
        onFinishPurchase: AdaptyUiObserverModeHandler.PurchaseFinishCallback,
    ) {
        // the same body as the purchase example above
    }

    override fun getRestoreHandler() =
        AdaptyUiObserverModeHandler.RestoreHandler { onStartRestore, onFinishRestore ->
            onStartRestore()
            yourBillingClient.restorePurchases(
                onSuccess = { restoredPurchases ->
                    onFinishRestore()
                    //handle successful restore
                },
                onError = {
                    onFinishRestore()
                    //handle error
                }
            )
        }
}

AdaptyUiObserverModeHandler observerModeHandler = new AdaptyUiObserverModeHandler() {
    @Override
    public void onPurchaseInitiated(
        AdaptyPaywallProduct product,
        PurchaseStartCallback onStartPurchase,
        PurchaseFinishCallback onFinishPurchase
    ) {
        // the same body as the purchase example above
    }

    @Override
    public RestoreHandler getRestoreHandler() {
        return (onStartRestore, onFinishRestore) -> {
            onStartRestore.invoke();
            yourBillingClient.restorePurchases(
                restoredPurchases -> {
                    onFinishRestore.invoke();
                    //handle successful restore
                },
                error -> {
                    onFinishRestore.invoke();
                    //handle error
                }
            );
        };
    }
};

Bu satın alma veya geri yükleme işlemi hakkında AdaptyUI’ı bilgilendirmek için aşağıdaki callback’leri çağırmayı unutmayın. Bu, yükleyiciyi gösterme gibi doğru flow davranışı için gereklidir:

Callback	Description
onStartPurchase()	Satın alma işleminin başladığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.
onFinishPurchase()	Satın alma işleminin tamamlandığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.
onStartRestore()	İsteğe bağlı. Geri yükleme işleminin başladığını AdaptyUI’ya bildirmek için çağrılabilir.
onFinishRestore()	İsteğe bağlı. Geri yükleme işleminin tamamlandığını AdaptyUI’ya bildirmek için çağrılabilir.

Flow’u cihaz ekranında görüntülemek için önce yapılandırmanız gerekir.

Bunu yapmak için AdaptyUI.getFlowView() metodunu çağırın veya AdaptyFlowView’ı doğrudan oluşturun:

   val flowView = AdaptyUI.getFlowView(
       activity,
       flowConfiguration,
       products,
       eventListener,
       insets,
       customAssets,
       tagResolver,
       timerResolver,
       observerModeHandler, 
   )

   val flowView =
        AdaptyFlowView(activity) // or retrieve it from xml
   ...
   with(flowView) {
       showFlow(
           flowConfiguration,
           products,
					 eventListener,
           insets,
           customAssets,
           tagResolver,
           timerResolver,
					 observerModeHandler,
       )
   }

AdaptyFlowView flowView = AdaptyUI.getFlowView(
        activity,
        flowConfiguration,
        products,
        eventListener,
        insets,
        customAssets,
        tagResolver,
        timerResolver,
        observerModeHandler
);

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

<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 view hiyerarşisine ekleyebilir ve görüntüleyebilirsiniz.

Bunun için şu composable fonksiyonu kullanın:

AdaptyFlowScreen(
    flowConfiguration,
    products,
    eventListener,
    insets,
    customAssets,
    tagResolver,
    timerResolver,
    observerModeHandler,
)

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
flowConfiguration	zorunlu	Flow’un görsel ayrıntılarını içeren bir `AdaptyUI.FlowConfiguration` nesnesi sağlayın. Yüklemek için `AdaptyUI.getFlowConfiguration(flow)` metodunu kullanın. Daha fazla bilgi için Görünüm yapılandırmasını getirme konusuna bakın.
products	isteğe bağlı	Ekrandaki ürünlerin görüntülenme zamanlamasını optimize etmek için bir `AdaptyPaywallProduct` dizisi sağlayın. `null` geçilirse AdaptyUI gerekli ürünleri otomatik olarak getirir.
eventListener	isteğe bağlı	Flow olaylarını izlemek için bir `AdaptyFlowEventListener` sağlayın. Kullanım kolaylığı açısından `AdaptyFlowDefaultEventListener` sınıfını genişletmeniz önerilir. Daha fazla bilgi için Flow ve paywall olaylarını yönetme konusuna bakın.
insets	isteğe bağlı	Insets, flow etrafındaki boşlukları ifade eder ve dokunulabilir öğelerin sistem çubuklarının arkasına gizlenmesini önler. Varsayılan: `Unspecified`; bu değer Adapty’nin insets’leri otomatik olarak ayarlamasını sağlar. Bkz. Flow insets’lerini değiştirme.
customAssets	isteğe bağlı	Flow’unuzdaki resim ve videoları çalışma zamanında değiştirmek için bir `AdaptyCustomAssets` nesnesi geçin. Daha fazla bilgi için Asset’leri özelleştirme konusuna bakın.
tagResolver	isteğe bağlı	Flow metnindeki özel etiketleri çözümlemek için `AdaptyUiTagResolver` kullanın. Bu çözümleyici bir etiket parametresi alır ve bunu karşılık gelen bir dizeye dönüştürür.
observerModeHandler	Observer modu için zorunlu	Önceki adımda uyguladığınız `AdaptyUiObserverModeHandler`.

Warning

Satın alma işlemlerini paywalllarla ilişkilendirmeyi unutmayın. Aksi takdirde, Adapty satın almanın kaynak flow’unu belirleyemez.

Paywallları sunmaya başlamadan önce (Genişletmek için tıklayın)

Adapty’nin Google Play ile ve App Store ile başlangıç entegrasyonunu kurun. 2. Adapty SDK’yı yükleyin ve yapılandırın. observerMode parametresini true olarak ayarladığınızdan emin olun. Framework’e özgü talimatlarımıza Android için başvurun. 3. Adapty Kontrol Paneli’nde ürünler oluşturun. 4. Adapty Kontrol Paneli’nde paywall’ları yapılandırın, ürünleri bunlara atayın ve Paywall Builder kullanarak özelleştirin. 5. Adapty Kontrol Paneli’nde placement’lar oluşturun ve paywall’larınızı bunlara atayın. 6. Mobil uygulama kodunuzda Paywall Builder paywall’larını ve yapılandırmalarını çekin.

AdaptyUiObserverModeHandler’ı uygulayın.

onPurchaseInitiated olayı, kullanıcının bir satın alma işlemi başlattığını size bildirir. Bu geri çağrıma yanıt olarak kendi özel satın alma flow’unuzu tetikleyebilirsiniz:

Note

3.15.0 öncesi Adapty Android SDK sürümleri bu geri çağrıma aynı zamanda paywall ve paywall görünümünü de iletiyordu. 3.15.0 veya daha yeni bir sürüme yükselttiğinizde bu iki parametreyi kaldırın.

val observerModeHandler =
 AdaptyUiObserverModeHandler { product, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

Observer mode’da geri yüklemeleri yönetmek için getRestoreHandler() metodunu override edin. Varsayılan olarak null döndürür; bu, Adapty’nin yerleşik Adapty.restorePurchases() flow’unu kullanır. Kendi geri yükleme uygulamanızı sağlamak için:

val observerModeHandler = object : AdaptyUiObserverModeHandler {
    override fun onPurchaseInitiated(
        product: AdaptyPaywallProduct,
        onStartPurchase: AdaptyUiObserverModeHandler.PurchaseStartCallback,
        onFinishPurchase: AdaptyUiObserverModeHandler.PurchaseFinishCallback,
    ) {
        // the same body as the purchase example above
    }

    override fun getRestoreHandler() =
        AdaptyUiObserverModeHandler.RestoreHandler { onStartRestore, onFinishRestore ->
            onStartRestore()
            yourBillingClient.restorePurchases(
                onSuccess = { restoredPurchases ->
                    onFinishRestore()
                    //handle successful restore
                },
                onError = {
                    onFinishRestore()
                    //handle error
                }
            )
        }
}

AdaptyUiObserverModeHandler observerModeHandler = new AdaptyUiObserverModeHandler() {
    @Override
    public void onPurchaseInitiated(
        AdaptyPaywallProduct product,
        PurchaseStartCallback onStartPurchase,
        PurchaseFinishCallback onFinishPurchase
    ) {
        // the same body as the purchase example above
    }

    @Override
    public RestoreHandler getRestoreHandler() {
        return (onStartRestore, onFinishRestore) -> {
            onStartRestore.invoke();
            yourBillingClient.restorePurchases(
                restoredPurchases -> {
                    onFinishRestore.invoke();
                    //handle successful restore
                },
                error -> {
                    onFinishRestore.invoke();
                    //handle error
                }
            );
        };
    }
};

Ödeme veya geri yükleme sürecini AdaptyUI’ya bildirmek için aşağıdaki callback’leri çağırmayı unutmayın. Bu, yükleyicinin gösterilmesi gibi paywall’ın düzgün çalışması için gereklidir:

Callback	Açıklama
onStartPurchase()	Satın alma işleminin başladığını AdaptyUI’a bildirmek için bu callback çağrılmalıdır.
onFinishPurchase()	Satın alma işleminin tamamlandığını AdaptyUI’a bildirmek için bu callback çağrılmalıdır.
onStartRestore()	İsteğe bağlı. Geri yüklemenin başladığını AdaptyUI’a bildirmek için bu callback çağrılabilir.
onFinishRestore()	İsteğe bağlı. Geri yüklemenin tamamlandığını AdaptyUI’a bildirmek için bu callback çağrılabilir.

Görsel paywall’ı cihaz ekranında göstermek için önce onu yapılandırmanız gerekir.

Bunu yapmak için AdaptyUI.getPaywallView() metodunu çağırın ya da AdaptyPaywallView’ı doğrudan oluşturun:

   val paywallView = AdaptyUI.getPaywallView(
       activity,
       viewConfiguration,
       products,
       eventListener,
       personalizedOfferResolver,
       tagResolver,
       timerResolver,
       observerModeHandler, 
   )

   val paywallView =
        AdaptyPaywallView(activity) // or retrieve it from xml
   ...
   with(paywallView) {
       showPaywall(
           viewConfiguration,
           products,
					 eventListener,
           personalizedOfferResolver,
           tagResolver,
           timerResolver,
					 observerModeHandler,
       )
   }

AdaptyPaywallView paywallView = AdaptyUI.getPaywallView(
        activity,
        viewConfiguration,
        products,
        eventListener,
        personalizedOfferResolver,
        tagResolver,
        timerResolver,
        observerModeHandler
);

AdaptyPaywallView paywallView =
  new AdaptyPaywallView(activity); //gerekirse görünüm hiyerarşisine ekleyin veya xml'den alın
...
paywallView.showPaywall(viewConfiguration, products, eventListener, personalizedOfferResolver, tagResolver, timerResolver, observerModeHandler);

<com.adapty.ui.AdaptyPaywallView 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 görüntüleyebilirsiniz.

Bunun için aşağıdaki composable fonksiyonu kullanın:

AdaptyPaywallScreen(
    viewConfiguration,
    products,
    eventListener,
    personalizedOfferResolver,
    tagResolver,
    timerResolver,
)

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
Products	isteğe bağlı	Ekranda ürünlerin görüntülenme zamanlamasını optimize etmek için bir `AdaptyPaywallProduct` dizisi sağlayın. `null` geçilirse AdaptyUI gerekli ürünleri otomatik olarak getirir.
ViewConfiguration	zorunlu	Paywallın görsel ayrıntılarını içeren bir `AdaptyViewConfiguration` nesnesi sağlayın. Bunu yüklemek için `Adapty.getViewConfiguration(paywall)` metodunu kullanın. Daha fazla bilgi için Paywallın görsel yapılandırmasını getirme konusuna bakın.
EventListener	isteğe bağlı	Paywall olaylarını izlemek için bir `AdaptyUiEventListener` sağlayın. Kullanım kolaylığı açısından AdaptyUiDefaultEventListener’ı genişletmeniz önerilir. Daha fazla bilgi için Paywall olaylarını yönetme konusuna bakın.
PersonalizedOfferResolver	isteğe bağlı	Kişiselleştirilmiş fiyatlandırmayı (daha fazla oku) belirtmek için `AdaptyUiPersonalizedOfferResolver`’ı uygulayın ve `AdaptyPaywallProduct`’ı ürünün fiyatı kişiselleştirilmişse true, değilse false ile eşleştiren kendi mantığınızı geçirin.
TagResolver	isteğe bağlı	Paywall metni içindeki özel etiketleri çözümlemek için `AdaptyUiTagResolver` kullanın. Bu çözümleyici bir etiket parametresi alır ve bunu ilgili bir dizeye dönüştürür. Daha fazla bilgi için Paywall Builder’da Özel Etiketler konusuna bakın.
ObserverModeHandler	Observer modu için zorunlu	Bir önceki adımda uyguladığınız `AdaptyUiObserverModeHandler`.
variationId	zorunlu	Varyasyonun dize tanımlayıcısı. `AdaptyPaywall` nesnesinin `variationId` özelliğini kullanarak alabilirsiniz.
transaction	zorunlu	iOS, StoreKit1 için: bir `SKPaymentTransaction` nesnesi. iOS, StoreKit 2 için: Transaction nesnesi. Android için: Satın almanın billing kütüphanesi Purchase sınıfının bir örneği olduğu satın almanın dize tanımlayıcısı (`purchase.getOrderId()`).

Paywall’ları sunmaya başlamadan önce (Genişletmek için tıklayın)

Adapty’yi Google Play ile ve App Store ile başlangıç entegrasyonunu kurun.
Adapty SDK’yı yükleyin ve yapılandırın. observerMode parametresini true olarak ayarladığınızdan emin olun. Framework’e özgü talimatlarımıza bakın: Android, React Native, Flutter ve Unity.
Adapty Kontrol Paneli’nde ürünler oluşturun.
Adapty Kontrol Paneli’nde paywall’ları yapılandırın, ürünleri bunlara atayın ve Paywall Builder kullanarak özelleştirin.
Adapty Kontrol Paneli’nde placement’lar oluşturun ve paywall’larınızı bunlara atayın.
Mobil uygulama kodunuzda Paywall Builder paywall’larını ve yapılandırmalarını getirin.

AdaptyUiObserverModeHandler’ı uygulayın. AdaptyUiObserverModeHandler’ın callback’i (onPurchaseInitiated), kullanıcı bir satın alma işlemi başlattığında sizi bilgilendirir. Bu callback’e yanıt olarak kendi özel satın alma flow’unuzu şu şekilde tetikleyebilirsiniz:

val observerModeHandler =
AdaptyUiObserverModeHandler { product, paywall, paywallView, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, paywall, paywallView, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

Ayrıca, bu callback’leri AdaptyUI’ya çağırmayı unutmayın. Bu, yükleyiciyi göstermek gibi düzgün paywall davranışı için gereklidir:

Kotlin’de Callback	Java’da Callback	Açıklama
onStartPurchase()	onStartPurchase.invoke()	Satın alma işleminin başladığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.
onFinishPurchase()	onFinishPurchase.invoke()	Satın alma işleminin başarıyla tamamlandığını, tamamlanamadığını veya iptal edildiğini AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.

Görsel paywall’ı görüntüleyebilmek için önce başlatmanız gerekir. Bunun için AdaptyUI.getPaywallView() metodunu çağırın veya doğrudan AdaptyPaywallView oluşturun:

val paywallView = AdaptyUI.getPaywallView(
    activity,
    viewConfiguration,
    products,
    AdaptyPaywallInsets.of(topInset, bottomInset),
    eventListener,
    personalizedOfferResolver,
    tagResolver,
    observerModeHandler,
)

//======= OR =======

val paywallView =
     AdaptyPaywallView(activity) // or retrieve it from xml
...
with(paywallView) {
    setEventListener(eventListener)
    setObserverModeHandler(observerModeHandler)
    showPaywall(
        viewConfiguration,
        products,
        AdaptyPaywallInsets.of(topInset, bottomInset),
        personalizedOfferResolver,
        tagResolver,
    )
}

AdaptyPaywallView paywallView = AdaptyUI.getPaywallView(
        activity,
        viewConfiguration,
        products,
        AdaptyPaywallInsets.of(topInset, bottomInset),
        eventListener,
        personalizedOfferResolver,
        tagResolver,
        observerModeHandler
);

//======= OR =======

AdaptyPaywallView paywallView =
  new AdaptyPaywallView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
paywallView.setEventListener(eventListener);
paywallView.setObserverModeHandler(observerModeHandler);
paywallView.showPaywall(viewConfiguration, products, AdaptyPaywallInsets.of(topInset, bottomInset), personalizedOfferResolver);

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

Görünüm başarıyla oluşturulduktan sonra, onu görünüm hiyerarşisine ekleyip görüntüleyebilirsiniz.

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
Products	isteğe bağlı	Ekrandaki ürünlerin görüntülenme zamanlamasını optimize etmek için bir `AdaptyPaywallProduct` dizisi sağlayın. `null` geçilirse, AdaptyUI gerekli ürünleri otomatik olarak çeker.
ViewConfiguration	zorunlu	Paywallın görsel ayrıntılarını içeren bir `AdaptyViewConfiguration` nesnesi sağlayın. Bunu yüklemek için `Adapty.getViewConfiguration(paywall)` metodunu kullanın. Daha fazla bilgi için Paywall’ın görsel yapılandırmasını çekme konusuna bakın.
Insets	zorunlu	Sistem çubuklarının kapladığı alan hakkında bilgi içeren ve içerik için dikey kenar boşlukları oluşturan bir `AdaptyPaywallInsets` nesnesi tanımlayın. `AdaptyPaywallView` üzerinde ne durum çubuğu ne de gezinme çubuğu çakışıyorsa `AdaptyPaywallInsets.NONE` geçin. Sistem çubuklarının kullanıcı arayüzünüzün bir bölümünü kapladığı tam ekran modunda, inset’leri tablonun altında gösterildiği şekilde alın.
EventListener	isteğe bağlı	Paywall olaylarını izlemek için bir `AdaptyUiEventListener` sağlayın. Kullanım kolaylığı açısından AdaptyUiDefaultEventListener’ı genişletmeniz önerilir. Daha fazla bilgi için Paywall olaylarını işleme konusuna bakın.
PersonalizedOfferResolver	isteğe bağlı	Kişiselleştirilmiş fiyatlandırmayı (daha fazla bilgi) belirtmek için `AdaptyUiPersonalizedOfferResolver` uygulayın ve `AdaptyPaywallProduct`’ı fiyat kişiselleştirilmişse true, aksi takdirde false ile eşleştiren kendi mantığınızı geçirin.
TagResolver	isteğe bağlı	Paywall metnindeki özel etiketleri çözümlemek için `AdaptyUiTagResolver` kullanın. Bu çözümleyici bir etiket parametresi alır ve bunu karşılık gelen bir dizeye çözümler. Daha fazla bilgi için Paywall Builder’da Özel Etiketler konusuna bakın.
ObserverModeHandler	Observer modu için zorunlu	Önceki adımda uyguladığınız `AdaptyUiObserverModeHandler`.
variationId	zorunlu	Varyasyonun string tanımlayıcısı. `AdaptyPaywall` nesnesinin `variationId` özelliğini kullanarak alabilirsiniz.
transaction	zorunlu	iOS, StoreKit1 için: bir `SKPaymentTransaction` nesnesi. iOS, StoreKit 2 için: Transaction nesnesi. Android için: satın alma işleminin billing library Purchase sınıfının bir örneği olduğu satın alma işleminin String tanımlayıcısı (`purchase.getOrderId()`).

Tam ekran modunda sistem çubuklarının arayüzünüzün bir bölümünü kapladığı durumlarda, inset’leri şu şekilde alın:

import androidx.core.graphics.Insets
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat

//create extension function
fun View.onReceiveSystemBarsInsets(action: (insets: Insets) -> Unit) {
    ViewCompat.setOnApplyWindowInsetsListener(this) { _, insets ->
        val systemBarInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        ViewCompat.setOnApplyWindowInsetsListener(this, null)
        action(systemBarInsets)
        insets
    }
}
//and then use it with the view
paywallView.onReceiveSystemBarsInsets { insets ->
    val paywallInsets = AdaptyPaywallInsets.of(insets.top, insets.bottom)
    paywallView.setEventListener(eventListener)
    paywallView.setObserverModeHandler(observerModeHandler)
    paywallView.showPaywall(viewConfig, products, paywallInsets, personalizedOfferResolver, tagResolver)
}

import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;

...

ViewCompat.setOnApplyWindowInsetsListener(paywallView, (view, insets) -> {
    Insets systemBarInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    ViewCompat.setOnApplyWindowInsetsListener(paywallView, null);
  
    AdaptyPaywallInsets paywallInsets =
                 AdaptyPaywallInsets.of(systemBarInsets.top, systemBarInsets.bottom);
    paywallView.setEventListener(eventListener);
    paywallView.setObserverModeHandler(observerModeHandler);
    paywallView.showPaywall(viewConfiguration, products, paywallInsets, personalizedOfferResolver, tagResolver);
            
    return insets;
});

Döndürür:

Nesne	Açıklama
`AdaptyPaywallView`	İstenen paywall ekranını temsil eden nesne.

Warning

Satın alma işlemlerini paywall’larla ilişkilendirmeyi unutmayın. Aksi takdirde Adapty, satın almanın hangi paywall’dan geldiğini belirleyemez.