Target Specific Users

In the Audience step of the In-App Automation Workflow, you have the option Target Specific Users, which lets you select your audience based on various conditions.

See also: Targeting and Target Specific Users.

Steps

  1. Select a condition from the dropdown menu, then configure as required. To remove a selection, click the X icon at the end of its row.

  2. Optionally click Add another condition and configure.

    Multiple conditions in a single message are handled as a Boolean AND, meaning a user must meet ALL of the conditions to see a message.

  3. Click the next step in the workflow's header to move on.

Conditions

App Version

Target users based on the version of your app they have installed.

For each platform, select any version, is equal to, is between, is greater than or equal to, or is less than or equal to from the dropdown menu, then enter the version number(s). For Android apps, enter the versionCode. If you don't know this value, you can find it in your Google Play dashboard.

Note

Is between includes boundary values, i.e., entering versions 4.3 - 5.1 includes 4.3 and 5.1.

Tip

Use the App Version target to contact users on older versions of your app and encourage them to upgrade to the latest version.

Tip

You can view the available app versions and measure audience size by creating a segment in our Segments Builder.

Location Opt-in Status

Target users based on their opt-in status to Location. Select from the dropdown menu: Opted in or Opted out of location.

New Users

Select New Users to ensure your message is seen only by users who have freshly installed your app.

New Users are detected on the first app startup, and a user becomes eligible to receive all messages targeting a New User at that time. The actual message has the potential to be displayed in the future, however, depending on the other display rules (e.g., triggers) selected.

Note

Users who reinstall the app will become re-eligible for messages targeted to New Users. There is not a way to prevent this currently.

Users will not see New Users-targeted messages that are published after the first time the app was run. However, they will see edits to message content.

Tip

New Users is useful for targeting users with a "Welcome" message, which the user will see the first time they open your app. Our SDK will download and display messages to a new user if they’re set to be triggered on the next app open.

You can also use the New User target to orchestrate a series of onboarding messages by triggering a different message to display on the second, third, and fourth app open, for example.

Platforms

Filter the eligible audience for your message to those on a specific platform. Check the box for iOS, Android, and/or Amazon.

Tip

Create platform-specific content and functionality in your messages.

Push Opt-in Status

Target users based on their opt-in status to Push. Select from the dropdown menu: Opted-in or Opted-out of push notifications.

Tip

Some example uses include:

  • Present new users who are opted out of push with a message giving them reasons to opt in during onboarding.
  • Retarget long-time users who never opted in to push with messages giving them reasons to opt in.
  • Market features specifically to users who are opted in to push.

Tags

Filter the audience eligible to see your message by targeting users who have or do not have a specific tag, including server-side tags and tag groups.

Note

In-App automation caches server-side tags on the device for use as an audience condition. We make our best attempt to keep the cache up to date, but there can be situations where a message is triggered and the tag is not yet available on the device.

You can specify how the message is handled when this situation occurs. See: Missed Behavior.

  1. Select is or is not from the dropdown menu, then enter a term in the search field.

    To filter results, click the arrow to the right of the search box, then select Tags or a specific tag group. You can select a filter before or after entering a search term.

  2. From the search results box, do one of:

    • Click to select a tag from the listed results. A tag's tag group, if any, is listed below the tag name.

    • Select a tag group from the dropdown menu.

    • Click the button to create a new tag.

  3. Optionally click the plus sign to add another tag.

    For each additional tag, select and or or from the dropdown menu.

    and = all criteria must be met (Boolean AND)
    or = any criteria must be met (Boolean OR)

Click the X next to any tag or at the end of any row to remove it.

Tip

Example use case: Educate specific users about your app's Store Finder feature.

  1. Create an In-App Message about the Store Finder feature, and target users who do not have the tag store_finder.

  2. Associate the tag store_finder with the message's button action or when the message is displayed. This ensures that users who have seen the message will not see it again.

Locale

Target users based on their device's locale, which is determined by the device's language and country settings. Select language and country from the dropdown menus. Country is optional.

Click Add additional locale to add another locale. Click the X at the end of any row to remove it.

Tip

Example

If you want to display a message in French to users that have a country code of France, select both French and France.

If you want to display a message in French to all users that have their language set to French, regardless of country setting, select French and do not select a country.

Predicted to Churn

Target users based on their likelihood to abandon your app. Predictive Churn analyzes your audience for users that exhibit behaviors indicating they are likely to become inactive, and tags the users as High, Medium, or Low Risk.

Select a group from the dropdown menu.