Skip to main content
To send promotional push notifications, first use the app SDK to record whether each user has opted in. Use that record to filter recipients when you set up the campaign. When a user changes their preference on the opt-out page or in your app’s notification settings, use the app SDK to save the new consent status in Notifly. The SDK examples below show how to save a user’s opt-in.
iOS

2. Add a default audience condition (optional)

In Settings > Product & Project > Default Campaign User Conditions, add a condition for the app push channel. The screenshot uses mkt_push_agreed as an example. Select the key your service uses to store marketing consent.
Default audience condition for app push

3. Register a marketing opt-out page

To use the built-in opt-out button in a single-language notification, register the Marketing Unsubscribe Page in Settings > Channel Settings > Push Notification (App). Enter the URL or deep link for the page that should open when a user taps the opt-out button. To open your app’s notification settings, enter a deep link the app can handle. For promotional app notifications in South Korea, check the opt-out requirements for your flow. KISA’s guidance covers avoiding steps such as requiring the user to sign in to opt out. See the KISA anti-spam guide (Korean).
Marketing opt-out page settings
The opt-out button is available starting with these SDK versions:
  • iOS SDK: 2.6.0 or later
  • Android SDK: 1.21.0 or later
  • React Native SDK: 4.2.0 or later
  • Flutter SDK: 2.3.0 or later
The opt-out button is hidden in app versions that use an older SDK.

Examples by platform

Examples of the app push opt-out button on Android and iOS

4. Configure a promotional app push campaign

Under Delivery Target > User Group Settings, select Filter by conditions. If you saved a marketing consent filter for app push, turn on Default User Condition. Otherwise, add a condition that includes only users who have opted in. The default condition does not apply when you select Send to all users or use a CSV audience. If you use a CSV, include only recipients who have opted in.
Default User Condition enabled in the campaign audience settings
For a single-language message, turn on Is Advertising Message in the message editor.
Advertising message setting for app push
If you registered a marketing opt-out page in section 3, Notifly includes the information the app needs to show the opt-out button. For a localized message, follow the promotional message instructions to add the required advertising disclosures and opt-out instructions to each language version.
Before sending to your audience, run an internal test campaign. For a scheduled or event-triggered campaign, keep the consent filter on. In Delivery Target > User Group Settings, turn on Test Mode.In Test Recipients List, enter the external user IDs of internal testers who have opted in. Before you run the campaign, check that the list contains at least one tester and includes only those testers.
  • Single-language messages: Check that the opt-out button appears in the test notification. Tap it to check that it opens the page you registered.
  • Localized messages: Check that each language version shows the required advertising disclosures and that the opt-out instructions work.

FAQ

The URL only opens the opt-out page. Save the user’s new consent status in Notifly when they opt out. Then filter the campaign to include only users who have opted in.