Совершение покупок в мобильном приложении в Unity SDK

Отображение пейволов в мобильном приложении — обязательный шаг для предоставления пользователям доступа к премиум-контенту или сервисам. Однако просто показать пейвол достаточно для поддержки покупок только в том случае, если вы используете Paywall Builder для его настройки.

Если вы не используете Paywall Builder, для совершения покупки и открытия нужного контента необходимо вызвать отдельный метод .makePurchase(). Именно через него пользователи взаимодействуют с пейволами и выполняют нужные транзакции. Если на вашем пейволе настроен активный promotional offer для продукта, который пользователь хочет купить, Adapty автоматически применит его в момент покупки.

Убедитесь, что вы выполнили начальную настройку, не пропустив ни одного шага. Без неё мы не сможем валидировать покупки.

Совершение покупки

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

Параметры запроса:

Параметры ответа:

Смена подписки при покупке

Когда пользователь выбирает новую подписку вместо продления текущей, поведение зависит от стора:

• В App Store подписка обновляется автоматически в рамках группы подписок. Если пользователь покупает подписку из одной группы, уже имея активную из другой, обе подписки будут действовать одновременно.
• В Google Play подписка не обновляется автоматически. Переключение нужно реализовать в коде приложения, как описано ниже. Чтобы заменить подписку на другую в Android, вызовите метод .makePurchase() с дополнительным параметром:

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

Дополнительный параметр запроса:

Подробнее о подписках и режимах замены читайте в документации Google Developer:

• О режимах замены
• Рекомендации Google по режимам замены
• Режим замены CHARGE_PRORATED_PRICE. Примечание: этот метод доступен только для апгрейда подписки. Даунгрейд не поддерживается.
• Режим замены DEFERRED. Примечание: фактическая смена подписки произойдёт только по окончании текущего расчётного периода.

Активация промокодов в iOS

Чтобы отобразить экран активации кода в приложении:

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

Встроенные покупки из App Store

Когда пользователь инициирует покупку со страницы вашего продукта в App Store и транзакция переходит в ваше приложение, SDK завершает её автоматически — экран покупки Apple отображается сразу, а Adapty обрабатывает транзакцию как любую другую покупку.

Если продвигаемый продукт содержит подписочный оффер, SDK применяет его при покупке автоматически. Оффер считывается из намерения покупки App Store, которое доступно начиная с iOS 18.0. На iOS 16.4–17.x покупка проходит по базовой цене.

Для обработки продвигаемых покупок в коде интерфейс IAdaptyEventListener включает необходимый метод OnReceivePromotedPurchase(AdaptyPromotedProduct), а для завершения полученной покупки используется Adapty.MakePromotedPurchase:

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

SDK пока не передаёт продвигаемые покупки в этот метод — вместо этого он завершает их автоматически, — поэтому отложить продвигаемую покупку для показа кастомного экрана пока не получится. Тем не менее реализуйте метод (он обязателен для интерфейса); пустое тело является допустимой реализацией.

Управление предоплаченными планами (Android)

Если пользователи вашего приложения могут покупать предоплаченные планы (например, невозобновляемую подписку на несколько месяцев), вы можете включить отложенные транзакции для предоплаченных планов.

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