Experience: in-app message

Configure experience options for in-app messages, including type (full screen, alert, or notification) and display, text, and button options.

  1. In your app, click Messaging > Manage Messages > Create Message > Create In-App.

  2. On the Experience page, type a name for the message.

  3. Complete the fields in the Type section:

    • Type
      Select the message type for your in-app message campaign:

      • Full Screen
      • Alert
      • Local Notification
    • Template

      Customize a themed responsive message template for your content.

      TIP

      This option is displayed only when you select the Full Screen message type.

    • Custom

      Load your custom HTML content (full screen only). You must provide a click-through link and a cancel link.

      1. Click Browse and download an HTML file or drag an HTML document to the window.
      2. Click Download Example to view sample custom HTML content.
      TIP

      This option is displayed only when you select the [!Full Screen] message type.

  4. Complete the fields in the Display section:

    • Theme

    Select a theme for your message.

    • Layout

      Select the app layout on the device screen.

    • Image URL

      The URL for an image. If you have sizing issues when using the full-screen template, see My image does not fit exactly into the space provided by the template in Troubleshooting in-app messaging.

    • Bundled Image

      Path to an image in your app code bundle. This option is used when there is no image. or the image is unavailable. The imagine might not be available if, for example, the device is offline. If you have sizing issues when using the full-screen template, see My image does not fit exactly into the space provided by the template in Troubleshooting in-app messaging.

  5. Complete the fields in the Text section:

    • Header

      Type the text for the message’s header.

    • Content

      Type the text for the message’s content.

  6. Complete the fields in the Buttons section:

    • Click-Through Button

      Label for the Click-Through button. Tapping this button counts as a successful click-through. The user is redirected to the destination.

    • Destination

      Select a specific destination, such as a web, deep, or hybrid link, to send users when they click-through the message. The redirect URL for a successful click-through.

      This URL might contain the following information:

      • {userId}, which is replaced with the user identifier or is blank when the user identifier is not set.
      • {trackingId}, which is replaced with the aid (correlates with s_vi cookie).
      • {messageId}, which is replaced with the unique ID for the in-app message.
      • {lifetimeValue}, which is replaced with the lifetime value or 0 if no lifetime value exists.

      Here is an example of tracking the user ID: https://www.mysite.com?uid={userId}.

      If the click-through URL uses https:// or https://, the URL opens in the device browser outside the app. Otherwise, each platform supports schemes that allow you to open or reference your app if the app has been developed to support the custom scheme.

      TIP

      When you use the Web Link or Custom Link destination types, the destination type is not tracked. Only Deep Links are tracked. For more information, see Destinations.

  7. (Optional) Preview the layout of your message by clicking following icons:

    • Summary hides the preview pane.

      Click preview to redisplay the preview pane.

    • Change the orientation

      To change the orientation of the preview from portrait to landscape mode, click orientation. For watches, the orientation changes from a round to a square watch face.

    • Preview on a user’s watch

      To preview your message as it will appear on a user’s watch, click watch icon.

    • Preview on a user’s mobile phone

      To preview your message as it will appear on a users’s mobile phone click phone icon.

    • Preview on a user’s tablet

      To preview your message in a user’s tablet, click tablet icon.

      At the bottom of the preview pane, you can view a description of the audience that you selected in the previous step. You can also view a description of the audience you selected in the previous step at the bottom of the preview pane.

  8. Configure Schedule options.

On this page