Login

Learning & Support

Documentation

Sending Push Notifications

Twixl Support Team Updated: - Created :

    A notification is a great way to let users/readers know when new content is available.

    1. To start

    Before you can start sending push notifications, make sure the required push notification configuration information has been added for your app on the platform.

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

    IMPORTANT NOTE:

    If you activate push notifications for an existing app, you'll need to create an updated build 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.

    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 test functionality is only available in development, ad hoc or Test Flight builds of your app. 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 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 Using custom URL Schemes in your app.
    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

    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.

    Was this article helpful?

    1 out of 2 found this helpful