Navigation Path​

  1. In the main navigation, click ​Messages > ​In-App Messages​.
  2. Select a message in the list and click ​Edit / View​.

Purpose​

Use the ​In-App Message​ window to create an In-App message, to edit an existing message, or to view a deactivated message.

What can I do in this window?

  • Create a message

  • Edit a draft or active message

  • View a cancelled message

Actions​

Action

Description

Continue

Displays the ​Delivery Settings​ pane for the message.

Back

Displays the ​Content​ and ​Configuration​ panes for the message.

Save As Draft

Saves the message with a status of draft, and returns to the ​Messages​ window. This option only appears when editing a new message or a draft message.

Deactivate

Deactivates the message. The message status changes to cancelled, and the message is no longer available for use. This option only appears when editing an active message.

Update

Save changes to the message and returns to the ​Messages​ window. This option only appears when editing an active message.

Cancel

Closes the ​In-App Message​ window without saving changes.

Opens the ​Details​ pane, where you can edit the name and description of the message. Click ​X​ to close the ​Details​ pane.

Content Controls​

The ​Content​ pane contains a built-in HTML editor with standard controls to create the content for your message. To refer to the help for the editor, click ​?​ and select the link to the user guide.

The editor contains a WYSIWYG mode and a source mode. Click ​Source​ to switch between the views. If you copy in HTML code, make sure you paste the content into the editor window while you are in source mode.

SettingDescription

Web In-App templates and  Native In-App templates

On the second step of the In-App message composition, select the In-App message template. With the exception of the Custom HTML Web template, each Web template has a corresponding Native template.

Choose between:

  • Seven different Web templates:
    • Custom HTML Web template
    • Standard
    • Fullscreen
    • Background Image Standard
    • Background Image Fullscreen
    • Banner Top
    • Banner Bottom or
  • Six different Native templates:
    • Standard
    • Fullscreen
    • Background Image Standard
    • Background Image Fullscreen
    • Banner Top
    • Banner Bottom
  • Once you choose the template, during the message composition, you are able to edit the template itself by adding Image, Content, and Button(s).
  • You can change templates between Web and Native, as well as among each other. This will cause no additional rework to the already created content, as the created content will automatically adjust to the selected template.

    Custom HTML Web template is the only one excluded from this functionality: if you change the template from Custom HTML Web to any other, the existing content will be discarded.

Configuration Controls​

The following are the controls that appear in the ​Configuration​ pane.

Setting

Description

Frame Type

Select how the message displays to the user.

  • ​Full screen No Dismissal​ displays the message across the entire screen and does not contain an option to close the message.

  • ​Full screen X Dismissal​ displays the message across the entire screen and contains an ​X​ button to close the message.

  • ​Banner No Dismissal​ displays the message as a banner in the position that you specify in ​Position​. The message does not contain an option to close the message.

  • Banner X Dismissal​ displays the message as a banner in the position that you specify in ​Position​. The message contains an ​X​ button to close the message.

Position

Select to display a banner message at the top or bottom of the user's screen. This option is disabled when ​Frame Type​ is set to a full screen option.

Display Duration

Select how long to display the message. This value is measured in seconds and must be an integer.

Display Delay

Select how long to wait before displaying the message. This value is measured in seconds and must be an integer.

Delivery Settings Controls​

The following are the controls that appear in the ​Delivery Settings​ pane. Select an option for all delivery settings to activate the message.

Setting

Description

App

Select the mobile app to associate with the message. The message is only available to users on that app. When you select an app, In-App Messaging filters out the events and target audiences that do not apply to that app. In addition to events and target audiences that are specific to the app, events and target audiences that apply to any app still display.

Event

Select the event on the app that triggers when to display the message. Events originate from the app and automatically upload to the Engage system when the event occurs.

Target Audience

Select the target audience that can see the message.

Details Controls​

The following are the controls that appear in the ​Details​ pane. To open the ​Details​ pane, click.

The ​Last Changed​ date of the message updates when you update the name or description of a message. If multiple messages match the same audience criteria, In-App Messaging chooses the message with the most recent ​Last Changed​ date.

Setting

Description

Name

The name of the message. The name can contain alphanumeric characters and spaces.

Description

An optional description of the message.