Campaign Filters

Learn what options are available for filtering your campaigns to specific audiences

Campaigns provide the rules for how your users will encounter paywalls in your app.

Nami supports filtering your app audience so that you can control which groups of users see your paywalls without requiring an app update.

Audience Rules

Device Region

Previously named Device Country

Device Region corresponds to the region set by the user in their device settings. Typically this value will never change and corresponds to the region in which they purchased/setup their device.

Options: List of countries Operators: Equals, Not equals

On an iOS device, this value can be found under Settings > General > Language & Region > Region.

Device Marketplace

Device Marketplace corresponds to the purchasing region set by the user in their store settings. Typically this value will never change.

On an iOS device, this value can be found under Settings > Apple ID > Media & Purchases > View Account

Options: List of countries Operators: Equals, Not equals

Device Geolocation

This filter available on Enterprise plans only

Device Geolocation allows you to filter users by their current physical location. Device Geolocation will be different from Device Country if the user is travelling or physically in a location other than where their device was setup.

Options: List of countries Operators: Equals, Not equals

Device Language

Device Language corresponds to the language set by the user in their device settings.

Options: List of languages Operators: Equals, Not equals

On an iOS device, this value can be found under Settings > General > Language & Region > iPhone Language.

On a Google Android device, this value can be found under Settings > System > Languages & input > Languages.

Device Form Factor

Form Factor refers to the size of device that the user is using. Templates currently are designed for a single form factor, so you will want to use targeting to make sure the right paywall is shown to the right device.

Options: Phone, Tablet, TV. Operators: Equals

You can only select 1 Device Form Factor per campaign rule

Device OS

Device OS corresponds to the operating system of the user device.

Options: Android, iOS, iPadOS, tvOS, Roku, FireOS. Operators: Equals, does not equal

If you want your paywall to show to any user on an Apple mobile device, include both iOS and iPadOS. Or exclude iPadOS to only show to iPhones.

OS Version

OS version corresponds to the version of operating system the user device is running. Should be used together with Device OS to target specific versions.

Options: Type in a value Operators: Equals, does not equal, greater than, greater than or equal to, less than, less than or equal to

SDK Version

SDK Version refers to the version of the Nami SDK running inside your app. As Nami adds new features, you will need to target your content to make sure that the user's app supports it.

Options: Type in a value Operators: Equals, does not equal, greater than, greater than or equal to, less than, less than or equal to

App Version

App Version is the version number of your app. Use this rule to target only specific test users.

Options: Type in a value Operators: Equals, does not equal, contains, does not contain

Platform

Platform allows you to filter users by a specific Platform Integration. This can be useful if setting up a new platform integration. Otherwise, you should use Device OS.

Options: List of all your Billing Platforms Operators: Equals, does not equal

If you want to filter to all Apple users, use Device OS instead of Platform.

CDP Audience

This filter is available on Enterprise plans only

CDP Audience allows you to filter to users belonging to a specific CDP Audience segment.

Options: List of all your CDP Audiences Operators: Equals, does not equal

Nami Device ID

Nami Device ID allows you to filter to a specific user by their Nami identifier. This value can be found in device logs or in the Developer Feed.

Options: Type in a value (case sensitive) Operators: Equals, does not equal

This filter should be used for testing only in order to target a specific device

External ID

External ID allows you to filter to a specific user for testing. Use the value sent to Nami when logging the user in, that can be found in the Customers screen.

Options: Type in a value Operators: Equals, does not equal

This filter should be used for testing only in order to target a specific user

CDP Id

CDP Id allows you to filter to a specific user by their customer data platform id.

Options: Type in a value (case sensitive) Operators: Equals, does not equal, contains, does not contain, starts with, does not start with

Combining Rules

If you apply multiple options from 1 filter, these are applied as an 'OR'. For example, in this image the paywall would show to users with device country Australia OR New Zealand.

If you add multiple filters, you can select how to combine them (AND or OR)