Skip to main content

What's new in Adapty SDK 2.6

💡 If you are migrating from Adapty SDK 1.x.x, we recommend you to read What's new in Adapty SDK 2.0 article first.

Android SDK​

note

Don't forget to configure offers in Google Play Console in Adapty

Google Billing Library v5 and v6 changed the way offers work. Be sure to follow Google Play offers guide to configure them properly.

With the release of Adapty SDK version 2.6.1, we are excited to announce support for . This update includes several improvements and additions to the public API for the native Android, Flutter, React Native. Unity SDK also supports the new versions of billing library but starting with 2.7.0.

Here are the key changes and enhancements:

  1. Unified subscription details: We have removed separate properties for free trials on Android to provide a more streamlined experience.** Instead, we have introduced an optional subscriptionDetails property that consolidates all subscription-related properties. **It includes an introductoryOfferPhases property, which is a list that can contain up to two phases: the free trial phase and the introductory price phase.

    Before (Kotlin)After (Kotlin)
    Checking discount offer eligibilityproduct.introductoryOfferEligibility == AdaptyEligibility.ELIGIBLEproduct.subscriptionDetails?.introductoryOfferEligibility == AdaptyEligibility.ELIGIBLE
    Introductory price infoproduct.introductoryDiscountproduct.subscriptionDetails?.introductoryOfferPhases?.firstOrNull { it.paymentMode in listOf(PaymentMode.PAY_UPFRONT, PaymentMode.PAY_AS_YOU_GO) }
    Free trial infoproduct.freeTrialPeriodproduct.subscriptionDetails?.introductoryOfferPhases?.firstOrNull { it.paymentMode == PaymentMode.FREE_TRIAL }?.subscriptionPeriod
    Free trial info (localized)product.localizedFreeTrialPeriodproduct.subscriptionDetails?.introductoryOfferPhases?.firstOrNull { it.paymentMode == PaymentMode.FREE_TRIAL }?.localizedSubscriptionPeriod

  2. Payment mode for discounts: To align with iOS, we have added the paymentMode property to the AdaptyProductDiscountPhase entity.

  3. Renewal type for subscriptions: We have introduced the renewalType property in the AdaptyProductSubscriptionDetails entity to accommodate the two types of subscriptions available on Google Play: auto-renewable and prepaid.

  4. Price entity updates: The price, localizedPrice, currencyCode and currencySymbol properties have been moved from AdaptyPaywallProduct to a new entity called Price.

  5. SKU details update: The skuDetails property in AdaptyPaywallProduct has been renamed to productDetails to reflect the use of original product entities from Google.

  6. Eligibility status update: In AdaptyEligibility, we have replaced the UNKNOWN value with NOT_APPLICABLE. The latter is used for products that cannot contain offers, such as prepaid products in the Google Play console.

  7. Personalized offers: We have added a boolean parameter isOfferPersonalized to makePurchase(), with a default value of false. For more information, refer to the following documentation.

  8. Offer identification: The offerId property has been added to the AccessLevel and Subscription entities in AdaptyProfile. It is an optional field that represents the discount offer ID from Google Play. Additionally, we want to draw your attention to the fact that the vendorProductId in these entities may contain either productId only or productId:basePlanId.

  9. Replacement mode: We have renamed ProrationMode to ReplacementMode, and the constants have been adjusted to align with Google's standards.

For more detailed information and step-by-step guides on adding products and base plans to the Google Play Store, refer to our documentation.

We hope these updates enhance your experience with Adapty SDK and the integration with Google's new billing system.

Cross-platform SDKs migration​

Determine introductory offer eligibility​

Adapty SDK 2.4.x and older:​
// Adapty 2.4.x and older

try {
  final products = await Adapty().getPaywallProducts(paywall: paywall);
  final product = products[0]; // don't forget to check products count before accessing
  
  if (product.introductoryOfferEligibility == AdaptyEligibility.eligible) {
    // display offer
  } else if (product.introductoryOfferEligibility == AdaptyEligibility.ineligible) {
    // user is not eligible for this offer
  } else {
    // Adapty SDK wasn't able to determine eligibility at this step
    // Refetch products with .waitForReceiptValidation policy:
    final products = await adapty.getPaywallProducts(
      paywall: paywall,
      fetchPolicy: AdaptyIOSProductsFetchPolicy.waitForReceiptValidation,
    );
    
    // if there wasn't error, elegibility should be eligible or ineligible.
  }
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}
Adapty SDK 2.6.0 and newer:​
// Adapty 2.6.0+

try {
  final products = await Adapty().getPaywallProducts(paywall: paywall);
  // at this step you can display products
  // but you shouldn't display offers as eligibilities are not determined yet
  
  final eligibilities = await Adapty().getProductsIntroductoryOfferEligibility(products: products);
  final introEligibility = eligibilities["your_product_id"];
  
  switch (introEligibility) {
    case AdaptyEligibility.eligible:
      // display offer
      break;
    default:
      // don't display offer
      break;
    }
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Displaying product and offers​

Adapty SDK 2.4.x and older:​
// Adapty 2.4.x and older

try {
  final products = await Adapty().getPaywallProducts(paywall: paywall);
  final product = products[0];

  final titleString = product.localizedTitle;
  final priceString = product.localizedPrice;

  // Introductory Offer
  final introductoryDiscount = product.introductoryDiscount;
  
  if (introductoryDiscount != null) {
    final introPrice = introductoryDiscount.localizedPrice;
    final introPeriod = introductoryDiscount.localizedSubscriptionPeriod;
    final introNumberOfPeriods = introductoryDiscount.localizedNumberOfPeriods;
  }

  // Free Trial for Android
  final freeTrialPeriod = product.freeTrialPeriod;
  final localizedFreeTrialPeriod = product.localizedFreeTrialPeriod;
  
  // Promo Offer for iOS¡
  final promoOfferId = product.promotionalOfferId;
  final promoDisount = product.discounts.firstWhere((element) => element.identifier == promoOfferId);
  
  if (promoDisount != null) {
    final promoPrice = promoDisount.localizedPrice;
    final promoPeriod = promoDisount.localizedSubscriptionPeriod;
    final promoNumberOfPeriods = promoDisount.localizedNumberOfPeriods;
  }
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}
Adapty SDK 2.6.0 and newer:​
// Adapty 2.6.0+

try {
  final products = await Adapty().getPaywallProducts(paywall: paywall);
  final product = products[0];

  final titleString = product.localizedTitle;
  final priceString = product.localizedPrice;

  // It is possible to have more than one introductory offer (e.g. on Android)
  final introductoryOffer = product.subscriptionDetails?.introductoryOffer.first;
  
  if (introductoryOffer != null) {
    final introPrice = introductoryOffer.price.localizedString;
    final introPeriod = introductoryOffer.localizedSubscriptionPeriod;
    final introNumberOfPeriods = introductoryOffer.localizedNumberOfPeriods;
  }

  // Promo Offer
  final promotionalOfferEligibility = product.subscriptionDetails?.promotionalOfferEligibility ?? false;
  final promotionalOffer = product.subscriptionDetails?.promotionalOffer;
        
  if (promotionalOfferEligibility && promotionalOffer != null) {
    final promoPrice = promotionalOffer.price.localizedString;
    final promoPeriod = promotionalOffer.localizedSubscriptionPeriod;
    final promoNumberOfPeriods = promotionalOffer.localizedNumberOfPeriods;
  }
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}