Using Initial Configuration

Setting up your app with an initial config file

What is Initial State Configuration?

Initial State Configuration is a state that your app uses when it can't connect to Nami. It tells the app which campaigns, products, and paywalls to raise when the Nami servers cannot.

There are 2 main use cases for this config:

  1. User doesn't have access to the internet when they try to raise a paywall
  2. Nami services are down

Setting up Initial Campaigns and Paywalls

1. Create Campaign Rules

For each placement in your app, create additional campaign rules. You should create 1 campaign rule for each form factor and device language.

2. Mark Rules as Anonymous

When creating, mark the campaigns as 'Anonymous'

Learn more about Anonymous Mode

3. Add Filters

In Anonymous Mode, the audience filters are restricted.

  • App Platform - REQUIRED - Put all of your current payment platforms in this list
  • Device Form Factor - Required if your app is supported on multiple form factors. Not required if you only serve phones. Ensures that users always get a paywall that supports their current device form factor
  • Device Language - COMING SOON - Required if your app supports more than 1 language. Ensures that users always get a paywall in the correct language

4. Create Paywall(s)

Create a paywall with basic functionality and no personalization. Add products to the paywall for each platform.

Add a paywall for each form factor and device language.

5. Assign Paywalls to Campaign Rules

Make sure each campaign rule has a correct corresponding paywall that matches its form factor and language.

Downloading Initial Config files

Initial State Config files need to be downloaded for each app and each platform integration in the app.

  1. Go to Integrations
  2. Find the Platform you are trying to setup.
  3. Click 'Export initial config'
  4. Select the SDK version. Unsure? Select '3.1+'

You will get a JSON file with products, paywalls, and campaign rules. The paywalls and campaign rules correspond to the setup in the previous section.