Setup

Refer to the table below for the sections under Setup.

Fill in all the required sections and proceed.

The Advanced details have the following features:

Google Analytics Tracking

Enable tracking to monitor campaign performance via Google Analytics.

📘

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.

In the Advanced settings section, you can configure the fields to track campaign performance.

1. Enable the Custom key-value: It allows you to attach extra data as key–value pairs to the push notification payload
2. Enable the UTM tracking to add UTM Parameters to track campaign efficacy under Google Analytics' campaign reports. Refer to the table below for details on UTM Parameters.

📘

Important Points to Remember

• The UTM Parameter values defined in Global Advanced Settings appear automatically when you create a new campaign.
• You can edit any of these default values before saving the campaign. This would ONLY affect the campaign settings not the Global Advanced Settings.
• When the landing page URL already contains UTM parameters, the values you enter on the Setup page replace those values.
• If you leave a UTM field empty on the Setup page, and that parameter exists in the URL, the URL value is kept.
• UTM parameters gets added only to landing page URLs and action button URLs and not to non-URL actions like Dismiss, Copy Code, or Remind Me Later.

Set Conversion Goal

Refer to the table below to set up the conversion goal on the Setup page.

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.

Audience

The Audience section allows you to select who to target your in-app 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. Each trigger should have a distinct event.

Refer to the table below to learn 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.

• 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.

📘

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 15 lists or segments. Once you have made 15 selections, multi-select will be turned off for additional lists.

📘

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.

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.

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

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

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.

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 action	Description
   Open a URL	Directs the user to a specified web address.
   Send SMS	Opens the SMS app with a pre-filled message.
   Call this number	Initiates a phone call to a specified number.
   Deep Link	Redirects to a specific section within the app.
   Whatsapp	Opens a conversation in WhatsApp.
   Email	Opens the email client with a pre-filled email.

   3. 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.

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.

2. 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.

📘

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.

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.

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

3. Click Send Test Message to test and view your In-app message.
4. Click Done to complete the process.

Schedule

Finish creating and previewing your in-app 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 an in-app message is shown per session.
  • Time per day: Number of times an in-app message is shown in a day.
  • Time per campaign: Number of times an in-app message is shown per campaign.
    Fill in the required fields according to your preference. Before saving your campaign, you can also select Additional Settings.