Push Campaigns Overview

📢 Push Campaigns: Module Overview

Summary:
The Push Campaigns module allows you to create targeted push notifications for app users based on app-user data and campaign rules. It helps you plan, test, and manage automated push messaging from your App dashboard.

Overview

The Push Campaigns module is part of the App Centre in your App dashboard. It is designed to help you send more relevant push notifications to your app users by using stored app-user data and campaign rules.

Instead of sending the same message to everyone, Push Campaigns allows you to build campaigns that target specific types of users. For example, you may want to send a welcome push to a new user, a reminder to a lapsed user, or a message only to users who meet certain criteria.

The module gives you the tools to:

• create push campaigns

• define the rules for who should receive them

• decide how often they can be sent

• preview campaign behaviour before relying on live automation

• monitor campaign activity and performance

This makes Push Campaigns a useful tool for lifecycle messaging, re-engagement, reminders, promotions, and other app-based communications.

What Push Campaigns does

Push Campaigns allows you to build rule-based push notifications.

Each campaign includes:

• an internal campaign name

• a status such as draft, active, or inactive

• a priority level

• one or more targeting rules

• push sending settings

• the push title and message

• an optional image

• a destination URL

• internal notes for your team

The rules determine which app users qualify for the campaign. If a user matches the rules, the campaign may be allowed to queue a push for that user, depending on the campaign settings.

This gives you much more control than a general broadcast-style push notification.

Examples of how the module can be used

The Push Campaigns module can be used for a range of common app scenarios, such as:

• sending a welcome push to a new app user

• sending a reminder after a period of inactivity

• sending a message to users with a valid push subscription

• targeting users based on device type or stored identifiers

• sending a one-time message when a user first qualifies for a campaign

• creating fallback campaigns for broader audiences if no other campaign applies

Because campaigns are rule-based, they can be made as broad or as targeted as needed.

How the module is organised

The Push Campaigns module contains four main screens:

Dashboard

This gives you a quick summary of campaign activity, including how many campaigns you have, how many are active, and how many pushes have been queued and sent.

Campaigns

This is where you view all campaigns, create new ones, edit existing ones, and open a campaign in the Preview Tool.

Preview Tool

This is where you test campaign logic against real app-user data. It helps you see whether a user matches a campaign and whether the push would actually be allowed into the queue.

Analytics

This provides more detailed reporting on push activity, including queue, sent, failed, and recent log information.

Together, these four screens provide a full campaign workflow from setup to testing to monitoring.

How campaign matching works

Each campaign contains one or more rules.

These rules are checked against stored app-user data, such as:

• when the user was first seen

• when the user was last seen

• whether they have a OneSignal subscriber ID

• whether they have a first-party ID

• device type

• email

• other stored fields

If the user meets the campaign rules, the campaign is considered a match.

If more than one campaign could match the same user, priority is used to determine which campaign should be considered first.

This is why it is important to set campaign priorities carefully.

Why the Preview Tool is so important

One of the most useful parts of the Push Campaigns module is the Preview Tool.

This screen allows you to test campaign behaviour before relying on live automation. It shows you:

• the app-user data being checked

• whether the campaign matched

• whether the push would be allowed or blocked

• whether the user has already received that campaign before

This helps prevent common mistakes such as:

• creating rules that are too broad

• creating rules that are too narrow

• forgetting that a user has already been sent the campaign

• overlooking cooldown or send limits

• assuming a user is push-ready when they are not

For this reason, the Preview Tool should be used whenever a campaign is created or changed.

Why good campaign setup matters

A well-configured campaign helps you send timely and relevant messages without over-contacting your users.

A poorly configured campaign can result in:

• users not matching when they should

• users receiving messages too often

• overlapping campaigns competing with each other

• pushes being blocked by missing setup or limits

To avoid this, it is good practice to:

• keep campaign names clear

• use priorities sensibly

• start with simple rules

• limit repeat sends where appropriate

• use cooldowns when necessary

• always preview before relying on live behaviour

Recommended workflow

The best way to use the Push Campaigns module is:

1. decide what type of user you want to target

2. create the campaign and add clear rules

3. configure how and when the push should be sent

4. add the push content and destination URL

5. save the campaign

6. test it thoroughly in the Preview Tool

7. activate it if appropriate

8. monitor Dashboard and Analytics for live activity

This workflow helps reduce errors and improves campaign quality.

Best practice summary

To get the best from Push Campaigns:

• create campaigns with a clear purpose

• keep rules as simple as possible at first

• use priority carefully when campaigns could overlap

• preview every campaign before relying on automatic sending

• use cooldowns and max send limits to avoid over-messaging

• monitor performance regularly in Dashboard and Analytics

• record useful notes so your team understands each campaign later

In summary

The Push Campaigns module gives you a structured way to create and manage automated push notifications for your app users.

It is designed to help you move beyond one-size-fits-all messaging by allowing you to target users based on their app-user data and behaviour. With campaign rules, preview tools, and reporting screens, the module gives you greater control over who receives a push, when they receive it, and how that campaign performs over time.

Used carefully, Push Campaigns can become a valuable part of your app engagement strategy.