Discover the prerequisites, a step-by-step guide to create an app push campaign, 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 App Push

Follow the steps to create an App push campaign.

Log in to the Netcore CE dashboard.
Click the Create button on the dashboard homepage.
OR
Navigate to Engage > Campaigns > Create.
Select Engage with users > App Push under Campaigns. Select the App push type you want to create. The available App push types are Regular campaign, A/B Campaign, Split and Multi Message.

4. Setup: Add the campaign details here.

Setup

Refer to the table below for details on the sections available under Setup.

Sections	Description
Campaign Name	Enter a unique name for this app push campaign. Maximum length: 255 characters Allowed characters: alphanumeric, space, a hyphen, underscore, and ampersands (&)
App(s)	Choose the app(s) where this notification will appear.
Add tags	Add relevant tags to organize and categorize this campaign. You can select up to five tags.

Fill in all the required sections and proceed.

The Advanced details have the following features:

Advanced Fields	Description
Set Conversion Goal	Add conversion goals to monitor key business metrics and measure the success of your app push campaign. You can track one conversion goal per campaign. Select any activity 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). This is a mandatory field.
Payload parameters	You can define criteria for the conversion event payload. Up to five parameters can be added for customization. For example, specify a purchase event when the product price exceeds 10,000.
Conversion Window	Define the conversion window to link user actions to campaigns in a specific timeframe.
Revenue Parameter	Select this option to assign a value to each successful action to track financial impact. This is a mandatory field.

5. Define the target audience for your campaign in the Audience section.

Audience

The Audience section lets you select who to target your App Push. It has the following sections:

Target Audience

Choose a specific segment or list to define the audience for the App push campaign. Pick up to five user segments or lists. Use for targeting based on historical behavior captured by server-side user segments.

Target Audience has the following options:

All Contacts: Target all users in your contact list when creating campaigns.

📘
All Contacts Setting
Admin users of the Netcore CE dashboard can disable the All Contacts option, if they prefer not to send a campaign to all contacts. This option is enabled by default, making the All Contacts option selection accessible. However, admin users can change it as needed.
To enable or disable the feature, navigate to Profile > Account Configuration > All Contact Enable/Disable >Active / Inactive.
Enable or Disable All Contacts option

Segments/List: Select from existing lists or segments to target specific contacts. Search for the desired segment or list by name and add it to your campaign with a checkbox selection.
Ad-hoc segment: This lets you instantly create segments, view user counts, and integrate them into your campaign targeting.
User data table (UDT): This is a specialized collection of contact information that includes additional attributes such as email addresses, physical addresses, and other personal details. UDT provides detailed information about contacts to help personalize and target campaigns.

Exclude Contacts

Select suppression segments or lists to exclude specific users from campaign targeting. You can select up to five segments or lists for exclusion.

6. Create the content of the app push under the Content section.

Content

After the basic setup and defining the target audience, Content is the section where you can add the content for your campaign. You can Create new layout, use from existing APN templates, or select from the Advance layouts listed on this screen.

Several layouts are available to suit your message and audience. Here is an explanation of each layout.

Layout	Description	Use Case
Overlay on Image	This layout allows you to display a message over an image.	Promote a new product with a captivating image and a call to action.
Timer	This layout allows you to add a countdown timer to create urgency.	Notify users that a flash sale will be ending soon.
Carousel (E2E)	This layout lets users swipe through multiple images or messages.	Showcase a series of related products or features.
Edge to Edge	This layout allows you to expand the notification to cover the entire width of the screen.	Highlight a major update or announcement with maximum visibility.
Rating	This layout allows you to include a rating option for quick feedback.	Ask users to rate their experience after completing a purchase.
Small Image	This layout allows you to show a small image alongside the notification text.	Share a product image with a quick update or offer.
Progress Bar	This layout allows you to display a bar indicating progress toward a goal.	Inform users of their progress in a download or achievement.

📘
Using Timer and Progress Bar in Journeys
Ensure to follow these points while using Timer and Progress Bar layouts.

The journey end time must be less than or equal to the timer or progress bar end-time.

The timer can run for a maximum of 24 hours. If the journey exceeds this, users may receive expired timer notifications.

The TTL (Time To Live) must not exceed the timer or progress bar endtime. If it does, notifications may be delivered after the timer has expired, showing the timer end message to users.

When you create or select an Advanced layout, the Customize Your Template screen appears. Here, you can add and customize app push notification content. The left pane updates the mobile preview on the right, showing how it will appear to users.

Toggle on Enable APN Interactions to include rich media elements, action buttons, sound, deep links, and more.

Enable APN Interactions to include rich media, sound and so on — Enable APN Interactions to include rich media, sound, and so on

Refer to the table below to learn about all the options available to customize your app push template.

