# 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FJjEY5pNPDnesrRyqrQ4L%2Fimage.png?alt=media&#x26;token=9959737b-1c2a-4e1b-b67f-458a8103ec86" 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FxHt3X9CuIKdPEtfUvepF%2Fimage.png?alt=media&#x26;token=d5960378-eb34-4e35-8726-806f3fcf5ef6" 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FH05esSlkxBwqXFG9XXjW%2Fimage.png?alt=media&#x26;token=0b3ee2f6-6b90-4e9a-b927-e1dad61a2dfd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2Fhc0jAfxYOYO97bXhfGmR%2Fimage.png?alt=media&#x26;token=5682cecd-a246-4709-ad5e-f38be01e702b" 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FkcWSCTTijXUOv3onwJEK%2Fimage.png?alt=media&#x26;token=0d911298-fd1d-4605-9b28-f9e023e5e537" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FicUL6salo1rdWsvRTQoH%2Fimage.png?alt=media&#x26;token=f333b735-6750-4c2f-8469-0748ebd99678" 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FyCPIb6HVFEjPhj5I9LT5%2Fimage.png?alt=media&#x26;token=b1faf0b0-4926-4e84-ba4b-c47f1950a0aa" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2F814Q86PGSGOHP5RsZquH%2Fimage.png?alt=media&#x26;token=5e7bba16-4228-43f3-a90d-94b8bb68b6ce" 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="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FRT6Tbuonw4UwE8PYe3vR%2Fimage.png?alt=media&#x26;token=b90566cc-30c9-46ab-98dd-998f3cd7a3ef" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3188841492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAGtOmjs5vysomqgbUw8%2Fuploads%2FZayNkDEiG4uD62kINS4r%2Fimage.png?alt=media&#x26;token=461f5e2d-89f7-4ffe-a1d2-af620e272226" 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](https://docs.assetario.com/docs/integration/iap-personalization-setup/dynamic-offer-personalization/api-reference)), 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>