Widget and In-App Messages

Pop-up and In-App Message Presentation Behavior

All push notifications in Netmera work automatically—no additional coding is required. However, you can customize pop-up presentations and listen to push callbacks.

By default, when a popup notification or in-app message is received:

• If the app is in the foreground, the SDK displays pop-up notifications and in-app messages immediately.

• If the app is in the background, the SDK shows them when the app returns to the foreground.

Enable / Disable Immediate Presentations

To prevent immediate pop-up presentation (e.g., during video playback, gaming, or checkout), use:

1. Enable popup and widget push:

Netmera.setPopupPresentationEnabled(true)

1. Disable popup and widget push:

Netmera.setPopupPresentationEnabled(false)

1. Enable banner push:

Netmera.setInAppMessagePresentationEnabled(true)

1. Disable banner push:

Netmera.setInAppMessagePresentationEnabled(false)

Receiving Popups and In-App Messages in the Background

To receive popups or in-app messages when the application is in the background, you need to enable Remote Notifications under Background Modes in Capabilities.

Configure In-App Presentation Animations

You can configure how pop-up and banner in-app messages are presented by defining animation settings in Netmera-Config.plist.

Supported animation types are:

• slide_from_bottom (default)

• slide_from_top

• slide_from_right

• slide_from_left

To define different animations for pop-ups and banners, add the following configuration to Netmera-Config.plist:

Netmera-Config.plist

<key>in_app_animation_settings</key>
<dict>
    <key>popup_animation_type</key>
    <string>slide_from_top</string>
    <key>banner_animation_type</key>
    <string>slide_from_left</string>
</dict>

The configuration appears in Netmera-Config.plist as shown below:

In this example, pop-ups are displayed with the slide_from_top animation, while banners are displayed with the slide_from_left animation.

Disable In-App Presentation Animations

If you do not want to use presentation animations, set the animation value to none in Netmera-Config.plist.

Netmera-Config.plist

<key>in_app_animation_settings</key>
<dict>
    <key>popup_animation_type</key>
    <string>none</string>
    <key>banner_animation_type</key>
    <string>none</string>
</dict>

In this example, both pop-up and banner in-app messages are displayed without presentation animations.

Devices in Low Battery Mode

Devices cannot receive popups or in-app messages while the application is closed or killed if the device is in low battery mode, as this mode disables background application refresh.