Unity SDK ile mobil uygulamada satın alma yapma

Mobil uygulamanızda paywall’ları göstermek, kullanıcılara premium içerik veya hizmetlere erişim sunmanın temel adımlarından biridir. Ancak, paywall’larınızı özelleştirmek için Paywall Builder kullanıyorsanız, bu paywall’ları yalnızca göstermek satın almaları desteklemek için yeterlidir.

Paywall Builder kullanmıyorsanı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 paywall’larla etkileşime geçmesini ve istedikleri işlemleri gerçekleştirmesini sağlayan kapı işlevi görür. Eğer paywallınızda kullanıcının satın almaya çalıştığı ürün için 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ı bile atlamadan tamamladığınızdan emin olun. Bu olmadan satın alımları doğrulayamayız.

Satın alma yapma

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

İ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 süreç uygulama mağazasına göre farklı işler:

• 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 zaten aktif bir aboneliği varsa, her iki abonelik aynı anda aktif olur.
• Google Play’de abonelik otomatik olarak güncellenmez. Geçişi, aşağıda açıklandığı gibi mobil uygulama kodunuzda yönetmeniz gerekir. Android’de aboneliği başka biriyle değiştirmek için .makePurchase() metodunu ek parametre ile çağırın:

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

Ek istek parametresi:

Abonelikler ve değiştirme modları hakkında daha fazla bilgi edinmek için Google Geliştirici belgelerine bakabilirsiniz:

• 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 fatura dönemi sona erdiğinde gerçekleşir.

iOS’ta teklif kodlarını kullanma

Uygulamanızda kod kullanma sayfasını göstermek için:

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

App Store’dan uygulama içi satın almalar

Bir kullanıcı App Store ürün sayfanızdan satın alma başlattığında ve işlem uygulamanıza aktarıldığında, SDK bunu otomatik olarak tamamlar — Apple satın alma sistemi ekranı hemen gösterilir ve Adapty işlemi diğer satın almalar gibi işler.

Tanıtılan ürün bir abonelik teklifi içeriyorsa, SDK satın alma sırasında bu teklifi otomatik olarak uygular. Teklif, App Store satın alma intent’inden okunur; bu bilgi iOS 18.0 ve sonrasında kullanılabilir. iOS 16.4–17.x sürümlerinde ise satın alma temel fiyat üzerinden gerçekleşir.

Tanıtılan satın almaları kodunuzda yönetmek için IAdaptyEventListener, aldığınız bir satın almayı tamamlamaya yarayan Adapty.MakePromotedPurchase ile birlikte kullanılan OnReceivePromotedPurchase(AdaptyPromotedProduct) metodunu içerir:

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

SDK henüz tanıtılan satın almaları bu metoda iletmiyor — bunun yerine onları otomatik olarak tamamlıyor — bu nedenle önce özel bir şey göstermek için tanıtılan bir satın almayı henüz erteleyemezsiniz. Yine de metodu uygulayın (arayüz tarafından zorunludur); boş bir gövde geçerli bir uygulama sayılır.

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

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

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});