Integrate RevenueCat with Airbridge and analyze all your subscription metrics in one place.
Attention
Review the following before you begin. For more details, refer to this section.
Events received from RevenueCat cannot be measured with SKAN
Ensure user IDs match between RevenueCat and Airbridge
Prevent event duplication if you’re also using the SDK for event collection
Send RevenueCat subscription events to Airbridge by setting up integration.
Set up your RevenueCat SDK first.
Get your credentials from Airbridge to provide to RevenueCat. You’ll need:
Airbridge Subdomain
Airbridge Token
In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click RevenueCat.
Copy the Airbridge Subdomain and Airbridge Token. You’ll paste these values into the RevenueCat dashboard in the next step.
In the RevenueCat dashboard, click [Integrations] in the left sidebar.
Under [Attribution], click Airbridge.
Paste the Airbridge Subdomain and Airbridge Token you copied from the Airbridge dashboard into their corresponding fields.
Under [Event names], name each RevenueCat event as you want it to be displayed in Airbridge. RevenueCat and Airbridge have pre-mapped event names available. Click Use default event names to auto-fill with these pre-mapped names. You can edit the names after they’re auto-filled. For details, refer to the mapping table.
Click Add integration to complete integration.
Below are the events pre-mapped between RevenueCat and Airbridge. This is the same mapping that appears when you click Use default event names under [Event names] in the RevenueCat dashboard.
RevenueCat events are mapped to either Airbridge standard events or custom events. Editing an event name in the RevenueCat dashboard may alter its event type in Airbridge. Make sure to review the following before editing your event mapping.
The following events are mapped to standard events by default. They are displayed in the Airbridge dashboard using their corresponding standard event names.
To map to a different standard event, enter the event category of the standard event you want to map to.
To map to a custom event, enter a name that is not a standard event category. If you enter a standard event category, the event becomes that standard event.
RevenueCat event | Airbridge event |
|---|---|
TRIAL_STARTED | Start Trial |
INITIAL_PURCHASE | Subscribe |
TRIAL_CONVERTED | Subscribe |
RENEWAL | Subscribe |
CANCELLATION | Unsubscribe |
The following events are mapped to custom events by default. They are displayed in the Airbridge dashboard using their original RevenueCat event names. Event data is included in custom attributes.
To map to a standard event, enter the event category of the standard event you want to map to.
To map to a different custom event, enter a name that is not a standard event category. If you enter a standard event category, the event becomes that standard event.
RevenueCat event | Airbridge event |
|---|---|
TRIAL_CANCELLED | TRIAL_CANCELLED |
TRIAL | TRIAL |
UNCANCELLATION | UNCANCELLATION |
NON_RENEWING_PURCHASE | NON_RENEWING_PURCHASE |
SUBSCRIPTION_PAUSED | SUBSCRIPTION_PAUSED |
EXPIRATION | EXPIRATION |
BILLING_ISSUE | BILLING_ISSUE |
PRODUCT_CHANGE | PRODUCT_CHANGE |
TRANSFER | TRANSFER |
SUBSCRIPTION_EXTENDED | SUBSCRIPTION_EXTENDED |
TEMPORARY_ENTITLEMENT_GRANT | TEMPORARY_ENTITLEMENT_GRANT |
REFUND_REVERSED | REFUND_REVERSED |
INVOICE_ISSUANCE | INVOICE_ISSUANCE |
VIRTUAL_CURRENCY_TRANSACTION | VIRTUAL_CURRENCY_TRANSACTION |
REFUND | REFUND |
Airbridge supports only Standard Events collected through the Airbridge SDK and Custom Events collected more than once for the SKAN conversion value setup. Other events are not supported.
Therefore, subscription-related events received through the server-to-server integration from a third-party solution cannot be used for the SKAN conversion value setup. If you wish to do so, create a Custom Event equivalent to the event you want to measure through SKAN and collect it through the Airbridge SDK.
User IDs must be identically logged in both the Airbridge SDK and RevenueCat to ensure seamless data integration. To achieve this, send RevenueCat's App User ID to the Airbridge SDK when sending events like sign-up and sign-in, which usually happen before a user subscribes to a service.
If Airbridge cannot find a matching User ID in RevenueCat, it generates a random User ID. This may result in the number of users for subscription-related events displayed in Airbridge being higher than the actual figures.
If subscription-related events are being imported to Airbridge from third-party solutions, make sure the Airbridge SDK does not collect subscription-related events to avoid event duplication.
Was this helpful?