Skip to main content

Download fallback onboardings

To load an onboarding, your application requests its configuration data from Adapty. Onboarding configs store the URLs of your onboarding flows. If a network issue disrupts the connection between your application and the Adapty servers, you cannot correctly configure and display your onboardings.

To access onboarding configuration data offline, store a fallback configuration file inside your app code. You can download ready-made fallback files with configuration data for your onboardings and paywalls directly from Adapty.

Follow the instructions below to download the file and add it to your application code.

important

Fallback onboardings require an internet connection, since onboarding content is always stored online. The fallback file only stores the onboardings' configuration.

Read the onboarding offline mode article to understand what happens when the application cannot load the onboarding.

Before you configure fallback onboardings (Click to Expand)
  1. Create an onboarding.
  2. Create a placement for the onboarding to determine where in the app the onboarding appears.

Adapty automatically generates JSON configuration files for your fallback onboardings, one per platform. These files contain fallback data for your paywalls, as well.

If a single placement has more than one onboarding or paywall, the fallback version will include the variation with the highest weight, or the widest audience. Adapty updates these files whenever you modify your paywalls or onboardings.

Follow the steps below to download your fallback configurations:

  1. Open the Placements page.
  2. Click the Fallbacks button.
  3. Select your target platform (iOS or Android) from the dropdown.
  4. Select your SDK version to start the download.
Onboarding fallback example (Click to Expand)
"PLACEMENT_ID":
    {"data":
        [{"variation_id":"cb1c0ef8-aecd-4a53-a6f3-b98266e66884",
        "onboarding_id":"daf25858-3fa2-4981-8500-9c8a30e5b7e6",
        "onboarding_name":"ONBOARDING_NAME",
        "onboarding_builder":
            {"config_url":"CONFIG_URL",
            "lang":"en"},
        "remote_config":null,
        "cross_placement_info":null,
        "weight":100}],
    "meta":
        {"placement":
            {"developer_id":"DEVELOPER_ID",
            "is_tracking_purchases":true,
            "audience_name":"All Users",
            "placement_audience_version_id":"a9eb3ab8-3178-477d-84d4-ef9d3978e48b",
            "revision":0,
            "ab_test_name":"A/B_TEST_NAME"
        }
    }
},

After the download​

Follow the setup guide for your particular platform: