Thực hiện mua hàng trong ứng dụng di động với Unity SDK

Hiển thị paywall trong ứng dụng di động của bạn là một bước thiết yếu để cung cấp cho người dùng quyền truy cập vào nội dung hoặc dịch vụ cao cấp. Tuy nhiên, việc hiển thị paywall chỉ tự động hỗ trợ mua hàng khi Adapty render màn hình đó — tức là một flow, hoặc paywall từ Paywall Builder cũ.

Nếu bạn tự render màn hình trong code của mình, bạn phải sử dụng một phương thức riêng gọi là .makePurchase() để hoàn tất giao dịch mua và mở khóa nội dung mong muốn. Phương thức này đóng vai trò là cổng để người dùng tương tác với các paywall và tiến hành các giao dịch họ muốn.

Nếu paywall của bạn có ưu đãi đang hoạt động cho sản phẩm mà người dùng muốn mua, Adapty sẽ tự động áp dụng ưu đãi đó vào thời điểm mua hàng.

Hãy đảm bảo bạn đã hoàn tất cấu hình ban đầu mà không bỏ sót bất kỳ bước nào. Nếu không, chúng tôi không thể xác thực các giao dịch mua hàng.

Thực hiện mua hàng

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;
    }
  });
}

Tham số yêu cầu:

Tham số phản hồi:

Thay đổi gói đăng ký khi mua hàng

Khi người dùng chọn một gói đăng ký mới thay vì gia hạn gói hiện tại, cách hoạt động phụ thuộc vào cửa hàng:

• Đối với App Store, gói đăng ký được tự động cập nhật trong cùng nhóm gói đăng ký. Nếu người dùng mua gói đăng ký từ một nhóm trong khi đã có gói đăng ký từ nhóm khác, cả hai gói sẽ được kích hoạt đồng thời.
• Đối với Google Play, gói đăng ký không được tự động cập nhật. Bạn cần quản lý việc chuyển đổi trong code ứng dụng như mô tả bên dưới.

Để thay thế gói đăng ký bằng một gói khác trên Android, gọi phương thức .makePurchase() với tham số bổ sung:

// 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
});

Tham số yêu cầu bổ sung:

Bạn có thể đọc thêm về gói đăng ký và các chế độ thay thế trong tài liệu Google Developer:

• Về các chế độ thay thế
• Khuyến nghị của Google về các chế độ thay thế
• Chế độ thay thế CHARGE_PRORATED_PRICE. Lưu ý: phương thức này chỉ áp dụng cho việc nâng cấp gói đăng ký. Không hỗ trợ hạ cấp.
• Chế độ thay thế DEFERRED. Lưu ý: Việc thay đổi gói đăng ký thực sự chỉ xảy ra khi chu kỳ thanh toán hiện tại kết thúc.

Đổi mã ưu đãi trên iOS

Để hiển thị trang đổi mã trong ứng dụng của bạn:

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

Sản phẩm mua trong ứng dụng được quảng bá từ App Store

Khi người dùng bắt đầu mua hàng từ trang sản phẩm App Store của bạn, SDK sẽ chuyển sản phẩm đến bạn qua OnReceivePromotedPurchase và chờ. Việc hoàn tất giao dịch mua hàng là do app của bạn quyết định: truyền sản phẩm vào Adapty.MakePromotedPurchase. Vì bạn kiểm soát thời điểm đó xảy ra, bạn có thể hiển thị màn hình của riêng mình trước khi giao dịch mua bắt đầu.

Nếu sản phẩm được quảng bá có kèm ưu đãi gói đăng ký, SDK sẽ tự động áp dụng ưu đãi đó khi mua. Ưu đãi được đọc từ purchase intent của App Store, vốn chỉ hiển thị trên iOS 18.0 trở lên. Trên iOS 16.4–17.x, giao dịch mua sẽ được thực hiện ở mức giá cơ bản.

IAdaptyEventListener bao gồm phương thức bắt buộc OnReceivePromotedPurchase(AdaptyPromotedProduct), kết hợp với Adapty.MakePromotedPurchase để hoàn tất giao dịch mua bạn nhận được:

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

Quản lý prepaid plans (Android)

Nếu người dùng ứng dụng của bạn có thể mua prepaid plans (ví dụ: mua gói đăng ký không tự gia hạn trong vài tháng), bạn có thể bật pending transactions cho prepaid plans.

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;
    }
});