Revenue Cat

Revenue Cat is an in-app subscription platform that lets you analyze and grow your cross-platform app subscriptions.

RudderStack supports Revenue Cat as a destination to which you can seamlessly send your event data.

Find the open source transformer code for this destination in the GitHub repository.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Web, Cloud, Android, iOS , Unity, AMP , Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as REVENUE_CAT in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

Get started

Once you have confirmed that the source platform supports sending events to Revenue Cat, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Revenue Cat.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Revenue Cat as a destination, you will need to configure the following settings:

• Public API Key: Enter your Revenue Cat public API key.

For more information on getting your Revenue Cat public API key, refer to the FAQ section below.

• X-Platform: Select your app platform from the dropdown.

Identify

The identify method lets you identify a user and associate them to their actions. It also lets you record any traits about them like their name, email, etc.

RudderStack uses the identify call to create or update new subscribers in Revenue Cat. It maps userId (a required trait in every event) to Revenue Cat’s app_user_id before sending the data via the subscribers API.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4GRlm",{
    email: "alex@example.com",
    phone: "+1-202-555-0146",
})

Traits mapping

RudderStack maps the following identify traits to the corresponding Revenue Cat attributes:

The following identify traits are also mapped to the corresponding Revenue Cat attributes:

Revenue Cat cannot modify these attributes so you must send them only once.

The values for iterableCampaignId and iterableTemplateId must be valid non-negative, non-decimal integers. Otherwise, RudderStack will reject and skip these fields.

Track

The track method lets you capture user events along with the properties associated with them.

A sample track call is shown below:

rudderanalytics.track("Order Completed", {
  userId: "1hKOmRA4GRlm",
  currency: "USD",
  fetch_token: "12456",
  products: [{
      product_id: "123454387",
      name: "Game",
      price: 15.99,
      introductory_price: "24",
      is_restore: true,
      presented_offering_identifier: "123",
    }
  ],
});

Event mapping

This destination does not strictly adhere to the RudderStack Ecommerce Event Spec.

RudderStack maps the Order Completed event to Revenue Cat’s Purchase event before sending it across via the receipts API. To do so, RudderStack requires the userId (mapped to app_user_id) and fetch_token properties to be present in the event.

Property mapping

RudderStack maps the following event properties to the corresponding Revenue Cat attributes:

FAQ

Where can I find the Revenue Cat public API key?

To find the Revenue Cat public API key, follow these steps:

1. Log into your Revenue Cat dashboard.
2. From the top navigation bar, go to Projects and select your app:

3. Under Project settings, select API Keys. You will find your public API keys under Public app-specific API keys:

Questions? Contact us by email or on Slack