Skip to content
This repository has been archived by the owner on Mar 22, 2024. It is now read-only.

Change "current" Offering to "default" Offering when referencing a Project #542

Merged
merged 12 commits into from
Dec 5, 2023
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Offering Override
slug: offering-override
excerpt: Override the current offering that displays in your app
excerpt: Override the default offering that displays in your app for a given customer
hidden: false
---
You can override the current offering that displays in your app on a per-user basis by selecting a different offering in the **Current Offering** card. This can be useful for:
Expand Down Expand Up @@ -42,4 +42,4 @@ Click on edit to choose a new offering:
}
]
}
[/block]
[/block]
12 changes: 8 additions & 4 deletions docs_source/Getting Started/displaying-products.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,9 +81,13 @@ The `getOfferings` method will fetch the Offerings from RevenueCat. These are pr
>
> You can find more info about trouble shooting this issue in our [Help Center](https://support.revenuecat.com/hc/en-us/articles/360041793174).

You must choose one Offering that is the "Current Offering" - which can easily be accessed via the `current` property of the returned offerings.
You must choose one Offering that is the "Default Offering" - which can easily be accessed via the `current` property of the returned offerings for a given customer.

To change the current Offering, navigate to the Offerings tab for your project in the RevenueCat dashboard and click **Make current** next to the Offering you'd like to enable.
> 📘 What's the difference between a current Offering and a default Offering?
>
> The current Offering for a given customer may change based on the experiment they're enrolled in, any targeting rules they match, or the default Offering of your Project. Your Project's default Offering is the Offering that will be served as "current" when no other conditions apply for that customer.

To change the default Offering, navigate to the Offerings tab for your project in the RevenueCat dashboard and click **Make default** next to the Offering you'd like to enable.

![](https://files.readme.io/a6ff351-app.revenuecat.com_projects_85ff18c7_offerings_packages_pkge2ed0611690_attach_3.png "app.revenuecat.com_projects_85ff18c7_offerings_packages_pkge2ed0611690_attach (3).png")
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This image and the corresponding instructions still need to be updated -- waiting on Dashboard changes to do that


Expand All @@ -93,7 +97,7 @@ Offerings can be updated at any time, and the changes will go into effect for al

## Custom Offering identifiers

It's also possible to access other Offerings besides the "Current Offering" directly by its identifier.
It's also possible to access other Offerings besides the default Offering directly by its identifier.
michaelAtRC marked this conversation as resolved.
Show resolved Hide resolved

[block:file]
[
Expand Down Expand Up @@ -356,4 +360,4 @@ This can be accomplished with custom Offering identifiers for each of these "coh
# Next Steps

- Now that you've shown the correct products to users, time to [make a purchase ](doc:making-purchases)
- Check out our [sample apps ](doc:sample-apps) for examples of how to display products.
- Check out our [sample apps ](doc:sample-apps) for examples of how to display products.
14 changes: 5 additions & 9 deletions docs_source/Tools/targeting.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Targeting
slug: targeting
hidden: true
---
Targeting allows you to create rules for serving distinct audiences their own Offering. Instead of having a single Current Offering that all customers receive, you can instead create a cascading sequence of rules to deliver different Offerings to each audience that you define.
Targeting allows you to create rules for serving distinct audiences their own Offering. Instead of having a single Default Offering that all customers receive, you can instead create a cascading sequence of rules to deliver different Offerings to each audience that you define.

This allows you to create paywall experiences that are tailored to each of your audiences so you can make an effective pitch for your product and maximize lifetime value.

Expand All @@ -16,7 +16,7 @@ This allows you to create paywall experiences that are tailored to each of your
| Term | Definition |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Offering | The set of Packages, metadata, and an optional paywall UI you can create to remotely control your paywall experience. |
| Current Offering | The Offering that is set as "Current" in the RevenueCat Dashboard. We recommend designing your app so that the paywall always shows the Current Offering so that you can remotely control which Offering is presented. |
| Default Offering | The Offering that is set as "Default" in the RevenueCat Dashboard. We recommend designing your app so that the paywall always shows the Default Offering so that you can remotely control which Offering is presented. |
| Targeting | The ability to assign a distinct Offering to a distinct audience of customers based on Targeting Rules you create. |
| Targeting Rule | A collection of conditions that, when they are true for a given customer, will result in that customer matching the rule and being served the corresponding Offering. |
| Conditions | The filters such as App, Country, and App Version that can be used to construct a Targeting Rule. |
Expand All @@ -30,20 +30,16 @@ Before you setup any Targeting Rules, if you use Offerings, here's how they're r

1. RevenueCat is initialized
2. Offerings are fetched
3. Your list of Offerings is returned, along with the identifier of your **Current Offering**
3. Your list of Offerings is returned, along with the identifier of the **Current Offering** for a given customer
michaelAtRC marked this conversation as resolved.
Show resolved Hide resolved

As long as your app is setup to display the Current Offering on your paywall, then you can change that Offering at any time from our Dashboard, or run an Experiment to serve two different Offerings to specific audiences.
As long as your app is setup to display a customer's Current Offering on your paywall, then you can change the Default Offering that gets provided for a customer at any time from our Dashboard, or run an Experiment to serve two different Offerings to specific audiences.

Once you setup Targeting Rules, you unlock an additional level of customization, because the **Current Offering** that gets returned for each customer will be based on the Rule they qualify for. For example:

1. RevenueCat is initialized
2. Offerings are fetched
3. Your list of Offerings is returned, along with the identifier of the Offering for the first rule that the customer matched as the **Current Offering** for that customer
1. If the customer does not match any specified rules, the **Current Offering** will be set as your default Offering

> 📘
>
> Think of your "default Offering" just like your "Current Offering" if you have no Targeting Rules setup. It's the Offering that will get served if no other rules apply.
1. If the customer does not match any specified rules, the **Default Offering** will be set as their Current Offering
michaelAtRC marked this conversation as resolved.
Show resolved Hide resolved

When determining which (if any) Targeting Rule a customer matches, we'll assess them from top to bottom as you've ordered them in the Dashboard.

Expand Down