Set up your new in-app purchases at the app stores

Precondition: You completed the Mage Portal Setup.

Great! You accomplished all necessary steps within the Mage portal. To check which new in-app purchases you need to create in iTunes Connect and Google Play Console click “In-App Purchases” in the navigation bar. Within the given table (figure 1) you can see all generated in-app purchase product IDs with prices. Now you only need to add those to your app in iTunes Connect and/or Google Play Console.

In case you already have a specific in-app purchase for your product with an identical price, you can simply change the in-app purchase identifier in the Mage configuration portal accordingly by pressing the “edit” button.

Figure 1: Overview of generated In-App Purchase objects

Note for Apple In-App Purchases only: Apples iTunes Connect Testers may hold back an update if they can’t find your new added in-app purchases. To prevent that, submit the in-app purchase screenshots from the default products to all new in-app purchase products. Write in the “Notes for Testers” section that you implement the in-app purchases for “A/B testing” purposes.

Take care of Apple Subscription Groups

Note: The following description is only relevant for Apple Subscription products.

Subscription Groups within Apple shall be used to organize your subscriptions and make it easier for users to switch plans. You usually collect subscriptions for the same feature in the same subscription group. In most cases, they only differ in runtime. Suppose you would put the new subscriptions with different pricings in the same subscription group. In that case, all your users can easily switch their subscription to the cheapest one via their subscription management menu.

To prevent your users from switching prices, you need to define a subscription group for each price level generated by Mage. If you already had several subscription groups, this needs to be done for each of your existing subscription groups.

Important: To prevent your users from switching to a different subscription price, you need to create one Subscription Group for every price level inside iTunes Connect.

Imagine the following example to make it more clear. Suppose you have a pro-membership subscription, with the runtimes yearly and monthly. Before integrating Mage you would have one subscription group (named pro-membership or whatever you chose) with two subscription products, yearly and monthly. Imagine that Mage suggested adding four additional price levels to your default price level. Before you add the subscription products generated by Mage you would need to create four additional subscription groups as well. The naming is not relevant and will never be seen by your users, simply name them as your default group and add a suffix indicating the price level. Then you can add in each subscription group the subscription products of the corresponding price level. An example is shown in the following table.

Table 1: Example Apple Supscription Group usage with Mage

That way, your users can still switch between your monthly or yearly subscription within a price level, but won't be able to switch between price levels.