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. [block:image] { "images": [ { "image": [ "https://files.readme.io/776986eb4a407a10a028aef7c5cb83ab95173ce27dc7fa1167fff69825c0f2c5-CreateAppPushTemp-ezgif.com-crop.gif", "", "Create App Push Template" ], "align": "center", "sizing": "80% ", "border": true, "caption": "Navigate to App Push Template" } ] } [/block] # Available Features To filter, use, or edit the existing templates, refer to the table for the available options. | Option | Description | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------- | | **Select Category** | Choose the relevant category for your template. | | **Select Platform** | Pick the specific platform (for example, **Android**, **iOS**) where the template will be used. | | **View**

| Preview the template before using it. | | **Edit**

| Modify the existing template. | | **Use**

| Use the template directly in your campaign. | | **Search**

| 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](doc:app-push-template-1#setup)** and **[Content](doc:app-push-template-1#content)**. [block:image] { "images": [ { "image": [ "https://files.readme.io/c78c712e5d264bd805f63e2ab00fd9bee1124c75fc5bdee872c8c6869962a5c0-CreateNewAPNTemp.png", "", "Create a New App Push Template" ], "align": "center", "sizing": "80% ", "border": true, "caption": "Create a New App Push Template" } ] } [/block] ## Setup Refer to the table below for details on the sections under **Setup**. [block:parameters] { "data": { "h-0": "Sections", "h-1": "Description", "0-0": "**Template Name**", "0-1": "Enter a unique name for this template.", "1-0": "**Select OS Type**", "1-1": "Select the platform you are creating the template (**Android**, **iOS** or **both**).", "2-0": "**Add tags**", "2-1": "Add relevant tags to organize and categorize your template. You can add only one tag per template.", "3-0": "**Personalize based on customer attributes**", "3-1": "Tailor your template using user details like name, location, and preferences to create relevant and engaging messages. \n**Note**: You can select all contact master or specific data table as source of attributes for personalization." }, "cols": 2, "rows": 4, "align": [ "left", "left" ] } [/block] 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. | 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. | | **Multi-icon** | | | | **Quick reply** | | | > 📘 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. [block:image] { "images": [ { "image": [ "https://files.readme.io/4dc6310586be8ac952f7215ec63b42c76f2816ec9474ba2d1c2f292e8986fd23-CustomizeAPNTemplate-ezgif.com-crop.gif", "", "Customize your App Push Template" ], "align": "center", "sizing": "80% ", "border": true, "caption": "Customize your App Push Template" } ] } [/block] Toggle on **Enable APN Interactions** to include rich media elements, action buttons, sound, deep links, and more. [block:image] { "images": [ { "image": [ "https://files.readme.io/daf0d9b5832229e356e9b3b6703b4eb06c376eb38d2adaf8976b2cedfa88b4b2-EnableAPNInteractions.png", "", "Enable APN Interactions to include rich media, sound and so on" ], "align": "center", "sizing": "50% ", "border": true, "caption": "Enable APN Interactions to include rich media, sound, and so on" } ] } [/block] Refer to the table below to learn about all the options available to customize your app push template. [block:parameters] { "data": { "h-0": "Options", "h-1": "Descriptions", "h-2": "Available for", "0-0": "**Title**", "0-1": "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. \n📘 Text formatting is supported only on Android SDK.", "0-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "1-0": "**Description**", "1-1": "Allows you to add the message content of your push notification.", "1-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "2-0": "**Landing page**", "2-1": "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.

", "2-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "3-0": "**Add Image**", "3-1": "Allows you to insert an image. \n**Upload File**: Drag and drop the file or select it from your computer. \n**Media URL**: Allows you to add an image URL. \n📘 PNG and JPEG file formats are supported. \nURL must include an HTTPS protocol ending with a supported file format. Example: ", "3-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "4-0": "**Overlay Color**", "4-1": "Allows you to customize the color applied to the background overlay behind an app push.", "4-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "5-0": "**Background Color**", "5-1": "Allows you to set the background color. Add a solid color or use a gradient option to define a two-colored gradient effect.", "5-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "6-0": "**Sticky Notification**", "6-1": "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. ", "6-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "7-0": "**Sound**", "7-1": "Define the tone played when a notification arrives on the device. You can choose between the default device sound or a custom sound. \n \nHere 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](https://developer.netcorecloud.com/docs/android-setup-notification-channel).
**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.", "7-2": "Overlay on image, Timer, Carousel (E2E), Edge to edge, Rating, Small image, Progress Bar", "8-0": "**Carousel Type**", "8-1": "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. \n📘 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.", "8-2": "Carousel (E2E)", "9-0": "**Text/Emoji**", "9-1": "Allows you to add words or emojis as rating options.", "9-2": "Rating", "10-0": "**Rating Scale**", "10-1": "Allows you to select the number of rating options to provide between two, three, or five.", "10-2": "Rating", "11-0": "**Timer Settings**", "11-1": "

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

", "11-2": "Timer", "12-0": "**Progress Bar Settings**", "12-1": "

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

", "12-2": "Progress Bar" }, "cols": 3, "rows": 13, "align": [ "left", "left", "left" ] } [/block] Toggle on **Add-on options** to enable custom key value and collapse notifications. [block:image] { "images": [ { "image": [ "https://files.readme.io/486042ea708fbab475603257f5ed717343575e034f12d99c03ee22861bbf1950-AddOnOptions.png", "", "Enable custom key value and collapse notifications" ], "align": "center", "sizing": "80% ", "border": true, "caption": "Enable custom key value and collapse notifications" } ] } [/block] - **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 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](https://cedocs.netcorecloud.com/docs/create-app-push).
## Overview CE enables you to create templates which can be used for future campaigns. [block:image] { "images": [ { "image": [ "https://files.readme.io/1be4150-AppPushTemplates.png", "", "View App Push Templates" ], "align": "center", "sizing": "80% ", "border": true, "caption": "View App Push Templates" } ] } [/block] ## Setup To create a new template, click on the CREATE button which will bring you to the setup section. [block:image] { "images": [ { "image": [ "https://files.readme.io/74008de-APN_temp_2.png", "APN temp 2.png", 1366 ], "align": "center", "sizing": "80% ", "border": true, "caption": "Create a new App Push template" } ] } [/block] - **Template Name** - Give a unique name to your APN template - **Select OS type** - Select the platform for which the template is to be created. i.e. Android, iOS or both - **Mark category** - Assign or add a new category to the template. It is optional. - **Personalize based on custom attributes** - You can use attributes present on your panel to be used for personalization of your template. Click on 'Save & Next' to go to the Content section. ## Content After the basic setup is done, 'Content' is the section where all the action happens! [block:image] { "images": [ { "image": [ "https://files.readme.io/0084b29-apn_temp_3.png", "apn temp 3.png", 1366 ], "align": "center", "sizing": "80% ", "border": true, "caption": "Create Content for App Push template." } ] } [/block] - **Title** - Add the title of your push notification. You can also add formatting such as bold, italics, underline, text color, text background color, subscript, and superscript here. However, text formatting is supported only on Android SDK. - **Description** - Add the message content of your push notification. You can also add formatting such as bold, italics, underline, text color, text background color, subscript, and superscript here. However, text formatting is supported only on Android SDK. - **Landing page** - You can choose the app homepage, deep link, or URL as a landing page for your push notification. This value is used for redirection when the user clicks anywhere on the notification. **Enable APN interactions** Here you can add and customize amazing interactions to your android or iOS notification content. These options are mentioned below: - **Subtitle** - You can add a subtitle to your notification. You can also add formatting such as bold, italics, underline, text color, text background color, subscript, and superscript here. However, text formatting is supported only on Android SDK. - **Rich media** - You can add 4 types of rich media to your notification: - **Image** - An image can be added using a URL or directly uploading an image from your system for both Android and iOS. - **Carousel** - A slideshow of multiple images. For each slice in a carousel, you can add an image, title, CTA, and a deep link URL. - **Audio, Video & GIF** -To add either of these three rich media, only the URL needs to be provided. _Please note: Video is not available for Android._ > 📘 Note > > ** Supported file formats:** > > - Image supported formats - .jpeg, .jpg and .png with max 40KB size. Image should be in 2:1 aspect ratio > - Carousel supported formats - Maximum of 5 slide images of format .jpeg, .jpg and .png with max 40KB size for carousel slice images. The landscape carousel image should be in 2:1 aspect ratio and the portrait carousel should be in 1:1 aspect ratio > - If you wish to use larger size images, you can provide the self-hosted image URL. > - Audio supported formats - .mp3, .aiff, and .wav with max 3MB size. > - Video supported formats - m4v, .mp4, and .mov with max 3MB size and 2:1 aspect ratio > - GIF supported formats - .gif with max 3MB size and 2:1 aspect ratio > > **Character Limits:** > > - Max 50 characters for Title and 1000 characters for message. > - Max 30 characters for Title and 50 characters for message for each carousel image slide. > - CTA URL - Maximum character limit is 1000. - **Enable sticky notification** - Enabling this feature would pin your notification in the notification tray of the device. Such notification will not be cleared by swiping it out or the 'clear all notifications' button. It can only be dismissed by clicking on provided x icon. - **Background color** - You can add background color to your notification as well as customize the degree of opacity of the color. You have the option to add a solid color or use a gradient option where you can define a two-colored gradient effect with a customizable angle setting. _Please note: Background color support is available only from Netcore Android Base SDK 3.2.30 & Android Push SDK 3.2.16 onwards_ . - **Action button** A maximum of 3 Action buttons can be added for push notification which consists of - Action button title - Call-to-action - Open within app, Open in browser, Close, Copy text, Remind me later. - URL or deeplink needs to be provided when open within app or open in browser option is selected above - For Copy text action - you can specify the text to be copied. This text can also be personalized - For remind me later action- you can specify reminder time. The notification will be dismissed and show again once this reminder time is reached when user clicks on this action button. **The content Preview is available on the right side of the screen.** - **Sound** Here you can define the message tone played when a notification gets delivered to the device. You have the option to play the default device sound or a custom sound. Below are the specifications for Sound file name that you need to enter for the custom sound field. - **Android versions below version 8 :** - Specify the name of the sound file which is included in your app bundle. Supported file formats are .mp3, .ogg, .wav. - **Android versions 8 & above ** - Specify the name of the notification channel id. Refer to SDK integration documentation to know how to setup notification channel - **iOS** - Specify the name of the sound file which is included in your app bundle. Supported file formats are .aiff, .wav, or .caf. _Please note: Sound file name that you are entering must be present in the app bundle. If not present, the default sound as per the user's device will be played._ Click on **'Save template'** button to save the template and close