> ## 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]**, 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](#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. 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](/en/guides/airbridge-event-types#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](/en/guides/airbridge-event-types#list-of-standard-events) 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         |

  ###### 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.

  * To map to a standard event, enter the [event category](/en/guides/airbridge-event-types#list-of-standard-events) 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                         |
</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" />
