Build With RevenueCat

Build a customized mobile subscription business with RevenueCat. We do the heavy lifting of normalizing subscribers from any source and maintain a single source of truth for subscription status, so you can get back to building your app.

RevenueCat is a powerful, secure, reliable, and free to use in-app purchase server with global support. All you need to get started is an API key.

Get Started

API Reference

👍
Integrations are only available on paid plans.

RevenueCat can automatically send subscription events into Amplitude. This is useful for seeing all events and revenue that occur for your app even if it's not active for a period of time.

The Amplitude integration tracks the following events:

Event	Description
Initial Purchase	The first purchase of an auto-renewing subscription product that does not contain a free trial.
Trial Started	The start of an auto-renewing subscription product free trial.
Trial Converted	When an auto-renewing subscription product converts from a free trial to normal paid period.
Trial Cancelled	When a user turns off renewals for an auto-renewing subscription product during a free trial period.
Renewal	When an auto-renewing subscription product renews OR a user repurchases the auto-renewing subscription product after a lapse in their subscription.
Cancellation	When a user turns off renewals for an auto-renewing subscription product during the normal paid period.
Uncancellation	When a user re-enables the auto-renew status for a subscription.
Non Subscription Purchase	The purchase of any product that's not an auto-renewing subscription.

For events that have revenue, such as trial conversions and renewals, RevenueCat will automatically record this amount along with the event in Amplitude.

1. Set Amplitude user identity

If you're using the Amplitude SDK, you can set the User Id to match the RevenueCat App User Id. This way, events sent from the Amplitude SDK and events sent from RevenueCat can be synced to the same user.

Configure the Amplitude SDK with the same App User Id as RevenueCat or use the .setUserId() method on the Amplitude SDK.

// Configure Purchases SDK
Purchases.configure(withAPIKey: "public_sdk_key", appUserID: "my_app_user_id")

// Configure Amplitude SDK
Amplitude.instance()?.initializeApiKey("amplitude_api_key", userId: "my_app_user_id")

// Configure Purchases SDK
[RCPurchases configureWithAPIKey:@"public_sdk_key" appUserID:@"my_app_user_id"];

// Configure Amplitude SDK
[[Amplitude] instance] initializeApiKey:@"amplitude_api_key" userId:@"my_app_user_id"];

// Configure Purchases SDK
Purchases.configure(this, "public_sdk_key", "my_app_user_id");

// Configure Amplitude SDK
Amplitude.getInstance().initialize(this, "amplitude_api_key", "my_app_user_id");

2. Send RevenueCat events to Amplitude

After you've set up the Purchase SDK and Amplitude SDK to have the same user identity, you can "turn on" the integration and configure the event names from the RevenueCat dashboard.

Navigate to your app in the RevenueCat dashboard and choose 'Amplitude' from the integrations menu
Add your Amplitude api key
Enter the event names that RevenueCat will send or choose the default event names
Select whether you want RevenueCat to report proceeds (after app store cut) or revenue (gross sales)

Click to close... — Amplitude configuration page

Sample Event

Below is sample JSON that is delivered to Amplitude for a trial conversion event.

{
    user_id: "yourCustomUserId", 
    event_type: "Trial Conversion Event", 
    time: 1580602110000, 
    platform: "iOS", 
    revenue: 9.99, 
    productId: "your_product_id"
}