Statsig
Integrate in-app subscription events from RevenueCat with Statsig
The Statsig integration is available to all users signed up after September '23, the legacy Grow and Pro plans, and Enterprise plans. If you're on a legacy Free or Starter plan and want to access this integration, migrate to our new pricing via your billing settings.
Statsig can be a helpful integration for optimizing purchases and revenue, and understanding which features are causing product metrics to move. RevenueCat can automatically send billing, subscription, and revenue metrics to your Statsig project.
With our Statsig integration, you can:
- Compute how every new product improvement impacts your business metrics
- Simplify setting up Feature Gates and be able to automatically A/B test new features
- Run multiple independent experiments in parallel
With accurate and up-to-date subscription data in Statsig, you'll be set to turbocharge your product analytics ⚡️
Integration at a Glance
| Includes Revenue | Supports Negative Revenue | Sends Sandbox Events | Includes Subscriber Attributes | Sends Transfer Events | Optional Event Types |
|---|---|---|---|---|---|
| ✅ | ✅ | Toggle on in Settings | ✅ | ✅ | ❌ |
Events
The Statsig integration tracks the following events:
| Event Type | Default Event Name | Description | App Store | Play Store | Amazon | Stripe | Promo |
|---|---|---|---|---|---|---|---|
| Initial Purchase | rc_initial_purchase_event | A new subscription has been purchased. | ✅ | ✅ | ✅ | ✅ | ❌ |
| Renewal | rc_renewal_event | An existing subscription has been renewed or a lapsed user has resubscribed. | ✅ | ✅ | ✅ | ✅ | ❌ |
| Cancellation | rc_cancellation_event | A subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details. | ✅ | ✅ | ✅ | ✅ | ✅ |
| Uncancellation | rc_uncancellation_event | A non-expired cancelled subscription has been re-enabled. | ✅ | ✅ | ✅ | ❌ | ❌ |
| Non Subscription Purchase | rc_non_subscription_purchase_event | A customer has made a purchase that will not auto-renew. | ✅ | ✅ | ✅ | ✅ | ✅ |
| Subscription Paused | rc_subscription_paused_event | A subscription has been paused. | ❌ | ✅ | ❌ | ❌ | ❌ |
| Expiration | rc_expiration_event | A subscription has expired and access should be removed. If you have Platform Server Notifications configured, this event will occur as soon as we are notified (within seconds to minutes) of the expiration. If you do not have notifications configured, delays may be approximately 1 hour. | ✅ | ✅ | ✅ | ✅ | ✅ |
| Billing Issue | rc_billing_issue_event | There has been a problem trying to charge the subscriber. This does not mean the subscription has expired. Can be safely ignored if listening to CANCELLATION event + cancel_reason=BILLING_ERROR. | ✅ | ✅ | ✅ | ✅ | ❌ |
0. Matching RevenueCat Users with Statsig Users
In order to associate RevenueCat data with Statsig feature gate and/or experiment, the RevenueCat app user ID must match the Statsig User ID. You can read more about Statsig user IDs in their documentation here. You can set up a custom app user ID in RevenueCat by following the instructions in our Identifying Users documentation.
1. Enable RevenueCat integration with Statsig
On the Statsig Integration page enable the RevenueCat integration.
Enable RevenueCat in Statsig integration page
2. Send RevenueCat events into Statsig
After you enabled the RevenueCat integration in Statsig's dashboard, you can "turn on" the integration from the RevenueCat dashboard.
- Navigate to your project in the RevenueCat dashboard and find the Integrations card in the left menu. Select + New
- Choose Statsig from the Integrations menu.
- Add your 'statsig-server-secret'
Remember to select Add Integration
Statsig configuration page
3. Testing the Statsig integration
Ingesting sandbox events into Statsig can be enabled in the RevenueCat configuration in the Statsig Integration page.
Include Sandbox Events in Statsig integration page
Make a sandbox purchase with a new user
Simulate a new user installing your app, and go through your app flow to complete a sandbox purchase.
Check that the Statsig event delivered successfully
While still on the Customer View, select test purchase event in the Customer History page and make sure that the Statsig integration event exists and was delivered successfully.
Check Statsig dashboard for the delivered event
Navigate to your Statsig app > Metrics. You will see events RevenueCat has dispatched to Statsig under 'Log Stream'.
Sample Events
Below are sample JSONs that are delivered to Statsig for each event type.
{
"event": {
"event_timestamp_ms": 1637029477784,
"product_id": "1_month",
"period_type": "NORMAL",
"purchased_at_ms": 1637029467526,
"expiration_at_ms": 1639628655405,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "GPA.1234-5678-9012-34567",
"original_transaction_id": "GPA.1234-5678-9012-34567",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"currency": "USD",
"price": 14.99,
"price_in_purchased_currency": 14.99,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1637029304629
}
},
"store": "PLAY_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_initial_purchase_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1637000963815,
"product_id": "1_month",
"period_type": "NORMAL",
"purchased_at_ms": 1637029695000,
"expiration_at_ms": 1639621695000,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"currency": "USD",
"is_trial_conversion": false,
"price": 14.99,
"price_in_purchased_currency": 14.99,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1599867695969
}
},
"store": "APP_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_renewal_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1636393200702,
"product_id": "1_month_trial",
"period_type": "NORMAL",
"purchased_at_ms": 1636392545000,
"expiration_at_ms": 1636392845000,
"environment": "SANDBOX",
"entitlement_ids": [
"pro"
],
"presented_offering_id": "default",
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"cancel_reason": "UNSUBSCRIBE",
"currency": "USD",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {},
"store": "APP_STORE",
"takehome_percentage": 0.7,
"offer_code": null,
"type": "rc_cancellation_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1640819176602,
"product_id": "annual",
"period_type": "NORMAL",
"purchased_at_ms": 1609879926614,
"expiration_at_ms": 1641415926614,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "GPA.1234-5678-9012-34567..0",
"original_transaction_id": "GPA.1234-5678-9012-34567",
"is_family_share": false,
"country_code": "CA",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"currency": "CAD",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1621722480238
}
},
"store": "PLAY_STORE",
"takehome_percentage": 0.7,
"offer_code": null,
"type": "rc_uncancellation_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1637190959056,
"product_id": "lifetime",
"period_type": "PROMOTIONAL",
"purchased_at_ms": 1637190959012,
"expiration_at_ms": null,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": null,
"country_code": "EG",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"currency": "USD",
"price": 0,
"price_in_purchased_currency": 0,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1637170450860
}
},
"store": "PROMOTIONAL",
"takehome_percentage": 1.0,
"offer_code": null,
"type": "rc_non_subscription_purchase_event",
"id": "12345678-1234-1234-1234-123456789012",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1653428219007,
"product_id": "1_month_trial",
"period_type": "NORMAL",
"purchased_at_ms": 1653055384116,
"expiration_at_ms": 1655740984116,
"environment": "PRODUCTION",
"entitlement_ids": [
"Premium"
],
"presented_offering_id": "default",
"transaction_id": "GPA.1234-5678-9012-34567",
"original_transaction_id": "GPA.1234-5678-9012-34567",
"is_family_share": false,
"country_code": "NL",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"auto_resume_at_ms": 1663682584116,
"currency": "EUR",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {
"$ip": {
"value": "123.45.67.89",
"updated_at_ms": 1647518583621
},
"$gpsAdId": {
"value": "12345678-9012-3456-7890-123456789012",
"updated_at_ms": 1647518583621
},
"$fbAnonId": {
"value": "1234567890-1234-5678-9012-345678901234",
"updated_at_ms": 1647518583693
},
"$androidId": {
"value": "1234567890123456",
"updated_at_ms": 1647518583621
}
},
"store": "PLAY_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_subscription_paused_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1637084145365,
"product_id": "1_month",
"period_type": "NORMAL",
"purchased_at_ms": 1634398134000,
"expiration_at_ms": 1637080134000,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"expiration_reason": "UNSUBSCRIBE",
"currency": "USD",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1612318142089
}
},
"store": "APP_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_expiration_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1637032896187,
"product_id": "1_month",
"period_type": "NORMAL",
"purchased_at_ms": 1634350887000,
"expiration_at_ms": 1638415287000,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"grace_period_expiration_at_ms": 1638415287000,
"currency": "USD",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1631065160180
}
},
"store": "APP_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_billing_issue_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
{
"event": {
"event_timestamp_ms": 1638167985431,
"product_id": "1_month",
"period_type": "NORMAL",
"purchased_at_ms": 1635176519000,
"expiration_at_ms": 1637858519000,
"environment": "PRODUCTION",
"entitlement_ids": [
"pro"
],
"presented_offering_id": null,
"transaction_id": "123456789012345",
"original_transaction_id": "123456789012345",
"is_family_share": false,
"country_code": "US",
"app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"aliases": [
"12abc345d67e890fgh12j3lm456n7890"
],
"original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"new_product_id": "6_month",
"currency": "USD",
"price": 0.0,
"price_in_purchased_currency": 0.0,
"subscriber_attributes": {
"$email": {
"value": "[email protected]",
"updated_at_ms": 1634299061231
}
},
"store": "APP_STORE",
"takehome_percentage": 0.85,
"offer_code": null,
"type": "rc_product_change_event",
"id": "12345678-1234-1234-1234-123456789012",
"app_id": "1234567890",
},
"api_version": "1.0"
}
You've done it!
You should start seeing subscription data from RevenueCat appear in Statsig.
Updated 7 days ago