Introduction to Mobile Messages

Carnival helps you engage your mobile app users with rich and creative messages.

Create Push Notifications or In-App Messages, and allow users to browse past messages in your In-App Message Stream.

Push Notifications In-App Messages In-App Message Stream

Sent to users’ mobile devices, even if your app isn’t open.

A push notification can be a simple message directing users to your app, or can drive to an in-app message when the push is tapped.

The most impactful way to engage your users while they are using your app.

In-App Messages are commonly displayed as a “roll-down” interface, and can be triggered at key moments, such as the user opening the app.

A list of historical cards, integrated directly in the app. This is a great way for users to look back over the messages that you have sent to them in the past.

Users can access the stream via the “Messages” icon which is integrated into the app, or tapping ‘View all Messages’ on an In-App Message.

Creating and Publishing Messages

Whether you want to publish just an In-App Message, just a Push Notification, or both in conjunction, start by clicking Messages in the Carnival navigation menu.

Click Create New at the top of the page. You will have the option to create either a Regular Message or an Automated Message.

  • Regular Messages Publish messages to all users who are currently in an audience. Regular messages can be sent immediately or scheduled for a future date. Some common uses are to send announcements, breaking news, or deals.
  • Automated Messages Targeted and personalized messages that are triggered as a result of a user entering or exiting an audience. Automated messages allow you to trigger messages dynamically as user behaviours change. Examples include:
    • Automatically triggering a notification to incentivize a user who hasn’t used the app for a period of time.
    • Sending a notification with contextual information as a user enters or exits a geographical region.
    • A welcome notification for a user a few days after installing.
  • With Automated Messages, an additional option is available to send the message to all current members of the audience, like a Regular Message, and then also to all users who enter the audience in the future, as they enter.

Message Compose Screen

In the Messages section of the interface, click Create New. Then, select a message type–Regular or Automated. The Message Compose screen opens.

Key Elements of the Message Compose Screen

  1. Audience targeting options
  2. Push Notification content
  3. In-App Message content
  4. Scheduling options
  5. Message Preview button

Audience Targeting Options

When creating a message, you will choose users to target based on audience segments that you have previously defined. Audiences can be created in the Audiences section.

The first thing to do is select your target audience from the Select an audience menu on the top bar.

For Automated Messages, you also need to select a trigger type from the adjacent menu. You can choose from the following options:

  • Send on Audience Entry – Publish to users as they enter the selected audience.
  • Send on Audience Entry and to Current Audience – Publish immediately to all users who are currently in the selected audience (as with a Regular Message), and also to additional who enter this audience in the future, as they enter.
  • Send on Audience Exit – Publish to users as they exit the selected audience.

“Send on Audience Entry” is the most common choice.

Push Limits for Automated Messages

With Automated Messages, you also have frequency capping options under the Push Limits drop-down to limit the amount of push notifications that are sent to any single user. This ensures that users are not spammed.

You can choose to:

  • Delay the push notification up to 24 hours after the device enters an audience.
  • Specify a stand-down period of up to 24 hours after the initial push has been sent. This will allow you to wait the specified amount of time before the device can receive this message again.
  • Limit the maximum amount of push notifications that a device may receive with this message.

Note: If a stand-down delay has been set for a message and a user enters, qualifies for the message, but then exits the audience before the delay passes, they will still be sent the message. For this reason, we recommend keeping stand-downs short so that the push notifications will always be timely and relevant.

Creating Content

The most common messaging use case in the Carnival platform is sending a Push Notification which links to an In-App Message. This drives users to open your app, and when tapped, links to a message with more content.

For this reason, the default layout of the composer opens with a Push Notification linked to an In-App Message.

There are however, some times where marketers may want to send only a Push Notification, or only an In-App Message. If this is the case, you can hover over the unneeded Push Notification or In-App Message and press “x” in the top-right corner to remove it.


Push Notification Content

Push Notifications contain text-only information which will show on screen even if the user does not have the app open. You can also add extra fields such as a badge, sound, category or Custom/Key Value by clicking Add fields.

  • Badge will show a small number on the app icon on iOS, which is usually used to indicate to the user that there is new items to view. For example, you would enter 1 in this field to indicate ‘one new message’.
  • If you app contains custom notification sounds, you can enter a Sound file name to determine which sound should accompany this message.
  • Category can be used to associate custom actions with an iOS notification. Category names are defined when your app is programmed. For more information refer to the Apple Documentation.
  • To enter custom data that your app has been programmed to use or display, select Custom Key/Val.

In-App Message Content

Carnival’s In-App Messages allow you to send a wide range of content to your users. You can send videos, images, and links, and add Message Attribute fields that have been custom-configured for your app’s interface.

  • To add a video or image, drag the file into the gray box or click the camera icon to locate a file on your computer.
  • To add a link, click Add fields, select Link, and then enter the URL.

See our message and file size/type specifications, for more information.

Scheduling Options

If you want your messages to begin sending immediately on publish, skip this step. Otherwise, to schedule your messages, click the Publish field at the bottom of the interface.

Then, select a date and time. You can select a specific time zone, or, if you want your message to send at the specified time when in occurs in each user’s time zone, select Send at local time.

Message Preview Screen

When you’re ready to preview your message, click the Preview button at the bottom right.

The preview screen will give you an overview of your notifications and In-App Message content, as-well as any extra fields you have added such as alert, sound, or custom key/values.

As you hover over the publish menu you can see more details about the audience and timing of your message before you publish.

Measuring Your Message Success

Measuring the performance of your messaging campaign is critical for understanding and comparing the effectiveness of your campaign. On this screen you are easily able to access:

  • Message Impressions – How many opportunities users have had to view your content.
  • Message Tap-Throughs – How many times the content has been viewed by your users.
  • Size of Audience – An estimate into how many users could see this message.
  • Push Notification Count – How many users the push notification went out to.

A/B Testing

To maximize the response to your content, you can use A/B Test Groups to test against a section of your audience prior to publishing your finalized campaign across all of your users. In order to do this, you will need to set up an audience and make use of the group attribute. All users in your app are split into one of ten random groups, which you can use for testing message effectiveness. Once a user is assigned to a group, the user will stay in that group.