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)
Last updated