iOS SDK for cross-platform in-app purchase and subscription infrastructure, revenue analytics, engagement automation, and integrations

Qonversion

Last update: Dec 18, 2022

Overview

Qonversion is the data platform to power in-app subscription revenue growth.

fast in-app subscriptions implementation
back-end infrastructure to validate user receipts
manage cross-platform user access to paid content on your app
comprehensive subscription analytics
out-of-the-box integrations with the leading marketing, attribution, and product analytics platforms
push notifications and in-app messaging to win back lapsed subscribers
A/B Testing for in-app purchases

How It Works: Product Center

Application calls the purchase method of Qonversion SDK.
Qonversion SDK communicates with StoreKit or Google Billing Client to make a purchase.
If a purchase is successful, the SDK sends a request to Qonversion API for server-to-server purchase validation. Qonversion server receives accurate information on the in-app purchase status and user entitlements.
SDK returns control to the application with a processing state.

Analytics

Monitor your in-app revenue metrics. Understand your customers and make better decisions with precise subscription revenue data.

Integrations

Send subscription data to your favorite platforms Share your mobile and web subscription data using our powerful integrations.

Personalized push notifications & in-app messaging

Qonversion allows sending automated, personalized push notifications and in-app messages initiated by in-app purchase events. This feature is designed to increase your app's revenue and retention, provide cancellation insights, reduce subscriber churn, and improve your subscribers' user experience.

See more in the documentation

A/B Testing for in-app purchases

Boost conversion rates with paywalls and in-app purchases A/B testing. Find the best pricing and paywall variations. Be flexible to prove hypotheses without app releases.

Why Qonversion?

No headaches with Apple's StoreKit & Google Billing. Qonversion provides simple methods to handle Apple StoreKit & Google Billing purchase flow.
Receipt validation. Qonversion validates user receipts with Apple and Google to provide 100% accurate purchase information and subscription statuses. It also prevents unauthorized access to the premium features of your app.
Track and increase your revenue. Qonversion provides detailed real-time revenue analytics including cohort analysis, trial conversion rates, country segmentation, and much more.
Integrations with the leading mobile platforms. Qonversion allows sending data to platforms like AppsFlyer, Adjust, Branch, Tenjin, Facebook Ads, Amplitude, Mixpanel, and many others.
Change promoted in-app products. Change promoted in-app products anytime without app releases.
Win back lapsed subscribers. Qonversion allows sending highly targeted push notifications triggered by server-side subscription events. You can send special offers to users who just canceled a free trial or a subscription. Plus you can deliver in-app messages with a beautiful native design that you create in Qonversion.
A/B test and identify winning in-app purchases, subscriptions or paywals.
Cross-device and cross-platform access management. If you provide user authorization in your app, you can easily set Qonversion to provide premium access to authorized users across devices and operating systems.
SDK caches the data. Qonversion SDK caches purchase data including in-app products and permissions, so the user experience is not affected even with the slow or interrupting network connection.
Webhooks. You can easily send all of the data to your server with Qonversion webhooks.
Customer support. You can always reach out to our customer support and get the help required.

Convinced? Let's go!

Getting Started

Documentation

Check the documentation to learn details on implementing and using Qonversion SDKs.

Help us improve the documentation

Whether you’re a core user or trying it out for the first time, you can make a valuable contribution to Qonversion by improving the documentation. Help us by:

sending us feedback about something you thought was confusing or simply missing
sending us a pull request via GitHub
suggesting better wording or ways of explaining certain topics in the Qonversion documentation. Use SUGGEST EDITS button in the top right corner.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/SuperFeature)
Commit your Changes. Use small commits with separate logic. (git commit -m 'Add some super feature')
Push to the Branch (git push origin feature/SuperFeature)
Open a Pull Request

Have a question?

License

Qonversion SDK is available under the MIT license.

Comments

Subscription status for different sandbox account on same device

I created two different sandbox accounts. [email protected] and [email protected]. I purchased annual subscription using [email protected], logged out from sandbox account and logged in with [email protected]. When I checked permissions using Qonversion.checkPermissions it shows me permission as active even though I have not purchased any subscription using [email protected].
enhancement fixed

opened by saqibomer 14

