Flow ve paywallları göster - Flutter

Bir flow veya eski Paywall Builder’da bir paywall oluşturduysanız, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmeniz gerekmez. Böyle bir flow veya paywall, neyin nasıl gösterileceğini zaten içerir.

Warning

Bu rehber, Adapty tarafından render edilen flow’lar ve paywall’lar içindir. Özel paywall’ları sunmak için bkz. Özel paywall’ları sunma.

Adapty Flutter SDK, flow’ları ve paywall’ları sunmak için iki yöntem sunar:

  • Bağımsız ekran

  • Gömülü widget

Bağımsız ekran olarak göster

Bir flow veya paywall’ı bağımsız ekran olarak görüntülemek için createFlowView metoduyla oluşturulan view üzerinde view.present() metodunu kullanın. Varsayılan olarak, bir view kapatıldığında bellekten serbest bırakılır; dolayısıyla tekrar gösteremezsiniz. Flow veya paywall’ı yeniden görüntülemeniz gerekiyorsa createFlowView’ı bir kez daha çağırarak yeni bir view örneği oluşturun ya da SDK 4.1 ve sonrasında serbest bırakmadan kapatın.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Flow’u veya paywallı kapat

Flow’u veya paywallı programatik olarak kapatmanız gerektiğinde dismiss() metodunu kullanın:

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Note

Bir view’ı kapatmak onu bellekten siler — kapatılmış bir view yeniden gösterilemez. Bunun yerine createFlowView ile yeni bir tane oluşturun.

SDK 4.1’den itibaren, view’ı bellekte tutmak için destroy: false parametresini geçebilirsiniz:

await view.dismiss(destroy: false);

Bu görünümü tekrar gösterdiğinizde kullanıcı, flow’un oluşturduğu durumla birlikte ayrıldığı ekrana geri döner. Bu şekilde saklanan bir görünüm, siz serbest bırakana kadar bellekte kalır.

SDK 4.3.0’dan itibaren, sakladığınız bir görünüme artık ihtiyaç duymadığınızda destroy() ile serbest bırakın:

await view.dismiss(destroy: false);
// ...
await view.destroy();

destroy(), oluşturduğunuz ancak hiç sunmadığınız bir view’ı ve kullanıcının iOS’ta aşağı kaydırdığı page-sheet view’ı da serbest bırakır. Normal bir dismiss() işleminin ardından çağırmayın: o view zaten serbest bırakılmıştır ve çağrı wrongParam hatasıyla başarısız olur. Daha eski SDK sürümlerinde, saklanan view’ı yeniden sunun ve serbest bırakmak için destroy: true ile dismiss edin.

Varsayılan kapatma eylemi, daha önce destroy: false ile görünümü saklasanız bile view.dismiss() çağırarak görünümü serbest bırakır. Kullanıcı görünümü kapattığında saklamak istiyorsanız flowViewDidPerformAction metodunu override edin ve görünümü kendiniz kapatın. Bu metot uygulamanızdaki her flow ve paywall için çalıştığından, yalnızca yeniden göstermeyi planladığınız görünümü saklamak için view.id değerini karşılaştırın. URL açmayı korumak için OpenUrlAction case’ini de dahil edin:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
  switch (action) {
    case const CloseAction():
      // keptView is the view your app stored to present again
      view.dismiss(destroy: view.id != keptView?.id);
      break;
    case OpenUrlAction(:final url, :final openIn):
      AdaptyUI().openUrl(url, openIn: openIn);
      break;
    default:
      break;
  }
}

Saklanan view’i elinizde tutun: flow veya paywall’ı yeniden göstermek ve destroy() ile serbest bırakmak için buna ihtiyacınız olacak. view.dismiss() çağrısı da dahil olmak üzere diğer tüm çağrılar view’i serbest bırakır; flowViewDidReceiveError içindeki çağrı da buna dahildir. Bir view hatası sonrasında createFlowView ile yeni bir view oluşturun.

Diyalog göster

