> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# RevenueCat

Integrate RevenueCat with Airbridge and analyze all your subscription metrics in one place.

## **Set Up Integration**

Send RevenueCat subscription events to Airbridge by setting up integration.

### **Prerequisites**

Set up your RevenueCat SDK first.

* [RevenueCat Guide](https://www.revenuecat.com/docs/integrations/attribution/airbridge)

<Danger>
  **Attention**

  Review the following before you begin. For details, see [this section](#attention).

  * Device IDs must be sent to RevenueCat
  * User IDs must match between Airbridge and RevenueCat
  * Event double counting must be prevented
</Danger>

### **Get credentials from Airbridge**

Get your credentials from Airbridge to provide to RevenueCat. You’ll need:

* Airbridge Subdomain
* Airbridge Token

1. In the Airbridge dashboard, go to **\[Integrations]>\[Third-party Integration]** and click **RevenueCat**.
2. Copy the **Airbridge Subdomain** and **Airbridge Token**. You’ll paste these values into the RevenueCat dashboard in the next step.

### **Provide credentials to RevenueCat**

1. In the RevenueCat dashboard, click **\[Integrations]** in the left sidebar.
2. Under **\[Attribution]**, click **Airbridge**.
3. Paste the **Airbridge Subdomain** and **Airbridge Token** you copied from the Airbridge dashboard into their corresponding fields.
4. Under **\[Event names]**, click **Use default event names** to auto-fill with the pre-mapped names. For details, refer to the [mapping table](#event-mapping-between-revenuecat-and-airbridge).
5. 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.

<Accordion title="Event mapping between RevenueCat and Airbridge">
  RevenueCat events are mapped to either Airbridge standard events or custom events.

  ###### Standard events

  The following events are mapped to [standard events](/en/guides/airbridge-event-types#standard-events) by default. They are displayed in the Airbridge dashboard using their corresponding standard event names.

  | **RevenueCat event** | **Airbridge event** |
  | - | - |
  | TRIAL\_STARTED | Start Trial |
  | INITIAL\_PURCHASE | Subscribe |
  | TRIAL\_CONVERTED | Subscribe |
  | RENEWAL | Subscribe |
  | CANCELLATION | Unsubscribe |

  ###### Custom events

  The following events are mapped to [custom events](/en/guides/airbridge-event-types#custom-events) by default. They are displayed in the Airbridge dashboard using their original RevenueCat event names. Event data is included in custom attributes.

  | **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 |
</Accordion>

## Attention

<AccordionGroup>
  <Accordion title="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](https://www.revenuecat.com/docs/integrations/attribution/airbridge#2-send-device-data-to-revenuecat) for details.
  </Accordion>

  <Accordion title="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](https://www.revenuecat.com/docs/user-ids) 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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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 `calculateSKAdNetworkByServerEnabled` option is set to `true` in the Airbridge SDK. For details, see the [iOS SDK documentation](/en/developers/ios-sdk-v4#calculating-skadnetwork-conversion-value-on-the-server).
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/revenuecat" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/revenuecat" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.