Flutter SDK'da Observer mode ile flow'ları sunma

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

Ekranı builder’da tasarlayın, Adapty SDK onu natively render eder. Metin, düzen ve fiyatlandırmayı istediğiniz zaman güncelleyin; uygulama güncellemesi gerekmez.

Bu kılavuz, bir flow’un nasıl sunulacağını ve satın alma callback’lerinin nasıl yönetileceğini gösterir. Adapty satın almaları sizin adınıza 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:

Uygulama

Observer modunda SDK, satın alma işlemlerini sizin adınıza gerçekleştirmez. Bir kullanıcı Adapty tarafından render edilen bir flow’daki satın alma veya geri yükleme düğmesine dokunduğunda, SDK sizin AdaptyUIObserverModeResolver’ınızı çağırır — satın alma veya geri yükleme işlemini orada kendi kodunuzla gerçekleştirin.

  1. AdaptyUIObserverModeResolver’ı uygulayın:

    class MyObserverModeResolver extends AdaptyUIObserverModeResolver {
      @override
      void observerModeDidInitiatePurchase(
        AdaptyUIFlowView view,
        AdaptyPaywallProduct product,
        void Function() onStartPurchase,
        void Function() onFinishPurchase,
      ) {
        onStartPurchase(); // the view shows its loading indicator
        // make the purchase with your own code, then:
        onFinishPurchase(); // the view hides the loading indicator
      }
    
      @override
      void observerModeDidInitiateRestore(
        AdaptyUIFlowView view,
        void Function() onStartRestore,
        void Function() onFinishRestore,
      ) {
        onStartRestore();
        // restore purchases with your own code, then:
        onFinishRestore();
      }
    }

    observerModeDidInitiatePurchase metodu, kullanıcının bir satın alma işlemi başlattığını; observerModeDidInitiateRestore ise kullanıcının bir geri yükleme işlemi başlattığını size bildirir. Buna yanıt olarak özel satın alma veya geri yükleme flow’unuzu tetikleyin.

    Ayrıca, satın alma veya geri yükleme sürecini AdaptyUI’a bildirmek için aşağıdaki callback’leri çağırmayı unutmayın. Bu, yükleyiciyi göstermek gibi düzgün flow davranışı için gereklidir:

    CallbackDescription
    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()Geri yükleme işleminin başladığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.
    onFinishRestore()Geri yükleme işleminin tamamlandığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır.

    onFinishPurchase() çağrısından sonra, flow; iptal edilmiş bir satın alma dahil ne olursa olsun aynı sonuç eylemlerini çalıştırır: iOS’ta When pending eylemleri, Android’de ise When succeeded eylemleri. Satın alma sonucuna bağlı olan herhangi bir ekranı (örneğin teşekkür ekranı) kendi kodunuzdan gösterin; zira sonucu yalnızca kodunuz bilir. onFinishRestore() çağrısından sonra ise flow, ne olursa olsun When restore completed eylemlerini çalıştırır.

  2. Herhangi bir ekran gösterilmeden önce resolver’ı kaydedin:

    AdaptyUI().setObserverModeResolver(MyObserverModeResolver());
  3. Flow görünümünü zamanki gibi oluşturun ve sunun: flow’u alın ve görünümünü oluşturun, ardından sunun. Ekstra parametre gerekmez — resolver kaydedildikten sonra Adapty tarafından render edilen her flow, satın almaları ve geri yüklemeleri bu resolver üzerinden yönlendirir.

Warning

İşlemi bildirmeyi ve paywall ile ilişkilendirmeyi unutmayın. Aksi takdirde Adapty işlemi tanımayacak ve satın alma işleminin kaynak paywall’ını belirleyemeyecektir.