At Qonversion, reliability has always been our priority. We have multiple protection mechanisms that allow us to avoid any downtimes and provide a reliable in-app subscription management service SLA. These mechanisms can be categorized into three levels:

• Internal infrastructure reliability
• External backend-replacement service
• SDK-level protection

Aegis

We have an independent service called Aegis, based on Cloudflare infrastructure, that can replace our API if our internal infrastructure fails. Aegis responds just like our main API. We prepare necessary caches in Cloudflare’s storage from our database while it's operational. During an outage, incoming traffic is redirected to a Cloudflare Worker that handles requests using cached data. It also queues incoming requests to resend to the API once it's back online to update our database. This is all based on Cloudflare's infrastructure, which guarantees 100% SLA. Read more here.

Fallback files

The Fallback Files feature in Qonversion ensures data reliability and continuity by maintaining backup files directly within the SDK for critical functionalities like purchases, remote configs, and offerings. In the event of a network provider error or system failure, these files allow the SDK to preserve essential operations, ensuring that purchases in stores can still be completed successfully. This feature is crucial for maintaining high availability and a seamless user experience, even under adverse conditions.

How to Set Up Fallback Files

Download Fallback File

To set up Fallback Files, navigate to either the Entitlements or Remote Configs section in your Qonversion dashboard and click the Fallbacks button to download the file. The configuration content is the same in both sections.

🚧

Do not change the name of the file you downloaded from the Qonversion dashboard.

iOS

Place the fallback file into the project directory, and Qonversion will automatically detect and utilize it.

Android

Place the fallback file in the main/assets directory and Qonversion will automatically detect and utilize it.

If you prefer to store resources in the res/raw directory, you can certainly keep the fallback file there. However, in this scenario, you’ll need to explicitly inform the Qonversion SDK about the fallback file’s location.

Use the following code to set a fallback file:

val config = QonversionConfig.Builder(this, "your_project_key",QLaunchMode.SubscriptionManagement)
  .setFallbackFileIdentifier(R.raw.qonversion_android_fallbacks)
  .build()

final QonversionConfig qonversionConfig = new QonversionConfig.Builder(this,"your_project_key",QLaunchMode.SubscriptionManagement)
	.setFallbackFileIdentifier(R.raw.qonversion_android_fallbacks)
  .build();

React Native / Cordova / Flutter

Place the fallback file in the project directory for both iOS and Android platforms, and Qonversion will handle the rest by automatically fetching and using it. For Android use main/assets directory.

Unity

Place both qonversion_ios_fallbacks.json and qonversion_android_fallbacks.json files into the Assets/StreamingAssets directory. This ensures the fallback files are included in both iOS and Android platform projects during the export process. Qonversion will then automatically retrieve and utilize these files.

How to test?

Call the following function to ensure the fallback file is placed into the correct directory and can be successfully fetched and mapped by Qonversion SDK.

Use this function only during development, and make sure to remove it before the final release. Using it in production will not harm the product, but it is unnecessary code.

let isFallbackFileAccessible = Qonversion.shared.isFallbackFileAccessible()

BOOL isFallbackFileAccessible = [[Qonversion sharedInstance] isFallbackFileAccessible];

val isFallbackFileAccessible = Qonversion.shared.isFallbackFileAccessible()

Boolean isFallbackFileAccessible = Qonversion.getSharedInstance().isFallbackFileAccessible();

const isFallbackFileAccessible = Qonversion.getSharedInstance().isFallbackFileAccessible();

bool isFallbackFileAccessible = Qonversion.getSharedInstance().isFallbackFileAccessible;

const isFallbackFileAccessible = Qonversion.getSharedInstance().isFallbackFileAccessible();

bool isFallbackFileAccessible = Qonversion.GetSharedInstance().IsFallbackFileAccessible();