Steps to Create an In-App Message Campaign

Send the In-app message when the user navigates to the specified screen. You can send the message immediately or after a delay using the Select trigger time option. 

Display Settings

Under the Display settings section, you can select the screens for each platform where the In-App campaign needs to be displayed. Toggle between the Android and iOS icons to configure the screens. 

• Show only on screen
  

  library_add_check

  Prerequisites Ensure that you have integrated your app screens with MoEngage.

  An application can contain multiple screens such as the login screen, home screen, product screen, checkout screen, and many more. You can select a particular screen from the Select screen name dropdown to display the In-app campaign on that screen.

  • For Android - MoEngage automatically fetches the selected screen from your app through the MoEngage SDK.

  • For iOS - You must enter the screen name where the In-App message needs to be shown.
    
    

• Show only in App context
  Context is a section or a part of a screen where you can display your messages. For example, a podcast screen can have two contexts, "For you" and "All episodes" context.
  You can add the name of the context where you want to display the In-App campaign. For more information on context, refer to:
  • Android
  • iOS

Displays the In-app messages when the user performs the custom event. You can send the message immediately or after a delay using the Trigger the message option.

IF user

The IF user section allows you to select an event. If you select a single event in the IF condition, if a user performs this event, MoEngage will send the In-app campaign. However, you can add multiple events and attributes with the IF condition.

In the IF user section, do the following:

1. From the Select an event drop-down, select the event.
2. From In-app Android SDK version 7.1.0 and In-app iOS SDK version 4.12.0, you can now add multiple OR conditions within the events using the + Trigger button. For example, show In-app message to users who have clicked in-app on Android or iOS at least 1 time. 
   
   Note: Raise a support ticket or ask your CSM to get this feature enabled. 
   
   

You can also refine the custom event. To do so:

1. Click + Attributes to add attributes to the filter.
2. From the Select attribute drop-down, select the respective attributes and the logical drop-downs for the selected attribute.
3. To add more attributes, do the following
   1. Click + Attribute button.
   2. Click AND or OR.
   3. From the Select attribute drop-down, select the respective attributes and the logical drop-downs for the selected attribute.

For instance, if you select the event "User installs the app", you can add the attribute "App Version" to filter for users who installed a specific version of the app.

AND then

You can now have more customization with the And then feature. In addition to the + Trigger option, the + Filter button allows you to string multiple events together. 

For instance, you can select the In-App Clicked Android event and then use the AND then option to add the Added to Cart event.

By doing this, the In-App campaign will be shown to users who have clicked an In-App campaign on their Android device at least once and then proceeded to add an item to their cart at least once. 

You can also define the time to wait before the event in the Filter condition is evaluated. Setting this limit to 15 minutes implies that the user must perform the Filter event within 15 minutes of performing the first trigger event. In this example, the first event would be In-App Clicked Android.

Note: The maximum delay that you can set here is 24 hours, and the minimum delay is 1 minute.

If you click + Filter again, you can add another event to the trigger criteria. You get the option to choose AND or OR. Combine the two filter conditions by choosing AND, or use the OR to filter users if they perform any of the events within the time limit.

THEN

In the THEN section, under Trigger the message, select an option to define when to show the message. The available options are:

• Immediately: The message will be shown immediately after the trigger criteria has been identified.
• After Delay: The message will be shown after the defined delay.

Trigger criteria summary: It summarizes the trigger on the basis of the events and attributes that you select, making it easier for you to understand the trigger criteria.

This filter option allows you to target the users based on user properties such as first seen, last seen, city, and so on. Click the User property tab and do the following:

1. Select the desired attribute in the drop-down list. This enables the filters based on the attributes selected. For example, attributes that are numbers can have filter conditions such as 'is equal to', 'is not equal to', 'is between', and so on, while string attributes have different filters.
2. Enter the filter value(s) to create the desired user segment.
3. Click + Nested Filter to add a filter to create nested AND or OR conditions. (This is optional)

For more information, refer to Create Segments.

This filter option allows you to target the users based on the behavior of the user or event, such as app/site opened, viewed product, and so on. Click User Behavior and do the following:

1. Select the execution condition and the desired user activity (event).
2. Enter the event frequency and time duration for the event execution.
3. Click + Attributes and add an event attribute with a filter condition.
4. Enter the filter value(s) to create a rule.

5. Use the + Aggregation button to add the aggregation functionality. For more information, refer to Aggregation Operations.

6. Click + Nested Filter to add a filter to create nested AND or OR conditions. (This is optional)

For more information, refer to Create Segments.

This filter option allows you to target groups of users created based on the user performing an action with a specific attribute value. For more information, refer to User Affinity. Click User Affinity and do the following:

1. Select the desired user event or attribute.
2. Select the user affinity parameter from the following:
   • Predominantly: Select affinity attribute with a filter condition and provide the affinity values.
   • For a minimum of: Select affinity attribute with a filter condition and provide the affinity values.
   • Most no. of times: Enter a value or use the arrows to provide the top percentage of users.
   • Least no. of times: Enter a value or use the arrows to provide the bottom percentage of users.
3. Enter or use the arrows to provide the time duration for the event execution.
4. Click + Attribute to add more attributes to the filter.
5. Click + Nested Filter to add a filter to create nested AND or OR conditions. (This is optional)

For more information, refer to Create Segments.

This filter option allows you to select a custom segment as the target audience.

1. Select a custom segment as the target audience from the list of custom segments available.
2. Click + Nested Filter to add a filter to create nested AND or OR conditions. (This is optional)

For more information, refer to Custom Segments.

• Campaign time zone: the timezone in which the campaign should be sent.
• Start date: the date on which the campaign should be sent.
• Periodic: the periodicity of the campaign. You can choose from the following options available on the left of the screen:

  Periodicity	Description
  Daily	Repeat every: This option allows you to specify the number of days after which the campaign should be repeated.
  Weekly	Repeat every: This option allows you to specify the number of weeks for which the campaign should be repeated. Repeat on: This option allows you to specify the day(s) of the week on which the campaign should be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option).
  Monthly	Repeat every: This option allows you to specify the number of months for which the campaign should be repeated. Repeat on: This option allows you to do the following: Days of month: Choose this option for repeating campaigns that are date-specific. Select the date(s) of the month the campaign should be sent (For example, to send the campaign on the 5th and the 25th of a month, select the 5th and 25th in the calendar widget.). Note: If the selected date(s) does not exist in the month specified (as it is a shorter month), a campaign will be sent on the last date. (For example, if the 30th and 31st are selected and the month is February, one campaign would be sent on the 28th). Days of week: Choose this option to specify the day(s) of the week on which the campaign should be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). Note: In case of a day of the week not existing in a month (for example, fifth Saturday), the campaign would be skipped for that instance. And in case of overlap (for example, 4th Monday and last Monday), only one instance would be sent.

• Ends: the date on which the campaign should end. The following options are available:
  • • Never: the campaign runs daily.
    • On: the campaign ends on the end date specified in the End date and End time fields.
• Campaign active window: the time duration for which the campaign will be active for the set periodicity. For example, if the campaign were to be shown to the user daily, the campaign active window setting determines the time interval during the day the campaign will be active. If this interval were set between 6 PM and 8 PM for a campaign with daily periodicity, the campaign will be shown every day to users from 6 - 8 PM. If the campaign were active twice a week, the campaign active window setting determines the time duration when the campaign will be shown to the user during the days on which the campaign would be active. The following fields are available to set the campaign active window:
  • • Start time: the time at which the campaign will be triggered for the user.
    • End time: the time duration post which the campaign will not be shown to the user irrespective of whether the campaign is set to be active on the specified day.