• iOS
  • Android
  • Windows
  • Cordova
  • Web
  • Unity
  • Adobe Air
  • Dashboard
  • API
  • Guides
  • FAQ
  • Dashboard > Push

    Message edition

    Message edition

    The message editor lets you create notifications in several languages, A/B test them and see them on your device before you send them your users.

    Language selection

    Language selection

    You can add as many localized versions of your message as you want by clicking on "+". Batch will automatically send the message in the right language to every targeted users.

    If you don't have a message in the language of a user, Batch will deliver the message in the default language of your app.
    You can check the default language of your app in ⚙ Settings → General.

    Title and message body

    Push editor

    Title (optional)

    You can set a custom title that will appear on iOS and on Android. On iOS, the title is displayed on devices running iOS 10 (and higher), on the Apple Watch or in the notification center (since iOS 8).

    Here is how the title looks on iOS and Android:

    Title

    Message body

    This is the most important part of your push notification, make sure your message is not too long and to write it accordingly to your targeted audience.

    Emoji emoticons

    You can add emoji emoticons to the title or the body of your iOS, Android, Windows or web push notifications.

    Adding emojis

    If you want to insert an emoji in your message you can:

    • Windows: Simply press the Windows key + the period button to display Windows's emoji keyboard on Windows 10. In case you are using an older version of Windows, you can copy-paste an emoji from emojipedia: iOS / Android / Windows.
    • Mac: Press CTRL + CMD + Space to display the emoji keyboard and pick an emoji.

    On Android, emojis may look different on your users devices:
    - Custom emojis: Some device manufacturers use a set of custom emojis. See how they look here: Samsung / LG.
    - Android 4.4: On Android versions before 4.4, emoji emoticons might not be displayed correctly.

    A/B testing

    The A/B testing feature allows you to test two different messages in the same campaign. A/B testing is key to sending the most effective message and vastly improving your open and re-engagement rates. You can easily A/B test your messages with one click on the "Start A/B testing" button.

    AB testing

    Once your campaign is live, you can compare the performance of each variant and disable the one that performs poorly.

    Mobile Landing

    Mobile Landings allow you to display an in-app message when users open your notification. This is great to manage scenarios that require a specific action from your users (app review requests, update reminders, etc) or to have all their attention (new feature announcement, exclusive offers, etc).

    Adding a Mobile Landing

    You can easily add a Mobile Landing to your campaign by switching on the "Mobile Landing" option:

    Mobile Landings Editor

    Managing themes

    In order to add a Mobile Landing to your push campaign, you need to create a theme first from ⚙️️ Settings → Themes:

    You can choose between two formats: Fullscreen or banner

    Formats

    Mobile Landings are fully customisable: Background color, image, header, title, number of CTAs, etc.

    Mobile Landings Theme Editor

    You can also create and save several themes for the same app from ⚙️ Settings → Themes.

    Mobile Themes List

    Sending a test

    Test Push

    You can click on the "Send a test" button to see how your message looks on your device and test your deeplink. If the "Send a test" button is greyed out, you need to add your device token. Here is how to proceed:

    1. Locate your Advertising ID
      On iOS, install the The Identifiers app on your device and copy the RAW Advertising Identifier.
      On Android, go to Settings → Google → Ads.
    2. Use the Debug tool
      Go to ⚙ Settings → Debug and paste your Advertising ID to find your device token.
    3. Save your device token
      Go to ⚙ Settings → Push Settings and add your push token to the list.

    Make sure you update your device token each time you reinstall your app.

    Advanced settings

    PushAdvanced

    Deeplink URL

    Deeplinks allow you to direct users to a specific place in your app. Batch Push campaigns can accept this link scheme to direct users to a particular area within your app upon opening the push notification (i.e. The news you mention in your notification, etc).

    Please note that the Deeplink URL must be a link based on a URL scheme that you specify within your app.

    On Android, if you decide to use an external URL in your campaign, Batch won't show the open rate.

    Attachements

    Icon

    On Android, you can upload a specific icon for the notifications sent by a push campaign. Batch requires a square image, PNG or JPG, with a minimum width of 192px.

    Image

    Batch lets you send large-format notifications with a large image attachment. We require a landscape image, PNG or JPG, with a minimum width and height of 300px.

    Images can be displayed on:
    - iOS 10+: Make sure your iOS app supports rich notifications.
    - Android 4.1+
    - Web: Chrome 56+ on Windows/Android.

    Here is how these notifications look on iOS and Android:

    Custom Image

    Audio

    iOS 10+ only. The file must be an mp3 file with a valid mime type, hosted on an HTTPS server. The OS will automatically download the mp3 file and drop the download if it takes more than 30 seconds.

    Push audio

    Video / GIF

    iOS 10+ only. You can add a video attachement using an mp4 file, with a valid mime type and hosted on an HTTPS server. The video will be downloaded automatically on your users' devices and iOS will drop the download if it takes more than 30 seconds.

    You can also attach a GIF file to your push notification. The GIF file must have a valid mime type and be hosted on an HTTPS server.

    Here is how a video attachement looks on iOS 10:

    Push video

    Custom payload

    Only available on paid plans. An optional JSON string that can contain additional parameters that your application can handle when receiving push notifications if configured to do so. You can use it to customize your iOS notifications (badge, custom notification sound, silent push).

    The root of the JSON must be an Object and cannot have the reserved key com.batch. You can use {BATCH:TITLE}, {BATCH:BODY} and {BATCH:DEEPLINK} variables. They will be replaced.

    Please note that custom payloads are not supported by the Unity and Air plugins.
    You will have to implement them using native components.

    GCM /APNS Priority

    Defines the priority of your message on iOS (APNS) and Android (GCM). The default value is high on iOS and Android.

    On Android, you can use the high priority if you have a messaging/voip app and if you notice delivery issues due to native (Doze) or constructor related (Samsung Smart Manager, etc) energy saving features.

    High priority Android notifications can drain your user's battery faster since they 'wake up' the device and open a network connection. Switch to Normal priority if your notification is not time-sentitive.

    GCM Collapse key

    Defines how notifications are managed when an offline device goes online. If enabled, the device will only show the most recent notification. If disabled, it will show all the notifications received when the device was offline.

    You should disable the collapse key if all your notifications matter (E.g. messages, etc). You can use up to 3 different collapse keys if you want users to get only one notification of each kind when coming online (E.g. marketing message, alert, etc).

    Review

    Wizard Review

    While the review page is self-explanatory, it's not to be dismissed. Look over and verify all the details of the campaign before saving all of your work or activating the campaign. If you need more time to edit your campaign, you can save it as a draft.

    After saving your campaign as a draft, you can duplicate it easily by clicking on the "Replicate" button. The campaign duplication also works between iOS and Android apps.