This document will cover the following topics:

  • Expectations for Mobile Recommendations

  • iOS SDK Documentation - Getting Started

  • Android SDK Documentation - Getting Started

  • Push Campaigns Notifications

Expectations for Mobile Recommendations



What can I get from Mobile Recommendations?

Users can deliver unique, personalized content to customers on mobile app

How do I track and identify users on my mobile app?

The Native Android and iOS SDK’s have the ability to identify and track users on your mobile app. All you need to do to track and identify users on your mobile app is to install our SDK’s

How do I deliver personalized in-app experiences to my customers?

To deliver personal in-app experiences to your customers, you can use the liquid user and event attributes. This way, every push notification will be unique to the user that receives the message and contextual to their relationship with your brand.

How do I get started with the iOS SDK? (native SDKs)


  • iOs 7 and Higher

  • Firebase Cloud Platform Account with Firebase Cloud Messaging enabled


  • Go to your Firebase Cloud Messaging (https://console.firebase.google.com/) and configure your GCM account to send iOS push notification.

    • You can do so by clicking on 'Get A Configuration File', followed by uploading your Apple Push Notification certificates and the app bundle id.

    • This process will generate a project id and a server key in your Google Developers account.

    • Note: You can use the same project in case you have already been using one for Android push notifications.

How do I get started with the Android SDK?

The Android SDK allows you to track:

  • User Activity

  • Identify Users

  • Render Personalized Messages


  • Google Play Services should be included. If not, follow the linked instructions

  • Firebase Cloud (FCM) Account with Firebase Cloud Messaging (FCM) enabled

FCM Upgrade

  • To upgrade GCM into FCM, import the GCM project into FCM by following the linked instructions

For the new FCM project, the corresponding application can be created directly in the Firebase.

  • Update the Gradle dependencies by following the linked instructions

NOTE - Make sure to follow the build.gradle of project level, the following must be added

Push Campaigns Notifications



How do I set up Personalized Push campaigns for my mobile customers?

The way we configure the push//recommendation merge tags is different

How do I set up Personalized Push campaigns for my mobile customers (With recommendation merge tags)

You can set up a push notification campaign from the ZMP message editor

NOTE - If you want to send out a push message to a particular group of users based on a shared activity, click on ‘Triggered’ and Push Notification

Once you’ve selected ‘Push’ as your channel of choice, we get down to entering the content of the campaigns.

Step by Step Process

1- Name your campaign

2- Select Launch Type

  • Broadcast at a specific time

  • Trigger on an activity or behavior

3 - Select Trigger

  • When a user….

    • Select event or behavior

      • Enters Segment

      • Exits Segment

Include - You can select the below options for user pools

  • Identified

  • All Visitors

  • Both

You can trigger messages when your customer does one of the following:

  1. Performs and activity like “sign-up” or “bought”

  2. Performs a behavior like “sign-up” followed by does not “complete profile”

  3. Exits or Enters a segment like enters a “loyal” segment or exits an “Active” segment

4 - Click Filter to set up By Segment and By User Properties:

By Segment:

  • This section is used to include or exclude users from receiving this triggered message based on the segment they belong to.

  • This is available only for segments that are enabled for continuous updates

By User Properties:

  • This section is used to target only users with certain properties

    • Properties

    • Operators

    • Value

  • User can Add in Additional criteria’s by selected the (plus) Add Another Criteria

  • Click Done once completed

  • Click X to remove the criteria that was added

5 - Compose Message

Fill out the following Fields:

  • Notification Title - The title of your Push Notification

  • Notification Text - The Text of your Push Notification

  • Platform - Select Android or iOS

Android Only Fields:

  • Launch Activity - Where will it redirect the user to on tapping the notification

  • Image URL - URL of the image which will be displayed along with the Notification

  • Android Icon - Large Icon with your company’s logo or brand identity

  • Notification Action - Actions that you can perform within the Notification

Example: ‘Remind me Later’, ‘Add to Calendar’, ‘Pause/Forward/Next’ button on Google Play

Android Notification Function

  • Action Name - the key/keyword with which images and icons are called into the push notification

  • Action Title - The title of the button (play, pause, etc)

  • Value - The Activity/Page to which the user is redirected to on click\

NOTE - Keep the number of characters in your Android notifications between 60-90

Screenshot specific to selecting Andriod

iOS Only Fields:

  • iOS View Controller - Where it redirects the user once they tap the notification

  • Default Button Category - Optional functionalities that customers can choose to engage within the notification. ZMP has a library of default button categories built into our SDK

  • Custom Button Category - Custom button that you can create and assign to the notification at run time

  • By Default there should be no more than 120 characters for your iOS notifications

Screenshot specific to selecting iOS

6 - Tags (optional)

Name your Tag

Enter in a name and value click “Add a Code”

7 - Sending the message

  • Send this message

    • Immediately

    • With a delay of - Enter in number and then select (Days/Hours)

    • Select Delivery Window - Messages will only reach your users within the hours of the day that you specify

  • The user will receive this message:

    • Every time the user qualifies (Only option for mark as transactional)

    • Or Not more than - (Select number of times)

      • Lifetime - to 90 days

8 - Click Activate or Creator can Save as Draft