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

Отображение пейволов в мобильном приложении — необходимый шаг для предоставления пользователям доступа к премиум-контенту или сервисам. Однако сам по себе показ пейвола обеспечивает покупки только тогда, когда Adapty отрисовывает экран — то есть при использовании флоу или пейвола из старого 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 передаёт продукт через OnReceivePromotedPurchase и ждёт. Завершение покупки остаётся за вашим приложением: передайте продукт в Adapty.MakePromotedPurchase. Поскольку вы сами контролируете этот момент, перед началом покупки можно показать собственный экран.

Если рекламируемый продукт содержит предложение по подписке, 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
    });
}

Управление предоплаченными планами (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;
    }
});