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:

• Products – kullanıcıların satın alabileceği her şey (abonelikler, consumable’lar, süresiz erişim)
• Custom paywalls – hangi ürünlerin sunulacağını tanımlayan yapılandırmalar. Adapty’de ürünlere ulaşmanın tek yolu paywalllerdir; bu tasarım sayesinde uygulama koduna dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz.
• Placements – uygulamanızda paywallların nerede ve ne zaman gösterileceği (örneğin main, onboarding, settings). Kontrol panelinde placement’lar için paywalllar belirler, ardından kodunuzda placement ID’si ile bunları talep edersiniz. Bu yaklaşım A/B testleri yürütmeyi ve farklı kullanıcılara farklı paywalllar göstermeyi kolaylaştırır.

Bu kavramları özel paywallınızla çalışırken de anladığınızdan emin olun. Temelde bunlar, uygulamanızda sattığınız ürünleri yönetmenin bir yoludur.

Özel paywallınızı hayata geçirmek için bir custom paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekecek. Bu yapı sayesinde ürünlerinizi alabilirsiniz. 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.