Digital Purchases for In-App Purchases

Follow along with this help document to set up your Single Use In-App Purchases component: Digital Purchases.

Adding The Digital Purchase component to your Adalo App

One of the common ways to monetize your app is with one time in- app purchase of digital products. Think of buying in game coins to upgrade your base in Space Fight Titans XL(not a real game). Or upgrading from a free app to a non subscription premium app. Or buying a pass to the online bootcamp that you’ve been wanting to join. These are all one time purchases of digital products, and are exactly what the new Adalo Digital Purchase component is built for.

A few things to understand before setting up this component. Your database needs a few things:

  • A collection of “products”

    • These can be events, activities, coaching sessions, etc. They just have to be associated with the item being paid for.

    • Or a unique product ID if you are only selling one product.

    • If you have a large volume of products to add, You can export the collection from Adalo, modify the .csv to meet the upload guidelines for Android. Apple requires you to add them one at a time.

  • You define these Product IDs. Google and Apple recommend something similar to using your package name/bundle ID and one or two words from the item i.e. com.spacefighttitansxl.powerup.1, but ultimately it can be anything that follows these restrictions.

    • Must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).

    • 148 characters or less

  • Your app will go through additional reviews when you have this component installed. We recommend adding this near the end of your development cycle and near deployment to reduce the time required to test the rest of your app.

  1. The Adalo Digital Purchase component can be installed to your Adalo account from the App Marketplace.

    1. Click the plus button in the left toolbar in your Adalo editor

    2. Scroll down and click the Explore Marketplace button

    3. In the Marketplace, scroll to find the Adalo Digital Purchase component and click to Install

  2. Drag the Digital Purchase component to your App’s purchase screen.

    1. The component has all of the style customization of the standard Adalo Button component.

  3. Set-up Digital Purchase component button

    1. Android and iOS Product IDs - These are the unique identifiers for the product being purchased. Google and Android have their own recommendation for the format, but it can be anything unique to that item. You can use the same Product ID for both platforms. Either select this property from your collection in Magic Text, or add a specific Product ID here.

  1. Button - Change the text, icon, font, color, and style of the button to match your app’s style.

  2. Treat Purchases as Restorations - For Non-Consumables and One-time subscriptions

    1. The App Store and Play store require a way to restore previous purchases from your users to a new device. Even though in Adalo, all of this information is tied to their account, and stored on our servers, this action is still required to exist in your app.

    2. When this is toggled on for a button, this button will look up the purchases made by the user, and verify if they have purchased this item in the past. If they have, it will return successful and you set your actions, if errored, it means the user has not purchased this in the past.

    3. You can have this button located anywhere, but we recommend adding in to a user settings screen. If you are selling multiple products with a dynamic Product ID, you can make a list of the products with this button in the list, and a user can then restore their purchases.

  3. Actions - The Digital Purchase component has three Actions for handling different outcomes from the Payment Modal. Add actions for each of these to unique screens, giving the User feedback about what happened.

    1. Successful - The purchase went through

      1. This is where you will update the record in your database for adding the user to the purchased item, update a field on the user record, or however you are handling tying purchases to your users.

      2. IN RESTORE MODE: This means the previous purchase was verified. Use the same actions as a new purchase.

  1. Error - There was an error.

    1. This is a declined or server side error.

    2. There are also error codes that you can save to an Error Log Collection, or surface in a text field while doing debugging.

      1. Use a “Create” or “Update” action and use magic text to access this

    3. IN RESTORE MODE: This means the previous purchase was not found, and the user needs to purchase this item.

  1. Canceled - The user canceled the purchase

  1. Web

    1. In-App Purchases only work for apps downloaded from the Apple App Store or Google Playstore.

      1. This component is hidden on web by default.

      2. Or show the component and have a web-only action to link to a Stripe payment screen.

  1. Now build your Android SDK and push an iOS Testflight build in Adalo.

Android - Setting up Digital In-App Purchases

  1. In your Play Store Console, Select your app.

  2. Upload your New APK with the Digital Purchase component set up to an Internal or Beta Release Track. **This must be done before you can set up any products for you app**

  3. Select the “In-App Purchases” from the left side menu under “Monetize>Products”

  4. This will take you through the steps of setting up your App for receiving payments if you have not already done this.

  5. All Products have to be tied to a Pricing Template. Pricing templates allow you to reuse pricing across multiple products and apps without having to keep the currencies exchanges and details updated for each one.

    1. Create a pricing template in your Google Play Console Account Settings. Not in the app specific settings

  1. Name your Pricing template something descriptive and set the price.

  2. Select if the price includes tax.

Hit Save.

Now create your In-App Products under the app specific settings>Monetize>Products>In-App Products

Complete the Product Details. Product ID is the property you set up with the Digital Purchase component.

  1. Provide some details for the product.

  2. Select the appropriate Pricing Template that you have created.

  3. Select “Activate” for the product

  4. Repeat 9-17 for each product, or format a .CSV to upload for a large list.

    1. Your app may require some additional review time before you can download and test the internal test track app from the playstore.

  5. Now download the internal test flight app and test the component!

  6. Proceed to publish as usual once tested.

iOS - Setting up Digital In-App Purchases

  1. Navigate to your App in App Store Connect, in the left side menu select In-App Purchase>Manage.

  2. These products will be available to be added to all apps in your account.

  3. Select the (+) button to add a new In-App Product

  1. Select the type of product you are adding.

    1. ***Auto- Renewing Subscription type is not yet supported

  1. Complete the Product details

  1. Product ID is the property you set up with the Digital Purchase component.

  2. Reference Name is something to identify the product in your dashboard

  3. Pricing - You select the price tier for your product. Check these before finalizing your price for your products in the collection.

  4. App Store Information will be displayed in the App Store Listing under “In-App Purchases” information section

  5. App store promotional - is optional. You can skip this for now

  6. Review information- You need to upload a screenshot of the purchase page for this specific product. Our recommended resolution is 1242 x 2688 or 640 x 1136 but all these sizes are accepted.

  7. Save

  8. Repeat steps 3-6 for each digital product you will be selling in your app.

  9. You need to set up your Apple Developer Account to accept payments. This is done here https://appstoreconnect.apple.com

  10. Select the “Agreements, Tax, and Banking” section to get set up. This must be completed before you can test or accept In-App Purchases with your app. It takes up to 24 hours to be approved.

  1. Now you can test your Digital Purchases in TestFlight. Purchases in TestFlight builds are FREE, but if they are successful in TestFlight, they will work in the App store.

  2. When you have thoroughly tested your app, you can submit the build for release to the App store. There are a couple additional steps when adding IAP for the first time.

  3. Navigate to the App Store tab at the top of the page, and scroll down to In-App Purchases

  4. Select the In-App Purchases associated with this app.

  5. Select the newly Tested build with the Digital Purchase component in the Build section. Note, you must submit a NEW build. An existing live build cannot be used when publishing the app.

  1. Follow your typical publishing process for releasing to the App Store.

  2. You now have a monetized with Digital Purchases App in the App Store!