Android’de bir flow veya paywall görünümü gösterildiğinde, native uyarı diyalogları yerine bu metodu kullanın. Android’de normal uyarılar görünümün arkasında kalır ve kullanıcılar tarafından görülemez. Bu metod, diyaloğun tüm platformlarda flow veya paywall’ın üzerinde düzgün şekilde gösterilmesini sağlar.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

iOS sunum stilini yapılandırın

present() metoduna iosPresentationStyle parametresini geçirerek flow veya paywall’ın iOS’ta nasıl sunulacağını yapılandırın. Bu parametre AdaptyUIIOSPresentationStyle.fullScreen (varsayılan) veya AdaptyUIIOSPresentationStyle.pageSheet değerlerini kabul eder.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Kullanıcı, sayfa kaydırarak (page sheet) aşağı kaydırıp kapatabilir. Görünüm, dismiss() çağrısı yapılmadan bellekte kalır: yeniden sunabilir ya da SDK 4.3.0 ve sonrasında destroy() ile serbest bırakabilirsiniz.

Widget hiyerarşisine gömme

Mevcut widget ağacınıza bir flow veya paywall gömmek için AdaptyUIFlowPlatformView widget’ını doğrudan Flutter widget hiyerarşinizde kullanın.

AdaptyUIFlowPlatformView(
  flow: flow, // The flow object you fetched
  locale: 'en', // The localization to render the flow with
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidReceiveError: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Android platform view’ın çalışması için MainActivity’nizin FlutterFragmentActivity’yi genişlettiğinden emin olun:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}

Paywall Builder kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmeniz gerekmez. Böyle bir paywall, hem ne gösterileceğini hem de nasıl gösterileceğini içerir.

Warning

Bu kılavuz yalnızca Adapty SDK 3.x için eski Paywall Builder’da oluşturulmuş paywall’ları kapsar. SDK v3.2.0 veya daha yenisini gerektirir. SDK 2.x veya öncesi için oluşturulmuş bir paywall’ı ya da özel bir paywall’ı sunmak farklı çalışır.

Adapty Flutter SDK, paywall’ları sunmak için iki yol sunar:

  • Bağımsız ekran

  • Gömülü widget

Bağımsız ekran olarak sunma

Bir paywall’ı bağımsız ekran olarak görüntülemek için, createPaywallView metoduyla oluşturulan view üzerinde view.present() metodunu kullanın. Her view yalnızca bir kez kullanılabilir. Paywall’ı tekrar göstermeniz gerekiyorsa, yeni bir view örneği oluşturmak için createPaywallView’ı bir kez daha çağırın.

Warning

Aynı view’ı yeniden oluşturmadan tekrar kullanmak AdaptyUIError.viewAlreadyPresented hatasına yol açabilir.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Paywall’ı kapatma

Paywall’ı programatik olarak kapatmanız gerektiğinde dismiss() metodunu kullanın:

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Diyalog gösterme

Android’de bir paywall görünümü sunulduğunda, yerel uyarı diyalogları yerine bu metodu kullanın. Android’de normal uyarılar paywall görünümünün arkasında kalır ve kullanıcılar tarafından görülemez. Bu metod, tüm platformlarda diyaloğun paywall’ın üzerinde düzgün şekilde gösterilmesini sağlar.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

iOS sunum stilini yapılandırma

present() metoduna iosPresentationStyle parametresini geçirerek paywallın iOS’ta nasıl sunulacağını yapılandırın. Parametre AdaptyUIIOSPresentationStyle.fullScreen (varsayılan) veya AdaptyUIIOSPresentationStyle.pageSheet değerlerini kabul eder.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Widget hiyerarşisine gömme

Bir paywall’ı mevcut widget ağacınıza gömmek için AdaptyUIPaywallPlatformView widget’ını doğrudan Flutter widget hiyerarşinizde kullanın.

AdaptyUIPaywallPlatformView(
  paywall: paywall, // The paywall object you fetched
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidFailRendering: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Android platform view’un çalışması için MainActivity sınıfınızın FlutterFragmentActivity’yi extend ettiğinden emin olun:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}