Create In-App message

In-app messages enable direct communication with your mobile application users.

Overview

In-app messages are triggered when a user interacts with your app. These messages allow you to engage your users at different times throughout the customer journey. With the help of the Netcore CE dashboard, you can easily create and enhance your In-app message campaigns. Discover the prerequisites, a step-by-step guide to create an In-app message, and detailed explanations for each section here.

📘

Prerequisites

Integrate Netcore SDK in your application. Refer here to integrate App SDK into your application

Steps to Create an In-app Message

There are six steps to create an In-app message campaign, and they are:

  1. Click the Create button on the dashboard homepage.
  2. Select Engage with users > Web Message under Onsite.
Create an In-App Message

Create an In-App Message

3. Setup: Add the campaign details here.

Setup

Refer to the table below for the sections under Setup.

SectionsDescription
Campaign NameEnter a unique name for this in-app message campaign.
Select appsChoose the app(s) where this message will appear.
Add tagsAdd relevant tags to organize and categorize this campaign. You can select up to 5 tags.

Fill in all the required sections and proceed.

The Advanced details have the following features:

  1. Google Analytics Tracking

Enable tracking to monitor campaign performance via Google Analytics.

Google Analytics Tracking

Google Analytics Tracking

  • Source (utm_source): Identify the origin of your traffic, such as a search engine or newsletter.
  • Medium (utm_medium): Specify the marketing medium, like email, social, or CPC (cost-per-click).
  • Campaign (utm_campaign): Name the specific campaign, like a product launch or a seasonal sale.
  • Content (utm_content) (Optional field): Differentiate specific campaign content or links.

📘

GA Tracking Guidelines

  • Ensure you're using Netcore Android SDK v3.5.0 and Netcore iOS SDK v3.5.0 for GA tracking.
  • Netcore provides personalized values for {CHANNEL} in utm_medium and {CAMPAIGN_NAME} in utm_campaign.
  • Personalized values are not supported for utm_source and utm_content.
  • Character validation allows only: a-z A-Z 0-9 - _ . @ : ' / { }.
  • UTM values auto-populate based on global settings once enabled.

Example: Redirection URL with utm_source = Smartech, utm_medium = {CHANNEL}, utm_campaign = {CAMPAIGN_NAME}, utm_content blank: https://domain.com/collections/payday?utm_source=Smartech&utm_medium=in-app&utm_campaign=25Jan_TRIWellSale.

  1. Conversion goals

Add conversion goals to monitor key business metrics and measure the success of your web message campaign. You can track one conversion goal per campaign. Select any event as a conversion goal activity according to your objectives.
For example, if you want to track the number of customers who have purchased shoes after your campaign was sent. (Event - Product Search, Product - Shoes).

Set Conversion Goal

Set Conversion Goal

  • Specify payload parameters: You can define criteria for the conversion event payload. You can add up to 5 parameters that are available for customization.
    For example, specify a Purchase event when the product price exceeds 10,000.
  • Conversion Window: Select this option to define the time frame for successful actions after interacting with your campaign.
  • Revenue Parameter: Select this option to assign a value to each successful action for tracking financial impact.
  1. Control group

These are the number of users you intentionally exclude when sending campaign content. They serve as a reference point for evaluating the effectiveness of your campaign.

📘

NOTE

Setting up a conversion goal is mandatory when using the Control Group feature.

To exclude users in the control groups, do the following:

  1. Toggle on the control group to exclude the users in the control group from the campaign's target segment.
  2. Specify the percentage of users you want to exclude from the campaign using the scroller/ slider.
Control Group

Control Group

4. Audience: Define the target audience for the campaign.

Audience

The Audience section allows you to select who to target your web messages. It has the following sections:

  • Trigger
  • Filters
  • Select Contacts
  • Exclude Contacts

A Trigger determines when to display the in-app message based on specific user actions or conditions. Trigger events in this section activate in-app message displays to users. When a user performs any defined event, the message appears. You can add up to five triggers in a campaign.

Refer to the table below for the Triggers available when creating an in-app message.