SKProduct always null

I fetched list of products and noticed that SKProduct inside QNProduct always null. I try to make purchase and get error - Error Domain=com.qonversion.io Code=2 "(null)".

 po self.products
▿ 1 element
  ▿ 0 : 2 elements
    - key : "sounds_monthly_7days_trial"
    - value : <QNProduct: id=sounds_monthly_7days_trial,
storeID=TygerSoundsMonthly,
type=0,
duration=1,
skProduct=(null),
>

Qonversion.purchase(product.qonversionID) { [weak self] (result, error, flag) in
            guard let self = self else { return }            
            if let error = error {
                completion(error)
                print(error.localizedDescription)
  }

help wanted question

opened by xhardcorex 10

iOS 15 SDK support

Can't build for iOS 15 got error 'sharedApplication' is unavailable: not available on iOS (App Extension) - Use view controller based solutions where appropriate instead.

opened by andrey-krukovskiy 7
Same Permissions for different Login User ID's

Use case: I logged with UserA & I purchased subscription(3 months) using UserA. After that I logged out and logged in with UserB. When I called Qonversion.checkPermissions it shows same permissions for UserA as well as UserB.

I need to link my app's user id with Apple ID, how can I link that? I tried to set below Qonversion.setProperty(.userID, value: user.uid) Qonversion.identify(user.uid) but permissions are same for different UserID's.
awaiting answers

opened by atrsarankumar 5
Disable automatic finishing of transactions

Hello! In our application, we use our own server for receipt validation and the Qonversion library for analytics. In the event that the consumable purchase was successful, we send a receipt to our server. We would like to finish a transaction only if the server has successfully processed the purchase and rewarded the user. However, the handlePurchasedTransaction method of the QNProductCenterManager class automatically finishes the transaction, and therefore, even if the check was not successfully sent to our server, the transaction is finished, that is, it is deleted from the PaymentQueue and from the receipt, that is, we lose the purchase and cannot try to process it again, for example, the next time the application is restarted, when the paymentQueue(_:updatedTransactions:) method is called. Please tell me if there is any way to bypass this behavior.

opened by denis15yo 4
App freezes in iOS 15 on storefront call
From your code:

if (@available(iOS 13.0, macos 10.15, tvOS 13.0, *)) { NSString *countryCode = SKPaymentQueue.defaultQueue.storefront.countryCode ?: @""; purchaseDict[@"country"] = countryCode; }

Calling storefront on iOS freezes the app. It seems it is inner iOS bug but what about to add a possibility to disable countryCode to avoid such situations?
opened by gerchicov-bp 4
Force update user properties

In documentation it says

How It Works

Qonversion SDK gets user properties and sends data every 15 seconds, as well as when closing the app.

How can I force update user properties without waiting for 15 seconds or closing the app?
duplicate

opened by saqibomer 4
Offerings with SPM

I have Qonversion installed with SPM. On version 2.9.0 atm.

When trying to use the offerings call. I get Type 'Qonversion' has no member 'offerings', but all my other calls seem to work fine. I've tried cleaning, clearing derived data, and even removing and re-adding the library.

Any help with this would be appreciated.

opened by drewg233 3
InApp purchase via Qonversion in TestFlight doesn't work

We are testing our App in TestFlight and we found an issue. I paid one of the subscription plan in the App but I still cannot have premium service, in other words, Qonversion don't return any active status for me. I tested with our real apple Ids and also with Sandbox apple ids. None of them works in TestFlight.

This scenario works in the Non-TestFlight build or the debug build I deployed from Xcode.
solution found

opened by DreamSkyMXDan 3

Invalid duration of products - iOS SDK

Product list shows invalid duration. I have an annual and quarterly product defined in product centre. Response shows duration as 2 and 4.

Qonversion.products { productsList, error in
     print(productsList)
}

And here is response

key: "premium_plan_quarterly", value: <QNProduct: id=premium_plan_quarterly,
storeID=premium_plan_quarterly,
type=1,
duration=2,
skProduct=<SKProduct: 0x28075ccf0>,
>

help wanted

opened by saqibomer 3

Not able to compile 3.0.0

Currently can not compile the latest version. Getting error Could not find QONNotificationsService.h Please review my PR here: https://github.com/qonversion/qonversion-ios-sdk/pull/310

opened by drewg233 2
It is not possible to pass the quantity of the product in the purchase method

I'm using SwiftyStoreKit and I can't replace it with qonversion because it's not possible to send the amount when buying the product.

Today I have a tip product in the Apple Store, and I use this product over and over again to make the value more flexible by using multiple amounts to be able to buy several of the same product. SwiftyStoreKit and StoreKit support this.

It would be great if it was possible to send the quantity of the product that my users will buy.
enhancement

opened by pgneri 2

Releases(3.0.2)

3.0.2(Dec 19, 2022)
What's new

Fixed SPM issue

Thanks, @drewg233, for the contribution!
Source code(tar.gz)
Source code(zip)
3.0.1(Dec 14, 2022)
What's new

Swift naming for Configuration class

Source code(tar.gz)
Source code(zip)
3.0.0(Dec 13, 2022)

New major release of Qonversion iOS SDK

For the list of changes and migration guide, please, visit the documentation.
Source code(tar.gz)
Source code(zip)
3.0.0-RC3(Dec 1, 2022)
What's new

addAttributionData method is shortened to attribution,

AdjustUserId user property is renamed to the more consistent AdjustAdId,

userInfo method extended to return identity id. Also, User.identifier was renamed to User.qonversionId.

Source code(tar.gz)
Source code(zip)
3.0.0-RC2(Nov 24, 2022)
What's new

Added option to set App Store promo purchases delegate via config object

Source code(tar.gz)
Source code(zip)
3.0.0-RC1(Nov 23, 2022)

First candidate for the new major SDK release

It contains a lot of changes, which will be described in our migration guide soon.

Please, note that future releases may be backward incompatible with release candidates.

These release notes will be updated.
Source code(tar.gz)
Source code(zip)
2.21.1(Nov 7, 2022)
What's new

Fixed bug when product's trial duration property returns as Other instead of Week and TwoWeeks values.

Source code(tar.gz)
Source code(zip)
2.21.0(Sep 21, 2022)
What's new

Added a source property to the Permission object - use it to know where this permission is originally from - App Store, Play Store, Stripe, etc.

Added a method getNotificationCustomPayload to get the extra data you've added to automation notifications.

Purchase tracking error handling improved to guarantee delivery.

Source code(tar.gz)
Source code(zip)
2.20.1(Aug 31, 2022)
What's new

Updated restore logic to prevent high memory usage for the massive StoreKit receipts.

Source code(tar.gz)
Source code(zip)
2.20.0(Aug 24, 2022)
What's new

Added support of network connection lack or unexpected backend errors. Now Qonversion SDK will handle user permissions correctly even if it can't reach out to the API and will actualize them with the next successful request. Also, products and offerings become permanently available after the first successful launch - nothing will interfere user from the purchase.

Added method setPermissionsCacheLifetime to configure the lifetime of permissions cache. It is used if we faced any error trying to get permissions from our API. Defaults to one month.

Added a new defined property FirebaseAppInstanceId for Firebase integration.

Source code(tar.gz)
Source code(zip)
2.19.1(Jul 25, 2022)
What's new

Updated request retry logic for cases of poor connection at the App launch.

Source code(tar.gz)
Source code(zip)
2.19.0(Jun 29, 2022)

What's new

Observer mode update

New function to disable transactions finishing for observer mode. You can call this function if you want to finish StroreKit transactions by yourself, after handling the purchase on your own backend, for example. Qonversion.disableFinishTransactions()
Source code(tar.gz)
Source code(zip)
2.19.0-storekit2-beta(Jun 19, 2022)

What's new

Support StoreKit 2 in the Observer mode

From now, you can use our SDK in the Observer mode if your own implementation of the purchase logic is based on StoreKit 2. Use QonversionPurchasesHandler.handle(transaction) to track a transaction that appears as a result of StoreKit 2 Product.purchase() function. The following transactions will be handled automatically.
Source code(tar.gz)
Source code(zip)
2.18.4(Apr 13, 2022)
What's new

Updated logic to handle push notifications token

DEBUG preprocessor macros check was removed

Source code(tar.gz)
Source code(zip)
2.18.3(Feb 17, 2022)
What's new

Minor logic improvements

AdServices logic update

Source code(tar.gz)
Source code(zip)
2.18.2(Dec 22, 2021)
What's new

Apple Ad Services support

Source code(tar.gz)
Source code(zip)
2.18.1(Dec 3, 2021)
What's new

Method setUserId marked as deprecated and will be removed in a future major release

Minor code improvements

Source code(tar.gz)
Source code(zip)
2.18.0(Aug 31, 2021)

What's new

Qonversion Strict Mode SDK without IDFA collection

Qonversion Strict Mode iOS SDK does not collect IDFA. Developers can choose this SDK, for example, in the case of kids apps. Following Apple's policy, apps in the kids category must not collect IDFA. You can install the Strict Mode SDK with CocoaPods: pod 'Qonversion/NoIdfa'
Source code(tar.gz)
Source code(zip)
2.17.2(Aug 16, 2021)
What's new

Minor improvements

Xcode 13 support

Source code(tar.gz)
Source code(zip)
2.17.1(Aug 11, 2021)
What's new

Minor logic improvements

Fixed SPM warnings & errors

Source code(tar.gz)
Source code(zip)
2.17.0(Aug 10, 2021)
What’s new

Automations

New AutomationsDelegate method shouldHandleEvent. The method allows getting the event that triggers the Automation. Override the function and return false if you want to handle the event by yourself (for example, show your custom screen). Otherwise, Qonversion will handle this event and show the Automation screen (if it’s configured).

extension YourCustomClass: Qonversion.AutomationsDelegate { func shouldHandle(_ event: QONAutomationsEvent, payload: [String : Any]) -> Bool { // check event.type here // return false if you want to handle event yourself } }

Updated push notifications token store logic

Source code(tar.gz)
Source code(zip)
2.16.2(Jul 29, 2021)
What's new

QNAPIError contains debugDescription field with additional info about the error reason.

Source code(tar.gz)
Source code(zip)
2.16.1(Jul 28, 2021)

What's new

Errors details

From now Qonversion SDK returns more details about the error received. Check the details in QNAPIError enum and in the documentation Error details contain information on receipt validation error, project configuration issues, invalid or fraud purchases, wrong credentials, etc.
Source code(tar.gz)
Source code(zip)
2.16.0(Jul 5, 2021)
What's new

Automation

Automation update. Use showScreen() method that allows you to show the screen whenever you need it.

Qonversion.Automations.showScreen(withID: "screen_id") { success, error in // handle result here }
Source code(tar.gz)
Source code(zip)
2.15.0(Jun 17, 2021)

What's new

A/B Testing

A/B testing makes it easy to run and analyze in-app subscription experiments to quickly find the best subscription price, duration, and other parameters that maximize your app's revenue in the long run. It is an out-of-the-box solution that does not require any third-party service. You can roll out the winning version of the experiment to all users instantly without releasing a new app version.

See the details in our documentation to set up your first subscription pricing A/B experiment
Source code(tar.gz)
Source code(zip)
2.14.1(Jun 8, 2021)
What's new

Deprecations

Qonversion.resetUser() deprecated. You can reinstall the app if you need to reset the user ID.

Minor improvements

Improved request and retries logic for user identity functionality

Source code(tar.gz)
Source code(zip)
2.14.0(Jun 4, 2021)
What's new

User info

Now you can get the user info by calling Qonversion.userInfo()

Qonversion.userInfo { userInfo, error in // handle user info here }

Minor improvements

Updated requests and retries logic
Source code(tar.gz)
Source code(zip)
2.13.4(May 3, 2021)
What's new

Swift package manager issue fix

Source code(tar.gz)
Source code(zip)
2.13.3(Apr 22, 2021)
What's new

SKProduct issue fix

Unfinished transactions fix

Minor improvements

Source code(tar.gz)
Source code(zip)
2.13.2(Apr 9, 2021)
What's new

IDFA On iOS 14.5+, after requesting the app tracking permission using ATT, you need to notify Qonversion if tracking is allowed and IDFA is available. Just call Qonversion.setAdvertisingID()

Source code(tar.gz)
Source code(zip)