Create App Push
Learn how to create an App Push using the Netcore CE dashboard.
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.
|
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.
- 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.
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:
| 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:
| 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 | |
Progress Bar Settings | 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.
|
Time to Live (TTL) | TTL determines how long FCM will store and try to deliver your notification.
|
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:
|
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.
|
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.
Updated 29 days ago