Push notification invitations

Push notification is a form of targeting based on remote server logic and it depends on a non-Medallia notification server. It displays a notification on the device on behalf of mobile apps and is a common feature of modern apps. Push notifications engage users to provide feedback in the moment, even when the app is closed. Apps that have an established push notification service and that have integrated the Digital Mobile SDK can launch surveys from an on-device notification.

Tip: Targeting of these invitations is handled by the app's push notification server and not Digital.

Push notification for Mobile SDK.

Once an app pushes a notification, if it is accepted then the survey identified by its FormID launches directly. Apps respond to a push notification triggered survey using the handleNotification API. When a push notification is accepted on the device, handleNotification instantaneously launches the survey.

  • Digital Mobile SDK version must be above v2.19 for both Android and iOS.
  • Preserves the existing "one invite display per session" logic.
  • Supported on both iOS and Android.

App prerequisites, requirements, and behavior

This feature relies on the app using the operating system's push notification service. Apps need to comply with following prerequisites and requirements for this feature to work as expected.

Implementation

  • The enablement of receiving and transmitting notifications, including targeting, is done by the app developers.
  • The Digital survey itself is launched from the pushed notification by calling the handleNotification API.
  • A code snippet is created in the Digital Command Center to help developers properly call this API. See Notification Invitation Design options

SDK initialization

The SDK must be initialized for forms to be launched. See SDK integration documentation for more information.

Availability

This feature works even if the application is closed and not in the background. The application is responsible for determining where in the app the survey should be loaded.

  • If the application is not in the background, it is recommended to launch the app in its home screen.
  • If the application is in the background, it is recommended to launch the app in the screen, which is to displayed when the application is in the foreground.
  • Close / Submit / Selecting Back / X button form reverts back to the application screen displayed below the survey.

Notification Invitation Design options

When a survey form uses a push notification invitation, the following option is available.

Layer 1 1

  1. Code snippet : When a notification invite is selected, this code snippet is created which contains the necessary data to call the handleNotificationAPI.

Send the code snippet to your app developers when mapping which notification is to be attached to which SDK form. The snippet includes the form ID of each form. Multiple forms can be attached to a single notification.

Targeting

Similar to Code Triggers, when an invite uses push notification the built-in targeting options are not available and the Targeting tab looks like the following screenshot. Targeting of the push notification is completely controlled by the service your application uses.

Targeting.

Flow overview

  1. Create notification invite in the Command Center and copy the code snippet.
  2. Show push notification based on the app's push notification criteria.
  3. User opens the survey from the pushed notification.
  4. handleNotification API is called (the API opens relevant survey using FormID as provided in the code snippet).
  5. Survey will be displayed in the mobile app.