Bu kılavuz, Adapty’yi özel paywalllarınıza nasıl entegre edeceğinizi açıklar. Adapty SDK ürünleri çekerken, yeni satın almaları yönetirken ve önceki satın almaları geri yüklerken paywall uygulaması üzerinde tam kontrole sahip olursunuz.

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.
• Placementlar – uygulamanızda paywallları nerede ve ne zaman göstereceğiniz (örneğin main, onboarding, settings). Kontrol panelinde placementlar için paywalllar ayarlarsınız, ardından kodunuzda placement ID’siyle bunları talep edersiniz. Bu sayede A/B testleri çalıştırmak ve farklı kullanıcılara farklı paywalllar göstermek kolaylaşır.

Özel paywall kullanı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 paywallınızı uygulamak için bir paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekir. Bu kurulum, ü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ıyla veya olmadan çalışabilirsiniz.

Ancak Adapty SDK, anonim ve tanımlanmış 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 belirleme hızlı başlangıç kılavuzunu okuyun.

Adım 1. Ürünleri alın

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

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

async function loadPaywall() {
  try {
    const paywall: AdaptyPaywall = await adapty.getPaywall({
      placementId: 'YOUR_PLACEMENT_ID'
    });

    const products: AdaptyPaywallProduct[] = await adapty.getPaywallProducts({
      paywall
    });

    // 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ızda 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 result: AdaptyPurchaseResult = await adapty.makePurchase({ product });

    if (result.type === 'success') {
      // Purchase successful, profile updated
    } else if (result.type === 'user_cancelled') {
      // User canceled the purchase
    } else if (result.type === 'pending') {
      // Purchase is pending (e.g., user will pay offline with cash)
    }
  } catch (error) {
    // Handle the error
  }
}

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

Uygulama mağazaları, abonelik içeren tüm uygulamaların kullanıcıların satın almalarını geri yükleyebileceği bir yol sunmasını şart koşar.

Kullanıcı geri yükleme düğmesine dokunduğunda restorePurchases metodunu çağırın. Bu işlem, satın alma geçmişini 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 paywalldan bir test satın alması tamamlayabildiğinizden emin olun. Bunun üretim ortamına hazır bir uygulamada nasıl çalıştığını görmek için örnek uygulamamızdaki App.tsx dosyasına göz atın; bu dosyada uygun hata yönetimi, yükleme durumları ve kapsamlı SDK entegrasyonuyla birlikte satın alma işleme akışı gösterilmektedir.

Sonraki adımda, paywallı gösterip göstermeyeceğinizi ya da ücretli özelliklere erişim izni verip vermeyeceğinizi belirlemek için kullanıcıların satın alma işlemlerini tamamlayıp tamamlamadığını kontrol edin.