Unity SDK'da özel paywall'ınızda satın almaları etkinleştirin

Bu rehber, Adapty’yi özel paywalllarınıza nasıl entegre edeceğinizi açıklar. Paywall uygulaması üzerinde tam kontrolü elinizde tutarken Adapty SDK ürünleri getirir, yeni satın almaları yönetir ve önceki satın almaları geri yükler. Bu rehber Adapty Unity SDK v4 (beta) API’lerini kullanır — v3 kullanıyorsanız ilgili metod isimlerini öğrenmek için migration guide sayfasına bakın.

Başlamadan önce

Ürünleri ayarlama

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 ürünlere yalnızca paywalllar aracılığıyla ulaşılabilir; bu tasarım sayesinde uygulama koduna dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz. SDK v4’te bir placement’ın paywall varyantları bir flow nesnesi tarafından taşınır — bir flow çeker ve içindeki ürünleri sorgularsınız.
• Placement’lar – uygulamanızda paywallları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Kontrol panelinde placement’lar için paywallları ayarlar, ardından kodunuzda placement ID’siyle bunları talep edersiniz. Bu yaklaşım A/B testleri çalıştırmayı ve farklı kullanıcılara farklı paywalllar göstermeyi kolaylaştırır.

Özel paywall kullanıyor olsanız bile bu kavramları anladığınızdan emin olun. Bunlar temelde 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ızı sağlar. Kontrol panelinde yapmanız gerekenleri anlamak için buradaki hızlı başlangıç kılavuzunu takip edin.

Kullanıcıları yönetme

Kendi tarafınızda backend kimlik doğrulaması ile 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 düzgün ş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. placement ID’sini GetFlow metoduna geçirerek flow nesnesini alın.
2. Bu flow için ürünler dizisini GetPaywallProducts metodunu kullanarak alın.

using AdaptySDK;

void LoadPaywall() {
    Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
        if (error != null) {
            // Handle the error
            return;
        }

        Adapty.GetPaywallProducts(flow, (products, productsError) => {
            if (productsError != null) {
                // Handle the error
                return;
            }

            // Use products to build your custom paywall UI
        });
    });
}

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

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.

using AdaptySDK;

void PurchaseProduct(AdaptyPaywallProduct product) {
    Adapty.MakePurchase(product, (result, error) => {
        if (error != null) {
            // Handle the error
            return;
        }

        switch (result.Type) {
            case AdaptyPurchaseResultType.Success:
                var profile = result.Profile;
                // Purchase successful, profile updated
                break;
            case AdaptyPurchaseResultType.UserCancelled:
                // User canceled the purchase
                break;
            case AdaptyPurchaseResultType.Pending:
                // Purchase is pending (e.g., user will pay offline with cash)
                break;
        }
    });
}

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

Uygulama mağazaları, abonelik içeren tüm uygulamaların kullanıcılara satın almalarını geri yükleme imkânı sunmasını zorunlu kılar.

Kullanıcı geri yükleme düğmesine bastığında 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.

using AdaptySDK;

void RestorePurchases() {
    Adapty.RestorePurchases((profile, error) => {
        if (error != null) {
            // Handle the error
            return;
        }

        // Restore successful, profile updated
    });
}

Adım 4. Abonelik durumunu kontrol edin

Bir satın alma veya geri yükleme işleminin ardından, paywall’ı gösterip göstermeyeceğinize veya ücretli özelliklerin kilidini açıp açmayacağınıza karar vermek için kullanıcının access level değerini kontrol edin. MakePurchase ve RestorePurchases metodları zaten güncellenmiş profili döndürür; uygulamanın başka bir yerinde mevcut duruma ihtiyaç duyduğunuzda GetProfile metodunu kullanın:

using AdaptySDK;

void CheckPremiumAccess() {
    Adapty.GetProfile((profile, error) => {
        if (error != null) {
            // Handle the error
            return;
        }

        var hasPremiumAccess =
            profile.AccessLevels.TryGetValue("premium", out var premium) && premium.IsActive;
        // Grant access to paid features if hasPremiumAccess is true
    });
}

Abonelik durumunu kontrol etmenin ve gerçek zamanlı güncellemeleri dinlemek de dahil olmak üzere izlemenin daha fazla yolu için bkz. Abonelik durumunu kontrol etme.

Sonraki adımlar

Paywall’unuz uygulamada gösterilmeye hazır. Paywall üzerinden test satın alımını tamamlayabildiğinizden emin olmak için App Store sandbox ortamında veya Google Play Store’da satın alımlarınızı test edin.