Set a trigger event as follows:

  • Event: Choose from the dropdown menu (e.g., Add to Wishlist, App Launch).
  • Geofence Events Support: Choose a User Exited, User Entered, or User Dwelled geofence. Select geofence criteria like name or group as payload parameters. You can also select criteria such as geofence name and geofence group as payload parameters. For geofence setup instructions, refer to this document.

Refer to the table for descriptions of geofence events.

GeofenceDescription
User ExitedThe user has left the designated geofenced area.
User EnteredThe user has entered the specified geofenced area.
User DwelledThe user remained within the geofenced area for more than 15 minutes (dwell time).
  • Delay: Introduce a delay (up to 120 seconds) between the triggering event and message display.
  • Specify Parameters: Further refine payload parameter criteria for the event.
    Add multiple trigger events and delays to display the same in-app message across different app sections.

📘

Minimum SDK version requirements

To utilize multiple trigger events, update to Netcore Android SDK v3.1.23 and Netcore iOS SDK v3.1.10 or newer.
For delay functionality, update to Netcore Android SDK v3.5.0 and Netcore iOS SDK v3.5.0 or newer. Older SDK versions only use the first added event as the trigger.

Select Contacts

Choose a specific segment or list to define the audience for the in-app message after the trigger event. Pick up to five user segments or lists. Use for targeting based on historical behavior captured by server-side user segments.

Select user list/segment to send the campaign to

Select the user list/segment to send the campaign to

📘

Note

Select list/segment from your saved segments because you cannot create a new segment in this section.

Exclude Contacts

After the trigger event, select the list or segment of users to exclude from the in-app campaign. The multi-select dropdown allows you to choose up to 5 lists or segments. Once you have made 5 selections, multi-select will be turned off for additional lists.

Select user list/segment to exclude from the campaign

Select the user list/segment to exclude from the campaign.

📘

SDK Requirements for Features

List & Segment Selection and Multi-event Conditions: Available on Android SDK v2.2.19 and iOS SDK v2.5.5. Ensure you migrate to the AndroidX library if not already done.
Event Filter Criteria: Only the last 200 events stored locally on the device are considered.
Exclude Contacts Functionality: Available on Android SDK v3.5.0 and iOS SDK v3.5.0 or newer.

5. Content: Define the content of the web message to be sent.

Content

After the basic setup and defining the target audience, Content is the section where you can create your template. In this section, you can create your in-app message using various template positions and editing options to make your template stand out.

Refer to the table to learn about the template positions for creating an in-app message.

PositionDescription
Sticky HeaderA banner message that sticks to the top of the screen.
Sticky FooterA banner message that sticks to the bottom of the screen.
Half InterstitialA message that covers half of the screen, typically centered.
InterstitialA full-screen message appears over the entire screen temporarily.
CoverA message that thoroughly covers the entire screen, requiring user interaction.

Once you have selected the in-app position, proceed to create the template.

Click Create New under the Select template option. This lists all the templates for the in-app message channel based on the selected layout. You can create a template from scratch with these three options:

  1. Text only: A message that consists solely of text.
  2. Image only: A message that includes only an image without any accompanying text.
  3. Custom HTML
Select your preferred In-app message template

Select your preferred In-app message template.

Refer to the table below, which outlines the various features and their specifications for different types of in-app message templates.

Template TypeFeatureSticky Header and Sticky footerHalf Interstitial and InterstitialFull-screen cover
Text onlyCharacter limitMessage: 80 charactersTitle: 35 characters
Message: 150 characters
Message: 80 characters
Text onlyImageNANANA
Text onlyAction buttonup to 2 buttons, 15 charactersOne button, 15 characterup to 2 buttons, 15 characters
Text onlyBackground color or background imageYesYesYes
Text onlyPersonalizationYesYesYes
Image onlyImage
Format: .jpeg, .jpg, .png
or add a URL link
Size: 100 KB
Resolution: 2:1 ratio
Half interstitial
Size: 100 KB
Aspect Ratio: 1:1 ratio

