Bu rehber, Adapty’yi özel paywall’larınıza nasıl entegre edeceğinizi açıklar. Paywall uygulamanız üzerinde tam kontrolü elinizde tutarken, Adapty SDK ürünleri getirir, yeni satın almaları yönetir ve önceki satın almaları geri yükler.

Başlamadan önce

Ürünleri ayarlayın

Uygulama içi satın almaları 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)
• Paywalllar – hangi ürünlerin sunulacağını tanımlayan yapılandırmalar. Adapty’de paywalllar, ürünleri almanın tek yoludur; ancak bu tasarım sayesinde uygulama kodunuza dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz.
• Placement’lar – uygulamanızda paywallları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Kontrol panelinde placement’lar için paywalllar ayarlarsınız, ardından kodunuzda placement ID’si ile bunları talep edersiniz. Bu, A/B testleri yapmanızı ve farklı kullanıcılara farklı paywalllar göstermenizi kolaylaştırır.

Özel paywall üzerinde çalışıyor olsanız bile bu kavramları anladığınızdan emin olun. Temel olarak bunlar, uygulamanızda sattığınız ürünleri yönetme yönteminizdir.

Özel paywallinizi uygulamak için bir paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekir. Bu yapılandırma, ürünlerinizi almanıza olanak tanır. Kontrol panelinde ne yapmanız gerektiğini anlamak için buradaki hızlı başlangıç kılavuzunu takip edin.

Kullanıcıları yönetin

Kendi tarafınızda backend kimlik doğrulaması ile veya olmadan çalışabilirsiniz.

Ancak Adapty SDK, anonim ve kimliği doğrulanmış kullanıcıları farklı şekilde ele alır. Ayrıntıları anlamak ve kullanıcılarla doğru şekilde çalıştığınızdan emin olmak için kimlik doğrulama hızlı başlangıç kılavuzunu okuyun.

Adım 1. Ürünleri getirin

Özel paywall’ınız için ürünleri getirmek üzere şunları yapmanız gerekir:

1. getFlow metoduna placement ID’sini geçirerek flow nesnesini alın.
2. getPaywallProducts metodunu kullanarak bu flow için ürünler dizisini alın.

async function loadPaywall() {
  try {
    const flow: AdaptyFlow = await adapty.getFlow('YOUR_PLACEMENT_ID');
    const products: AdaptyPaywallProduct[] = await adapty.getPaywallProducts(flow);
    
    // Use products to build your custom paywall UI
  } catch (error) {
    // Handle the error
  }
}

Adım 2. Satın almaları kabul edin

Kullanıcı özel paywallınızdaki bir ürüne dokunduğunda, seçilen ürünle birlikte makePurchase metodunu çağırın. Bu işlem satın alma akışını yönetir ve güncellenmiş profili döndürür.

async function purchaseProduct(product: AdaptyPaywallProduct) {
  try {
    const purchaseResult: AdaptyPurchaseResult = await adapty.makePurchase(product);
    
    switch (purchaseResult.type) {
      case 'success':
        // Purchase successful, profile updated
        break;
      case 'user_cancelled':
        // User canceled the purchase
        break;
      case 'pending':
        // Purchase is pending (e.g., user will pay offline with cash)
        break;
    }
  } catch (error) {
    // Handle the error
  }
}

Adım 3. Satın almaları geri yükleyin

Uygulama mağazaları, abonelik sunan tüm uygulamaların kullanıcılara satın almalarını geri yükleyebilecekleri bir yol sağlamasını zorunlu kılar.

Kullanıcı geri yükle düğmesine dokunduğunda restorePurchases metodunu çağırın. Bu işlem, satın alma geçmişlerini Adapty ile senkronize eder ve güncellenmiş profili döndürür.

async function restorePurchases() {
  try {
    const profile: AdaptyProfile = await adapty.restorePurchases();
    // Restore successful, profile updated
  } catch (error) {
    // Handle the error
  }
}

Sonraki adımlar

Paywallınız uygulamada gösterilmeye hazır. App Store sandbox ortamında veya Google Play Store’da satın almalarınızı test ederek paywall üzerinden bir test satın almasını tamamlayabildiğinizden emin olun. Bunun üretime hazır bir uygulamada nasıl çalıştığını görmek için örnek uygulamamızdaki CustomPurchaseScreen.tsx dosyasına göz atın; bu dosya, uygun hata işleme, yükleme durumları ve UI durum yönetimiyle satın alma işlemini göstermektedir.

Ardından, paywallı gösterip göstermeyeceğinizi veya ücretli özelliklere erişim izni verip vermeyeceğinizi belirlemek için kullanıcıların satın almalarını tamamlayıp tamamlamadığını kontrol edin.