Set In-App Automation Defaults

Set the default appearance and behaviors of your In-App Automation messages.

These settings apply to in-app messages created via the In-App Automation composer only.

Set In-App Automation Default Design

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Default Design.
  2. Select a message style from the dropdown menu, then configure. Changes save automatically.
    • Colors are hexadecimal values. The default value for all color fields is white (#FFFFFF).

Background

  • Background Color: The color of the message background. Enter a hexadecimal value.

  • Dismiss Action Color: The color of the dismiss element. For modal, full screen, and custom HTML messages, this is the color of the "X" button used to dismiss the message. For banner messages, this is the color of the drawer pull element that indicates the direction the user can swipe to dismiss the message. Enter a hexadecimal value.

  • Placement: Determines the screen position of a banner message. A message set to Top will appear by animating down from the top of the screen. A message set to Bottom will animate up from the bottom of the screen. Select Top or Bottom from the dropdown menu.

  • Border Radius: Governs the degree to which a banner, modal, or custom HTML message's corners will be rounded. For banner messages, this applies to bottom corners for top-placed messages and top corners for bottom-placed messages. Enter an integer from 0 to 20.

  • Display fullscreen on small screen devices: Stretches modal and custom HTML message layouts to fullscreen on small devices, e.g. mobile phones, maintaining the same button layout. Use this setting if you want your message to take over the entire screen on a phone but display as a modal on a tablet. The default display of custom HTML messages is modal. Check the box to enable.

Text

Set for the message Heading and Body.

  • Text Color: The text color of the message heading or body. Enter a hexadecimal value.

  • Size: Small, Medium, or Large. Select from the dropdown menu.

     Tip

    Set the default values in the Font Size section of the Fonts tab.

  • Alignment: Align text left, middle, or right. Click to select.

  • Style: Bold, Italic, or Underline. Click to select.

  • Font Family: Serif or Sans-serif. If you have configured Custom Fonts, they will also be listed. Select from the dropdown menu.

Buttons

Set for each button. Buttons are in order of the layout selected in the Content step of the In-App Automation composer).

  • Background Color: The button background color. Enter a hexadecimal value.

  • Text Color: The button text color. This should contrast with the Background Color. Enter a hexadecimal value.

  • Label Size: The button text font size. Select Small, Medium, or Large from the dropdown menu.

     Tip

    Set the default values in the Font Size section of the Fonts tab.

  • Border Color: The button border color. This may contrast with the Background Color. Enter a hexadecimal value.

  • Border Radius: Governs the degree to which the four corners of the button are rounded. Enter an integer from 0 to 20.

Set In-App Automation Font Size

Set the default font size values for header, body, and button label text.

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Fonts.
  2. In the Font Sizes table either manually enter a numeric value, or click a field and use the arrows to adjust the existing value. Changes save automatically.

Add In-App Automation Custom Fonts

Make your app's installed fonts available to select from the Font Family dropdown menu in the In-App Automation composer.

You will add individual font names to create a font stack. A font stack is a list of the font names that are passed down from the app to the device. The font stack is used to provide alternatives if a custom font is not available to your app. It also lets you unite font names from different app platforms into a single selection, as your custom font name may differ between iOS and Android.

 Note

Custom font configuration will not install a custom font for you. A developer must still install the custom font within the app:

 Note

The font names you enter must match the names as configured in your app. Confirm your app's font names with your developer. Font name format varies by app platform:

  • iOS: Use the PostScript Name (or Fullname) of your font. This is not necessarily the filename of the font. The best way to verify the PostScript Name is to use the Font Book application on OSX.

  • Android: Use the name that is in your app's fonts.xml. See the Fonts In XML guide. For example, if you define a font in res/fonts/my_cool_font.xml, the font name is my_cool_font.

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Fonts. Create separate font stacks for serif and sans-serif fonts.
  2. Click Add a custom font stack and complete the form.
    • Name: Enter a name for the font stack.
    • Add a font: Enter a font name and click Add. Continue adding individual font names until your list is complete.
  3. Click Save.

Edit In-App Automation Custom Font Stacks

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Fonts.
  2. Click .
  3. Edit the name of the font stack, add font names, or click the X next to any font name to remove it.
  4. Click Save

Delete In-App Automation Custom Font Stacks

 Note

This will delete the entire font stack. If you want to delete an individual font within a font stack, [edit the font stack instead].

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Fonts.
  2. Click .

Enable In-App Automation Background Push

Background push pre-loads in-app messages on users' devices, which increases the speed and reliability of message delivery. It disabled by default. When disabled, the SDK downloads and refreshes the entire message list upon next app open. For information about the potential impacts of background push, see: In-App Message: Background Push.

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Advanced Options.
  2. Toggle Background Push to ON.

Set In-App Automation Missed Behavior

Specify how messages are handled when audience conditions are not fully met.

 Note

You can override this setting on a per message basis in the Settings step of the In-App Automation composer.

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » In-App Automation » Advanced Options.
  2. Toggle Background Push to ON, then select a behavior from the dropdown menu. Changes save automatically
    • Cancel: The message cannot be displayed again on the device, even if the message is edited.
    • Ignore: The message will not count toward the display limit set in the optional message setting Repeat this message, and the waiting period will not apply. The trigger event must occur again before the message is eligible for redisplay.
    • Penalize: The message will count toward the display limit set in the optional message setting Repeat this message, and the waiting period will apply. The trigger event must occur again before the message is eligible for redisplay.