Skip to content

2.2.0

Choose a tag to compare

@smejl smejl released this 10 Feb 07:07
· 642 commits to main since this release

What's new

  • Offerings
  • Intro eligibility
  • Trial duration
  • Detailed errors and enum logs
  • Purchase processing after failed launch or store products requests
  • Bugfixes and improvements under the hood

Offerings

An offering is a group of products that you can offer to a user on a given paywall based on your business logic. For example, you can offer one set of products on a paywall immediately after onboarding and another set of products with discounts later on if a user has not converted.
Offerings allow changing the products offered remotely without releasing app updates.

try {
  final QOfferings offerings = await Qonversion.offerings();
  final QOffering discount = offerings.offeringForIdentifier("discount");
  if (discount != null) {
    // Offering is available
    // Display products
  }
} catch (e) {
  print(e);
}

We strongly recommend switching to Qonversion Offerings. This allows to:

  • Change products offered to your users without app release
  • Run A/B tests
  • Store products and experiment results in one place with aggregated data on them

Intro eligibility

You can check if a user is eligible for an introductory offer, including a free trial. On the Apple platform, users who have not previously used an introductory offer for any products in the same subscription group are eligible for an introductory offer. Use this method to determine eligibility.

You can show only a regular price for users who are not eligible for an introductory offer.

try {
  final Map<String, QEligibility> eligibility = await Qonversion.checkTrialIntroEligibility(['main', 'premium']);
  final QEligibility mainProductStatus = eligibility['main'];
  if (mainProductStatus.status == QEligibilityStatus.eligible) {
      // handle available trial
  }
} catch (e) {
  print(e);
}

Trial duration

From now you can check the product’s trial duration using QNTrialDuration Enum.
If the duration is not from enum range we will return QNTrialDurationOther then you can check trial duration directly from the product's skProduct.

try {
  final Map<String, QProduct> products = await Qonversion.products();
  final QProduct mainProduct = products['main'];
  if (mainProduct.trialDuration == QTrialDuration.twoWeeks) {
    // handle two weeks trial duration
  }
} catch (e) {
  print(e);
}