Set Up Integration
Send RevenueCat subscription events to Airbridge by setting up integration.Prerequisites
Set up your RevenueCat SDK first.AttentionReview the following before you begin. For details, see this section.
- Device IDs must be sent to RevenueCat
- User IDs must match between Airbridge and RevenueCat
- Event double counting must be prevented
Get credentials from Airbridge
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.
Provide credentials to RevenueCat
- 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.
View RevenueCat Data in Airbridge
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.Event mapping between RevenueCat and Airbridge
Event mapping between RevenueCat and Airbridge
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.
Standard events
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.
Custom events
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.
Attention
Send device IDs to RevenueCat
Send device IDs to RevenueCat
Device IDs collected by Airbridge must be sent to RevenueCat. Configure your RevenueCat SDK to send them. Refer to the RevenueCat Documentation for details.
User ID matching
User ID matching
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.
Event double counting
Event double counting
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 double counting.
Use S2S events for SKAN conversion values
Use S2S events for SKAN conversion values
To reflect events collected via server-to-server (S2S) in SKAN conversion values, make sure all of the following are met:
- Your Airbridge iOS SDK is version 4.8.0 or higher. We recommend version 4.8.1 or higher.
- The
calculateSKAdNetworkByServerEnabledoption is set totruein the Airbridge SDK. For details, see the iOS SDK documentation.