Options	Descriptions	Available for
Title	Allows you to add the title of your push notification. You can also add formatting such as bold, italics, underline, text color, and background color here. 📘 Text formatting is supported only on Android SDK.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Description	Allows you to add the message content of your push notification.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Landing page	Allows you to redirect the user to your preferred location when the user clicks the notification. The options available here are: Deeplink: Opens directly within a specific app section. URL: Opens in any app or browser location. App landing page: The main entry or home page of the app.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Add Image	Allows you to insert an image. Upload File: Drag and drop the file or select it from your computer. Media URL: Allows you to add an image URL. 📘 PNG and JPEG file formats are supported. URL must include an HTTPS protocol ending with a supported file format. Example: https://website.com/image.png	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Overlay Color	Allows you to customize the color applied to the background overlay behind an app push.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Background Color	Allows you to set the background color. Add a solid color or use a gradient option to define a two-colored gradient effect.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Sticky Notification	A notification that stays visible until the user clicks button. It cannot be removed by swiping or using the Clear All option in the notification tray.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Sound	Define the tone played when a notification arrives on the device. You can choose between the default device sound or a custom sound. Here are the requirements for setting a custom sound: Android Versions Below 8: Enter the sound file name in your app bundle. Supported formats are .mp3, .ogg, and .wav. Android Versions 8 and Above: Enter the name of the notification channel ID. For setup instructions, refer to the notification channel documentation. iOS: Enter the sound file name included in your app bundle. Supported formats are .aiff, .wav, and .caf. 📘 The sound file name must be in your app bundle. If it is missing, the device will play the default sound.	Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
Carousel Type	This option allows you to select between Manual and Automatic carousel transitions. In Automatic, set the timer for image transitions between 2 and 10 seconds. 📘 Ensure the important part of the image is not in the lower portion. Users can add up to five images with a 2:1 aspect ratio and a maximum file size of 40KB.	Carousel (E2E)
Text/Emoji	Allows you to add words or emojis as rating options.	Rating
Rating Scale	Allows you to select the number of rating options to provide between two, three, or five.	Rating
Timer Settings	Timer date and time: Set the exact date and time when the timer will end. Message after timer ends:Enter the message that will display after the timer has finished. Add URL: Provide a URL for an audio clip that will play with the timer.	Timer
Progress Bar Settings	End date & time: Select when the progress bar reaches completion. Maximum and minimum time allowed: Set the timer duration between one hour and 24 hours. Message after the timer ends: Specify the message that will replace the timer text once the progress bar is completed.Local time display: Timer will automatically adjust to the user’s local time zone.	Progress Bar

Toggle on Add-on options to enable custom key value and collapse notifications.

Collapse Notification

This feature is used by FCM (Firebase Cloud Messaging) and APNS (Apple Push Notification Service) to update older notifications that have already been delivered. When multiple notifications share the same collapse key, only the most recent one will appear in the user's notification tray.
For example, if you send a series of cricket match score updates, you can set score_updates as the collapse key. This ensures that only the latest score update is visible in the user's notification tray.

Custom Key-Value Pairs

In this section, you can define custom key-value pairs specific to the operating system. These pairs trigger actions within the app when a user interacts with a notification, enabling personalized experiences.
For example, a shopping app can use a key-value pair like Key: category and Value: shoes to direct users to the shoes section when they click a notification about a shoe sale.

📘
Note

At least one operating system must be selected.

You can add up to 49 key-value pairs

Send Test Notification

Select the Send Test Notification option to preview your app push before sending it to users. You can send a test push notification to users using either the push token ID or the primary key.

Refer to the table below for details on the sections under Send Test Notification.

Field Name	Description
Test with Primary Key	Send the notification to a user identified by their primary key. This method helps test how the notification appears for that specific user.
Test with Push Token	Obtain a push token from your development support team to test notifications on a specific device. This allows you to verify delivery directly on the device.

📘
Note
Test notifications are excluded from campaign statistics.

7. Define the campaign's delivery time and date under the Schedule section.

Schedule

You can create and preview your App Push campaign and then schedule your campaign.

Refer to the table below for details on the sections under Schedule campaign.

Option	Description
Frequency cap	Turn on the frequency cap to limit the app push notifications a specific user can receive. Refer to frequency capping to learn more about the setting.
When to send	Select the options for when you want your app push campaign to be sent. Send now: Immediately send the app push campaign to users. Send Later: Schedule the app push campaign to be sent at a specified date and time. Optimise with Raman: Use our AI engine Raman to optimize the send time based on user engagement metrics.
Time to Live (TTL)	TTL determines how long FCM will store and try to deliver your notification. Specific Date and Time: Set TTL with a specific date and time up to 28 days in the future. Immediate Delivery: Set TTL to zero seconds for immediate delivery. FCM will not reattempt notifications. Provide a campaign cut-off time for this option.
Schedule and deliver notifications locally on mobile devices	Select this option to schedule push notifications directly on users' devices. When enabled, it ensures notifications are sent to almost 100% of your active users. Active users are those who come online from the time an app push campaign is scheduled until it is set to display on their device. Notifications can be delivered through FCM and Push Amplification if the user comes online during the scheduled period. Points to remember: This options is only avilable when you select Send later option.. Schedule your campaign 24 hours before using this feature. When local notifications are stored on a user's device, they cannot be recalled if the campaign is suspended.
App Inbox	Send a copy of the push notification to the App Inbox. This ensures that users who miss a notification can access it later in the notification section of the app. Message Category: Choose a category for the notification to help users organize and find messages easily. Message Expiry Time: Set an expiry time for the message in the App Inbox, after which it will no longer be accessible.

📘
Important
Running two consecutive campaigns within 30 minutes, the time frame could bypass the frequency cap check due to data synchronization delay.
For example, if you schedule one app push at 12:00 pm and another at 12:30 pm with a frequency cap limiting users to one app push per day. In this case, the second push notification may not reach users due to the frequency cap settings.

Click the Preview option to save your campaign and preview the app push. Once you have checked the details and appearance of your entire app push, click Save & Publish to publish it.

Create App Push

📘
Prerequisites

Steps to Create App Push

Setup