Skip to main content

Superwall

👍Pro Integration

The Superwall 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.

Superwall can be a helpful integration for optimizing pricing and understanding which paywalls are producing customers with the highest LTV. RevenueCat can automatically send billing, subscription, and revenue metrics to Superwall, a paywall SDK that lets you remotely update every aspect of your paywall.

With our Superwall integration, you can:

  • Create paywalls on-the-fly without shipping app updates
  • Determine which paywalls have high trial conversion rates
  • Find which product & paywall combinations have the highest LTVs
  • Offer discounts to users who churn

Integration at a Glance​

Includes RevenueSupports Negative RevenueSends Sandbox EventsIncludes Customer AttributesSends Transfer EventsOptional Event Types
✅✅✅✅✅❌

Events​

The Superwall integration tracks the following events:

Event TypeDefault Event NameDescriptionApp StorePlay StoreAmazonStripePromo
Initial PurchaseINITIAL_PURCHASEA new subscription has been purchased.✅✅✅✅❌
RenewalRENEWALAn existing subscription has been renewed or a lapsed user has resubscribed.✅✅✅✅❌
CancellationCANCELLATIONA subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details.✅✅✅✅✅
UncancellationUNCANCELLATIONA non-expired cancelled subscription has been re-enabled.✅✅✅❌❌
Non Subscription PurchaseNON_RENEWING_PURCHASEA customer has made a purchase that will not auto-renew.✅✅✅✅✅
Subscription PausedSUBSCRIPTION_PAUSEDA subscription has been paused.❌✅❌❌❌
ExpirationEXPIRATIONA 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 IssueBILLING_ISSUEThere 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.✅✅✅✅❌
Product ChangePRODUCT_CHANGEA subscriber has changed the product of their subscription. This does not mean the new subscription is in effect immediately. See Managing Subscriptions for more details on updates, downgrades, and crossgrades.✅✅❌✅❌
TransferTRANSFERA transfer of transactions and entitlements was initiated between one App User ID(s) to another. Please note: Two events will be sent for each transfer, one for the original user and another for the destination user.✅✅✅✅❌

Setup​

1. Set Superwall User Identity​

In order to associate RevenueCat subscription data with Superwall paywall events, the RevenueCat app user ID must match the Superwall app user ID. You can read more about how Superwall handles user ID’s in their documentation here. You can set up a custom app user ID in RevenueCat by following the instructions in our Identifying Users documentation.

2. Send RevenueCat events to Superwall​

After you've set up the Purchases SDK and Superwall SDK to have the same user identity, you can "turn on" the integration from the RevenueCat dashboard.

  1. Navigate to your project in the RevenueCat dashboard and find the Integrations card in the left menu. Select + New

  1. Choose Superwall from the Integrations menu
  2. Add your Superwall Token (Superwall settings > Integrations)

Remember to select Add Integration

Testing the Superwall integration​

Make a sandbox purchase with a new user​

Simulate a new user installing your app, and go through your app flow to complete the sandbox purchase.

Check that the Superwall event delivered successfully​

While still on the Customer View, select the purchase event in the Customer History page and make sure that the Superwall integration event exists and was delivered successfully.

Check Superwall dashboard for the delivered event​

Navigate to your Superwall dashboard > Users and search for the created app user ID. You will see events RevenueCat has dispatched to the Superwall under 'Recent Events'.

Sample Events​

Below are sample JSONs that are delivered to Superwall for each event type.

{
    "event": {
        "event_timestamp_ms": 1641980452341,
        "product_id": "annual",
        "period_type": "NORMAL",
        "purchased_at_ms": 1641980447000,
        "expiration_at_ms": 1642585247000,
        "environment": "PRODUCTION",
        "entitlement_ids": [
            "premium"
        ],
        "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",
        "price": 89.99,
        "price_in_purchased_currency": 89.99,
        "subscriber_attributes": {
            "$ip": {
                "value": "123.45.67.89",
                "updated_at_ms": 1641980373773
            },
            "$idfa": {
                "value": "00000000-0000-0000-0000-000000000000",
                "updated_at_ms": 1641980373773
            },
            "$idfv": {
                "value": "12345A6B-C789-0D1E-FG23-456H6I7J890K",
                "updated_at_ms": 1641980373773
            },
            "$appsflyerId": {
                "value": "1234567890123-1234567890123456789",
                "updated_at_ms": 1641980373775
            }
        },
        "store": "APP_STORE",
        "takehome_percentage": 0.7,
        "offer_code": null,
        "type": "INITIAL_PURCHASE",
        "id": "12345678-1234-1234-1234-123456789012",
        "app_id": "1234567890"
    },
    "api_version": "1.0"
}
{
    "event": {
        "event_timestamp_ms": 1641979680052,
        "product_id": "annual",
        "period_type": "NORMAL",
        "purchased_at_ms": 1610443458000,
        "expiration_at_ms": 1641979458000,
        "environment": "PRODUCTION",
        "entitlement_ids": [
            "premium"
        ],
        "presented_offering_id": null,
        "transaction_id": "123456789012345",
        "original_transaction_id": "123456789012345",
        "is_family_share": false,
        "country_code": "AU",
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "aliases": [
            "12abc345d67e890fgh12j3lm456n7890"
        ],
        "original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "expiration_reason": "UNSUBSCRIBE",
        "currency": "AUD",
        "price": 0.0,
        "price_in_purchased_currency": 0.0,
        "subscriber_attributes": {
            "$ip": {
                "value": "123.45.67.89",
                "updated_at_ms": 1625546407475
            },
            "$idfa": {
                "value": "00000000-0000-0000-0000-000000000000",
                "updated_at_ms": 1625546407473
            },
            "$idfv": {
                "value": "12345A6B-C789-0D1E-FG23-456H6I7J890K",
                "updated_at_ms": 1625466331505
            },
            "$email": {
                "value": "firstlast@gmail.com",
                "updated_at_ms": 1625466352128
            },
            "$appsflyerId": {
                "value": "1234567890123-1234567890123456789",
                "updated_at_ms": 1625466331510
            },
            "$displayName": {
                "value": "FirstLast",   
                "updated_at_ms": 1625466352133
            }
        },
        "store": "APP_STORE",
        "takehome_percentage": 0.85,
        "offer_code": null,
        "type": "EXPIRATION",
        "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 Superwall.