Flutter SDK ile mobil uygulamada satın alma yapma

Mobil uygulamanızda paywallları görüntülemek, kullanıcılara premium içerik veya hizmetlere erişim sunmanın temel adımlarından biridir. Ancak, bir paywallı göstermek yalnızca Adapty’nin ekranı kendisi render ettiği durumlarda —yani bir flow veya eski Paywall Builder’dan bir paywall— satın alma işlemini tek başına destekler.

Ekranı kendi kodunuzda render ediyorsanız, satın alma işlemini tamamlamak ve istenen içeriğin kilidini açmak için .makePurchase() adlı ayrı bir metot kullanmanız gerekir. Bu metot, kullanıcıların paywalllarla etkileşime geçmesi ve istedikleri işlemleri gerçekleştirmesi için bir köprü görevi görür.

Ürününü satın almaya çalışan kullanıcı için paywallınızda aktif bir promosyon teklifi varsa, Adapty bunu satın alma sırasında otomatik olarak uygular.

Başlangıç yapılandırmasını tek bir adımı atlamadan tamamladığınızdan emin olun. Bu olmadan satın almaları doğrulayamayız.

Satın alma işlemi yap

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

İstek parametreleri:

Yanıt parametreleri:

Satın alma sırasında aboneliği değiştirme

Bir kullanıcı mevcut aboneliğini yenilemek yerine yeni bir abonelik seçtiğinde, bu işlemin nasıl gerçekleşeceği uygulama mağazasına göre değişir:

• App Store’da abonelik, abonelik grubu içinde otomatik olarak güncellenir. Kullanıcı bir gruptan abonelik satın alırken başka bir gruptan aktif aboneliği varsa, her iki abonelik de aynı anda aktif olur.
• Google Play’de abonelik otomatik olarak güncellenmez. Geçişi aşağıda açıklandığı şekilde mobil uygulama kodunuzda yönetmeniz gerekir.

Android’de aboneliği başka bir abonelikle değiştirmek için .makePurchase() metodunu ek parametre ile çağırın:

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // başarılı çapraz yükseltme
} on AdaptyError catch (adaptyError) {
  // Hatayı işle
} catch (e) {
  // Hatayı işle
}

Ek istek parametresi:

Google Developer belgelerinde abonelikler ve değiştirme modları hakkında daha fazla bilgi edinebilirsiniz:

• Değiştirme modları hakkında
• Google’ın değiştirme modları için önerileri
• Değiştirme modu CHARGE_PRORATED_PRICE. Not: bu yöntem yalnızca abonelik yükseltmeleri için kullanılabilir. Düşürme işlemleri desteklenmez.
• Değiştirme modu DEFERRED. Not: Gerçek abonelik değişikliği yalnızca mevcut abonelik faturalandırma dönemi sona erdiğinde gerçekleşir.

iOS’ta teklif kodlarını kullanma

Uygulamanızda kod kullanma sayfasını görüntülemek için:

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

App Store’dan tanıtılan uygulama içi satın almalar

Kullanıcı App Store ürün sayfanızdan bir satın alma başlattığında ve işlem uygulamanıza aktarıldığında, SDK ürünü didReceivePromotedPurchaseStream’e iletir. Stream’e abone olun ve ürünü makePromotedPurchase’a geçirin:

Adapty().didReceivePromotedPurchaseStream.listen((product) async {
  try {
    final result = await Adapty().makePromotedPurchase(product: product);
    // process the purchase result
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
});

activate çağrısının hemen ardından, uygulama başlangıcında abone olun; böylece promosyonlu bir satın alma gelmeden önce listener hazır olur. didReceivePromotedPurchaseStream, olayları yeniden oynatmayan bir broadcast stream’dir: hiçbir şey dinlemiyorken iletilen bir ürün kaybolur.

makePromotedPurchase, herhangi bir satın alma parametresi almaz; çünkü promosyonlu bir ürün App Store’dan gelir ve herhangi bir paywall bağlamı taşımaz. makePurchase ile aynı AdaptyPurchaseResult değerini döndürür.

Yükseltilen ürün bir abonelik teklifi içeriyorsa, SDK bunu satın alma sırasında otomatik olarak uygular. Teklif, iOS 18.0 ve sonrasında onu açığa çıkaran App Store satın alma niyetinden okunur. iOS 16.4–17.x sürümlerinde ise satın alma temel fiyat üzerinden gerçekleşir.

Ön ödemeli planları yönetme (Android)

Uygulama kullanıcılarınız ön ödemeli planlar satın alabiliyorsa (örneğin, birkaç aylık yenilenmez abonelik), ön ödemeli planlar için bekleyen işlemleri etkinleştirebilirsiniz.

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);