Interstitial
Size: 500 KB
Aspect Ratio: 1:2 ratio
Size: 500 KB
Resolution: 1:2 ratio
Image onlyAction buttonNANANA
Image onlyPersonalizationYesYesYes

Text-only

Select the Text only option to create the content for your in-app message. As you proceed, you see these options on the left pane and its preview on the right pane.

Create an In-app message with Text only

Create an In-app message with Text only

  1. Text

    1. Title: The main heading or headline of your message.
    2. Message: The detailed text or body of your in-app message.
  2. Background

    1. Color
      Solid: Choose a single color for the background.
      Gradient: Select a gradient color scheme for a more dynamic background.
    2. Image
      URL: Use an image from a web link.
      Upload Image: Upload an image from your device.
  3. Action button

    1. Action title: The text appearing on the action button.
    2. Call to action: Define what happens when clicking the button. Refer to the table to learn about the actions available here.

    Call to actionDescription
    Open a URLDirects the user to a specified web address.
    Send SMSOpens the SMS app with a pre-filled message.
    Call this numberInitiates a phone call to a specified number.
    Deep LinkRedirects to a specific section within the app.
    WhatsappOpens a conversation in WhatsApp.
    EmailOpens the email client with a pre-filled email.
    1. Enter URL here: Provide the URL for the action.

📘

Note

The supported file formats are JPEG, JPG, and PNG, with a maximum size of 100 KB and a2:1 resolution.

Image only

Select the Image only option to create the content for your in-app message. As you proceed, you see these options on the left pane and its preview on the right pane.

 Create an In-app message with Image only

Create an In-app message with Image only template

  1. Image
    1. Choose type
      URL or Upload Image

Media URL: Add the direct link to the media file or image.
Redirection URL: The URL that users will be taken to when they click on a link.

  1. Action button
    1. Action title: The text appearing on the action button.
    2. Call to action: Define what happens when clicking the button. Refer to the table to learn about the actions available here.
Call to actionDescription
Open a URLDirects the user to a specified web address.
Send SMSOpens the SMS app with a pre-filled message.
Call this numberInitiates a phone call to a specified number.
Deep LinkRedirects to a specific section within the app.
WhatsappOpens a conversation in WhatsApp.

📘

Note

  • Image size restrictions are recommended for optimal user experience and apply to images uploaded on the Netcore CE dashboard. To use larger images, use the self-hosted image URL feature.
  • Personalize in-app messages using event payload parameters to provide a tailored experience for your customers.
6. Test Your In-App Message

As you compose your in-app message, preview it in real time. The Send Test Message feature helps you preview the final message that your user will receive. You can view how your In-app messages look on different devices and screen sizes. Make adjustments on the spot to ensure clarity and engagement. This way, your message is consistent, appealing, and effective before you send it out.

Follow the steps below to test your in-app message.

  1. Click the Send Test Message button on the right pane of the Content screen.
  2. Choose the device on which you want to preview the in-app message. There is no limit to the number of devices you can select. Refer here to learn how to add a test device.
Test your In-app message

Test your In-app message

The Reset option clears previously chosen devices. It allows you to select new devices or prevent unintended recipients from receiving test messages.

Reset selected test device(s)

Reset selected test device(s)

  1. Click Send Test Message to test and view your In-app message.
  2. Click Done to complete the process.
7. Schedule: Define the campaign's delivery time and date.

Schedule

Finish creating and previewing your web message, then schedule your campaign.

  • Under Start campaign, select Send Now to send immediately or select Send later to send it on your desired date and time.
  • Under Campaign frequency, you can control how often a user views your campaign. Under Select the frequency, you have three options.
    • Time per session: Number of times a web message is shown per session.
    • Time per day: Number of times a web message is shown in a day.
    • Time per campaign: Number of times a web message is shown per campaign.
      Fill in the required fields according to your preference. Before saving your campaign, you can also select Additional Settings.
  1. Launch Campaign: Once you have checked the appearance of your entire in-app message, publish it by clicking the Save button.