Display Triggers

Choose the events that cause your In-App Automated message to appear to your audience. These events are called display triggers. This page details the different display triggers, how to set them, and their optional conditions.

Setting Display Triggers

A display trigger is an event that causes an In-App Automation message to appear to your audience. You set display triggers during the Behavior step of the In-App Automation composer. You must set at least one display trigger.

  1. Select a display trigger.
  2. Set any additional options that apply to the trigger.
  3. (Optional) Click Add Another to add additional triggers.
  4. (Optional) Set additional display conditions. Triggers and conditions are handled as a boolean AND.
  5. Click to move on to the next step.

App Open

An App Open display trigger causes an In-App Automation message to appear based on the number times your audience opens your app.

In the Behavior step of the In-App Automation composer:

  1. Select the App Open trigger.
  2. Enter the number of times your audience must open your app to before the message will appear.

App Open display timing varies depending on whether users have opened the app before or currently have the app open. For a message with App Open value of 1:

  • If a user has never opened the app before, they will see the message the first time they open the app.
  • If a user has opened the app before and does not currently have the app open, they will see the message the next time they open the app.
  • If a user currently has the app open, the message will appear during the current session.
 Tip

If you are configuring a "Welcome" message intended to display when users first open your app:

  • Set the App Open display trigger value to 1.
  • Set your audience to Target Specific Users, specifying New Users.

If you want an onboarding message to appear the third time users open your app, set the App Open display trigger value to 3.

App Update

An App Update display trigger causes an In-App Automation message to appear when your audience opens your app some number of times after an app update.

In the Behavior step of the In-App Automation composer:

  1. Select the App Update trigger.
  2. Select All app updates or Specific app updates and then enter the number of times your audience must open your app before they will see your message.
  3. If you selected Specific app updates, you must set versions for each of your app's platforms. For each platform:
    • Select any version or the operator you want to use to evaluate specific version numbers.
    • If you selected an operator, enter the version number(s) you want to evaluate against. For Android apps, enter the versionCode; you can find your app's versionCode in your Google Play dashboard.
 Note

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

Custom Event

A Custom Event display trigger causes an In-App Automation message to appear to your audience when custom events occur (or recur some number of times).

Custom events capture key events in your app, e.g., screen views, media views, stories read, button clicks, items purchased or added to cart.

In the Behavior step of the In-App Automation composer:

  1. Select the Custom Event display trigger.
  2. Use the Events box to find an event. The search shows events that occurred in the last 30 days. If the event name you search for does not appear, click Use [search term] to use the event name as typed.
  3. Enter the number of times the event must occur before the message will display.
  4. (Optional) Click Add Another to add more custom event display triggers. Multiple events are handled as a Boolean OR.

Filtering Custom Events

When configuring the Custom Event trigger, you can filter your custom events using numeric values associated with those custom events, or by key/value properties attached to the events. Filtering events this way can help you more precisely target your audience.

Example
If you have a custom event named “Purchase”, with a purchase category fedoras and a value 125.0 representing the dollar amount of the purchase, you can add these criteria to the Purchase event so that your message is only seen by users spending at least $125 on fedoras.
 Note

Acceptable values and operators for event properties are based on the project's settings. See: Manage Event Properties.

  1. Click ADD PROPERTIES/VALUES for the custom event.
  2. Click Add Property or Add Event Value.
  3. Select the operator you want to use to evaluate the value or property, and enter the value or property you want to filter for.
  4. (Optional) Click to add an alternative for a filter.
  5. (Optional) Click Add Property or Add Event Value to add more filters.
  6. Select ALL/ANY to determine how to evaluate multiple filters and alternatives within each filter.
    • ALL = all criteria must be met (Boolean AND)
    • ANY = any criteria must be met (Boolean OR)
  7. Click Save.

Screenview

A Screenview display trigger causes an In-App Automation message to appear when your audience views a screen a specified number of times. You must configure app screens before you can select them as a part of this trigger. See: Manage App Screens.

In the Behavior step of the In-App Automation composer:

  1. Click Add a screen name, and find the screen you want to use for the trigger.
  2. (Optional) Click Add another screen name to specify multiple screens. Multiple screens are handled as a Boolean OR.
  3. Enter the number of times your audience must view the screen before they will see your message.

Time Has Elapsed

Time has elapsed is an optional In-App Automation display condition that delays the appearance of the message until the specified amount of time has passed.

After setting your display triggers in the Behavior step of the In-App Automation composer:

  1. Enable Time has elapsed.
  2. Enter the minimum number of seconds or minutes that must elapse before a message becomes eligible for display.

Viewing a Specific App Screen

Viewing a specific app screen is an optional In-App Automation display condition that causes your message to appear to your audience only if the display triggers occur while your audience is viewing a specific app screen. You must configure app screens before they become available to this option. See: Manage App Screens.

After setting your display triggers in the Behavior step of the In-App Automation composer:

  1. Enable Viewing a specific app screen.
  2. Click Add a screen name and find the screen that you want to limit the message to.
  3. (Optional) Click Add another screen name to add additional screens. Multiple screens are handled as a Boolean OR.