# RevenueCat

This manual provides detailed instructions for integrating Assetario with RevenueCat to manage subscription services. It covers all stages of setup and configuration to ensure a seamless integration process.

### **Initial Setup (one time) - 1MD in total**

1. Subscription and subscription group set up
2. Apple App Store Connect set up - Create all required subscription groups and subscriptions in Apple App Store Connect
3. RevenueCat set up
   1. Create relevant **Offerings**(same as subscription groups in Apple App Store Connect) in RevenueCat.
   2. Create relevant **Packages**(same as subscriptions in App Store Connect) connected to the **Offerings**.
   3. Connect Packages to an **Entitlement** to define the feature set available to the user after purchase.

### Subscription and Subscription Group Set-Up

Example subscription price setup:

| Subscription Type | Subscription Pro 50 | Subscription Pro 75 | Subscription Pro 100 | Subscription Pro 125 | Subscription Pro 150 | Subscription Pro 200 |
| ----------------- | ------------------- | ------------------- | -------------------- | -------------------- | -------------------- | -------------------- |
| Pro Yearly        | $29.99              | $44.99              | $59.99               | $74.99               | $89.99               | $119.99              |
| Pro Monthly       | $7.99               | $11.99              | $14.99               | $18.99               | $22.99               | $29.99               |

Example subscription groups setup:

* Subscription\_Pro\_50
* Subscription\_Pro\_75
* Subscription\_Pro\_100
* Subscription\_Pro\_125
* Subscription\_Pro\_150
* Subscription\_Pro\_200

### Apple App Store Connect Set-Up

Subscription group creation - Create subscription groups based on the provided guideline

<figure><img src="/files/isGzv6d8ggbWjRnVXEgQ" alt=""><figcaption></figcaption></figure>

Subscription group creation - In each subscription group create subscriptions based on the table specified in Subscription  and Subscription Group Set Up

<figure><img src="/files/7KpFY1u0jmy1fu5HtcbK" alt=""><figcaption></figcaption></figure>

### RevenueCat Set-Up

Creation of new **Offerings**

* For each previously created Subscription Group, create a new **Offering**, covering all agreed-upon multipliers.&#x20;
* The **Offerings** will be fetched within the SDK and used based on the returned multiplier via the Assetario SDK.

<figure><img src="/files/ZnOISJ78yrSoRnGpQMo6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wrVsg23MU2ZXoltrF1nv" alt=""><figcaption></figcaption></figure>

* Open created subscription and create **Products** based on the previously agreed-upon specifics of subscriptions within Subscription Groups.

<figure><img src="/files/xEIJHPcfHvzXoL1jwRy6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/W5nNfrhEtD1h6CWGDvw9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/3XUbErPxojAjReRlMWBgpOaWxFRBBqa6cMIF_BfQyDT1_I-UWvbFr7dmlOxmXAc6oChO-oBrZDtoC81ayxhWunNJErwecqUsptcYJq65jVwrvbLc5SGOnMakugqv2I9c5rysbVKq9btgfmz7JDhT4EzZnw=s2048" alt=""><figcaption></figcaption></figure>

Connection of New **Products** to Existing **Entitlements**

* **Entitlements** are used to specify features of a purchased subscription.&#x20;
* If not already created, create relevant **Entitlements**.&#x20;

<figure><img src="/files/nYvIAHp8v1jaSwES9OpJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RasJLlr8mqDufEHZpNJl" alt=""><figcaption></figcaption></figure>

* Open created **Entitlements** and attach previously created **Products**, based on the features they should contain, to relevant **Entitlements**.

<figure><img src="/files/o4DwSbdexiJqeJzl47Dc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jCFByUSdgcSWgXOLecem" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/Pj54dr-Ohr5Q5oHbI7Km-po0n9RH0ef_Epoi4CUZ-S-stEGDnQUNaol1jKVcKxjOa-VQ1DmANWQ49qmSSeYc0DY-7HhukcpYikzChKya22Tj_d82q0QsyoC08HRDPjo0PiaI3yvS-nCVCMK9hbvFWSwCfQ=s2048" alt=""><figcaption></figcaption></figure>

###

### Personalization rules

As you begin receiving predictions from our Prediction API (details for API integration can be found here -  [API Reference](/docs/integration/iap-personalization-setup/dynamic-offer-personalization/api-reference.md)), please ensure you use them in accordance with the following rules:

**Baseline Control:**&#x20;

* If user.group = control, then show 'Subscription Pro 100' paywall.&#x20;

**Personalized 50:**&#x20;

* Else if user.group = personalized and user.multiplier = 50, then show 'Subscription Pro 50' paywall.&#x20;

**Personalized 75:**&#x20;

* Else if user.group = personalized and user.multiplier = 75, then show 'Subscription Pro 75' paywall.&#x20;

**Personalized 100:**&#x20;

* Else if user.group = personalized and user.multiplier = 100, then show 'Subscription Pro 100' paywall.

**Personalized 125:**&#x20;

* Else if user.group = personalized and user.multiplier = 125, then show 'Subscription Pro 125' paywall.&#x20;

**Personalized 150:**&#x20;

* Else if user.group = personalized and user.multiplier = 150, then show 'Subscription Pro 150' paywall.&#x20;

**Personalized 200:**&#x20;

* Else if user.group = personalized and user.multiplier = 200, then show 'Subscription Pro 200' paywall.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.assetario.com/docs/integration/iap-personalization-setup/third-party-integrations/revenuecat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.