Login

Learning & Support

Documentation

Sending Push Notifications

Twixl Support Team Updated: - Created :

    A notification is a great way to let the users know you have new content available.

    1. To start

    Before you can start sending push notifications, make sure the required push notification information has been added for your app in the Distribution Platform.

    Check out the following KB-articles for help on how to setup your app for Push Notifications:

    IMPORTANT NOTE:

    If you activate push notifications for an existing App Store app, you'll need to submit an update of the app.

    2. Testing

    In order to send push notifications, you need to register some test devices (phones, tablets) first. The procedure to register a test device is explained below. The test-functionality is only available in develop builds of your app.

    In order to allow you to test push notifications before you submit your app in the App Stores, select "Device info" from the gear-menu icon in the top right corner.

    NOTE:

    The "Register As Test Device" menu is not available in App Store builds.

    At the bottom of the popup window, tap Register As Test Device to register your device as a test device.

    Thank you!

    TIP FOR ARTICLE-BASED APPS WITH A HAMBURGER MENU ACTIVATED:

    If you've activated the Hamburger Menu in your app, you can find the Gear Menu in the bottom right corner of that Hamburger Menu:

    3. Sending Push Notifications

    Sending Push Notifications is done from within your app menu on the Twixl Platform.
    You have the choice between Plain and Rich Push Notifications. Rich Push Notifications can include an optional Title, Description and even an Image.

    App Menu

    3.1. Available options

    When you want to send Push Notifications, you have a few options available. Let's explain them here:

    1. Type: Plain or Rich Push Notifications
    2. Title: Your Rich Push Notifications can include a Title
    3. Message or Description: Of course you want to include a Message in your Plain Push Notification. This Message can include 140 characters. The Description has no limitations in terms of the number of characters.
    4. Image: Your Rich Push Notification can include an optional Image.
    5. Link: You can attach a tp-collection url scheme. This way, when readers tap on the Push Notification, they will be redirected to the right Collection or Content Item. For more info, see Custom URL Schemes for article-based apps.
    6. Send at: This way, a Push Notification can be sent out at a specified time in the future.
    7. Bundle Identifier: Informs you about the targeted app. See the following KB-article for more info: iOS: Setup Key based authentication for Apple Push Notifications (>8.0)
    8. Which Devices: You can target specific segments of devices, i.e.:  
      • All devices: Will send the Push Notification to all registered devices.
      • All iOS devices: Will send the Push Notification to all registered iOS devices.
      • All Android devices: Will send the Push Notification to all registered Android devices.
      • Specific test devices: Here you can select specific Test Devices as a target for your Push Notification. Fore more info, see Testing

     

    3.2. Support Matrix Plain vs. Rich Push Notifications

    WARNING ABOUT RICH PUSH NOTIFICATIONS:

    Rich Push Notifications requires a v12+ of your app!

    What? Supported in Rich Push Notifications Supported in Plain Push Notifications
    Title yes
    no
    Description yes
    no
    Message no
    yes
    Image yes
    no
    Link yes
    yes
    Send At yes
    yes
    Bundle Identifier yes
    yes
    Send to yes
    yes

    NOTE:

    You will only be able to start sending notifications, when your app has been installed and opened on at least 1 device. Also note that you can only send 1 push notification per 24 hours to a Newsstand app in the App Store. Other apps do not have this limitation.

    Was this article helpful?

    1 out of 2 found this helpful