User GuideDeveloper GuideAPI GuideTechnology PartnersNetcore Cloud AI: Co-Marketer
User Guide
BlogLogin

App Push Templates

Learn to create an App push template using the Netcore CE dashboard.

Suggest Edits

The App Push Template section contains all the templates you have previously created for your campaigns. You can easily browse these templates or create new, customized ones to suit your specific campaign needs. To get started, log in to the Netcore CE dashboard and navigate to Content > App Push to create or use existing templates.

Create App Push Template

Navigate to App Push Template

Available Features

To filter, use, or edit the existing templates, refer to the table for the available options.

OptionDescription
Select CategoryThis option allows you to choose the relevant category for your template.
Select PlatformThis option allows you to pick the specific platform (for example, Android, iOS) where the template will be used.
ViewThis option allows you to preview the template before using it.
EditThis option allows you to modify the existing template.
UseThis option allows you to use the template directly in your campaign.
SearchThis option allows you to search for existing templates.

Create New Template

Click Create New in the top right corner to open the Create a New App Push Template screen. There are two tabs: Setup and Content.

Create a New App Push Template

Create a New App Push Template

Setup

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

SectionsDescription
Template NameEnter a unique name for this template.
Select OS TypeSelect the platform you are creating the template (Android, iOS or both).
Add tagsAdd relevant tags to organize and categorize your template. You can add only one tag per template.
Personalize based on customer attributesTailor your template using user details like name, location, and preferences to create relevant and engaging messages.
Note: You can select all contact master or specific data table as source of attributes for personalization.

Fill in all the required sections and proceed.

Content

After the basic setup and adding the template details, Content is the section where you can create your template. You can Create new layout 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.

LayoutDescriptionUse Case
Overlay on ImageThis layout allows you to display a message over an image.Promote a new product with a captivating image and a call to action.
TimerThis 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 EdgeThis layout allows you to expand the notification to cover the entire width of the screen.Highlight a major update or announcement with maximum visibility.
RatingThis layout allows you to include a rating option for quick feedback.Ask users to rate their experience after completing a purchase.
Small ImageThis layout allows you to show a small image alongside the notification text.Share a product image with a quick update or offer.
Progress BarThis 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 28 days and minimum 1 hour. 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.

Customize your App Push Template

Customize your App Push Template

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

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

OptionsDescriptionsAvailable for
TitleAllows 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.
Note: Text formatting is supported only on Android SDK.		Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar
DescriptionAllows 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 pageAllows 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 ImageAllows 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.
Note: 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 ColorAllows 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 ColorAllows 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 NotificationA 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
SoundDefine 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 TypeThis option allows you to select between Manual and Automatic carousel transitions. In Automatic, set the timer for image transitions between 2 and 10 seconds.
Note: 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/EmojiAllows you to add words or emojis as rating options.Rating
Rating ScaleAllows 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 or select a fixed duration. Maximum and minimum time allowed: Set the timer duration between one hour and 28 days
  • 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 28 days.
  • 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
    Customized Collapsed State (ANDROID ONLY)Allows you to define how a push notification appears in its minimized form on Android devices. Marketers can upload a separate image or reuse the rich media asset with tailored layout controls when enabled.
    Availability
  • Platform: Android only
  • SDK Support: SDK v3.5.8 onwards(Android Push SDK)
  • Dependent on: Rich media(image or carousel) being added.
  • Suggested aspect ratio: 4:1
    		• Overlay on Image, Timer, Carousel(E2E), Edge to edge

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

    • Collapse Notification

    This feature is used by Firebase Cloud Messaging (FCM)and Apple Push Notification Service (APNS) 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

    Once you have finished adding content to the template, you can either Save Template or directly Use in Campaign.

    To learn how to create an app push campaign step-by-step, check out this document.

    Updated about 2 months ago

    Next