Qonversion

The Qonversion Inc. Developer Hub

Welcome to the Qonversion Inc. developer hub. You'll find comprehensive guides and documentation to help you start working with Qonversion Inc. as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Integrations Overview

Send your in-app subscription data to destinations like AppsFlyer, Amplitude, and other major mobile platforms.

Qonversion sends subscription events, including purchases, subscriptions after free trials, renewals, refunds, and others to the integrated partners. This allows you to power your marketing and attribution platforms, as well as product analytics and retention tools, with accurate in-app subscription data.

Qonversion validates user receipts directly with app stores and tracks in-app revenue even if a user doesn't open your app. This allows you to have accurate subscription data of each subscription plan with 100% accuracy.

See the list of the events Qonversion tracks and sends to the integrated partners below.

Tracked Events

The following section describes each event type Qonversion tracks and sends to third-party services.

Event nameDescriptionHas Value
Trial StartedA user starts a trial.
Trial ConvertedA trial converts to a regular auto-renewable subscription.Yes
Trial CanceledA trial is canceled. Cancellation can occur when a subscriber turns off auto-renew.
Trial Billing RetryA trial went to a billing retry state. It happens if the App Store was not able to charge a user for any reason.
Trial is active two days after startedA user did not cancel the trial two days after the trial started. This event could be useful for marketing optimization.
Subscription StartedA user started a subscription (only for subscriptions without a trial).Yes
Subscription RenewedA subscription was renewed.Yes
Subscription UpgradedA user purchases a subscription that offers a higher level of service than their current subscription.Yes
Refunded value, if the store processes the upgrade via refund and charge again.
Subscription RefundedA user receives a refund for his previously made purchase.Yes
Subscription CanceledA user turns off auto-renew, or when the App Store can not charge a customer in a billing retry state.
Subscription Billing RetryA Subscription went to a billing retry state.
In-App PurchaseAn in-app purchase occurred.Yes
Trial ExpiredA trial period ended and a trial lapsed (auto-renew was previously disabled by a user).
Subscription ExpiredA subscription period ended and a subscription lapsed (auto-renew was previously disabled by a user).
Subscription Product ChangedActive subscription product has changed due to upgrade, downgrade or crossgrade.

📘

Qonversion sends revenue value for some events. Please see the value column. Refund values are negative.

Switching between subscriptions

Qonversion sends a 'Subscription Renewed' event in case of an upgrade, downgrade, or cross-grade of a subscription when a subscriber switches from his other subscription. Qonversion sends a 'Trial Converted' event if a user switches subscription and enters paid period at the same time.

Qonversion does not send downgrade event to integrations to avoid any possible data discrepancies. Both upgrade and downgrade events are shown in Qonversion in user's timeline available from the Customers dashboard.

You can check our detailed article on subscription service level and groups here.

Configure Integrations

Configure Integrations

Each integration has the following settings, that affect all events sent in this integration:

  • Send revenue properties
    By default, it should be turned on. If you turn this toggle off, you will not receive revenue values for this integration. We recommend to send values, so do not turn it off unless you don't need Qonversion to send revenue values.

  • Send sales as proceed
    Choose if you want to send revenue values net of App Stores commission (default) or gross (before deducting App Stores commission) by switching the "Send sales as proceed" toggle.

  • Send sandbox events
    Turn on the "Send sandbox events" toggle if you want to receive sandbox events from Qonversion to this integration while testing it.

Event time

Qonversion can set the exact time when an event occurs for most of the events. For example, when the App Store or Google play received the payment from a user.
But some events do not have the exact time. The event time for such events is set equal to the time when Qonversion detected the event while checking a user receipt. Here is the list of such events:

  • Trial Canceled
  • Trial Billing Retry
  • Subscription Canceled
  • Subscription Billing Retry
  • Trial Still Active

Updated 22 days ago


Integrations Overview


Send your in-app subscription data to destinations like AppsFlyer, Amplitude, and other major mobile platforms.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.