Composer Overview

A composer is a tool for creating messages via the dashboard. This document explains how to use composers, their navigation and elements, and how to find your message drafts.

Learn each composer by following the tutorials:

Process

Open your messaging project, then click Create and select a composer. If you have Composer FavoritesReusable messages with preset settings and content. You can use Composer Favorites instead of recreating commonly used messages. you can select a favorite instead.

The steps vary slightly per composer, but in general you will:

  1. Choose who to send the message to.
  2. Enter the message content.
  3. Configure its appearance.
  4. Decide when the message will be delivered.
  5. Review the appearance and content of your message.
  6. Send the message.
 Important

The Apple News composer is a single screen, with no navigational elements. The remaining information on this page does not apply to Apple News.

The same elements persist across every screen as you create a new message:

  1. Return to your Airship dashboardThe Airship web interface located at go.airship.com or go.airship.eu. .
  2. The icon, name, and environment type for your current project.
  3. Name a message or flag a message as a test.
  4. Progress through the composer steps.
  5. Create a Composer Favorite. Available in the Message composer only.
  6. Exit the composer or perform other actions.

When adding or editing messages in a journey, you will see the additions of the journey name and message position:

  1. Return to your Airship dashboardThe Airship web interface located at go.airship.com or go.airship.eu. .
  2. The icon, name, and environment type for your current project.
  3. Name a message or flag a message as a test.
  4. The journey name.
  5. The position of a message within the journey.
  6. Progress through the composer steps.
  7. Exit the composer or perform other actions.

Journey Manager

The journey manager displays a preview of the messages in a journey, with options for editing its settings, content, and status. Airship opens the journey manager after you add or modify messages in a journey. You can return to the journey manager by selecting your journey in Messages OverviewA view of all your project’s messages, journeys, and A/B tests, with options for editing their settings, content, status, and more. and clicking  .

  1. Return to your Airship dashboardThe Airship web interface located at go.airship.com or go.airship.eu. .
  2. The icon, name, and environment type for your current project.
  3. The journey name.
  4. Edit the journey settings.
  5. Start or pause the journey.
  6. Return to the journey manager from the PerformanceA report that compares audience behavior to a journey’s goal. It displays performance metrics and a link to the message report for each message in the journey. or Test screens. This link is available after you start the journey.
  7. Performance appears after you start the journey. Test appears after the journey is configured with the minimum requirements to start it.
  8. Exit the journey or perform other actions.
  9. Click the drawer to view journey settings and configuration options. Click   to close.
  10. After editing a journey, click Test changes to create a journey test, or click Publish changes to apply the changes to a journey that is already in progress.
  11. The journey trigger.
  12. The delivery delay period. This is displayed for the first message and between messages.
  13. A message preview. The message name appears at the top. If your account is enabled for Orchestration, the message’s Channel CoordinationA group of strategies you can use to target users where they are most likely to receive your message. strategy and selected channels also appear here. Click   to:
  1. The device preview. Select from the menu to see how the message will appear on different devices.
  2. Add a message to the journey.

Composer Steps

Each composer step is shown in the header.

In the Message, Automation, A/B Test, and Journey composers, completed steps are green and display  , showing you are ready to proceed. A red   appears if you need to fix anything. Click a step name to move ahead or to go back and edit.

In the In-App Automation composer, click   to continue to the next step — it will be greyed out and inactive until the step’s minimum requirements are fulfilled. In the final step, click Finish.

Each step is indicated as a color-coded dot:

  • Green outline: Current
  • Grey outline: Unviewed
  • Red outline: Incomplete
  • Grey solid: Completed

Hover over a dot to see its step name appear as tooltip. Return to any previous step by clicking its dot.

Composer Favorites

In the Message composer,   indicates you can save the message as a Composer FavoriteReusable messages with preset settings and content. You can use Composer Favorites instead of recreating commonly used messages. .   indicates you are creating a message from a Composer Favorite or editing a saved Composer Favorite. See: Use Composer Favorites.

Exit Menu

When composing a message, Exit and   operate independently.

When you click Exit while composing a message, your message is saved as a draft and you will go automatically go to Messages OverviewA view of all your project’s messages, journeys, and A/B tests, with options for editing their settings, content, status, and more. . For messages in a journey, you will go to the journey manager instead of Messages Overview.

  • If composing a new message in a journey, your message is saved as a draft
  • If editing a message in a journey, your changes are not saved.

Click   for more options:

  • Delete: Delete a message, automation, in-app automation, A/B test, or Composer Favorite.
  • Revert: Cancel changes to an edited message, automation, A/B test, journey, or Composer Favorite.
  • Save changes: Save changes to an edited Composer Favorite.
  • Make a copy…: Make a copy of a Composer Favorite.

In the journey manager, Exit   has options:

  • Save & Exit: Apply changes to the journey. If your journey is in progress, then click Publish changes to resume your journey with your changes applied.
  • Revert: Exit the journey without saving changes.
  • Delete: Delete the journey.

Summary and Help

Immediately under the header is a tab. Click   to expose Summary and Help.

Your selected conditions are displayed in the Summary. The Help tab displays information relevant to the current step. Click   in the composer and the Help tab will open to that topic.

Device Preview

As you draft your message, the device preview updates with your changes.

Click the arrows to page through the various device previews. The channel and display type dynamically update in the dropdown menu above. You can also select a preview directly from the dropdown menu.

Open Channel

The Open Channel preview is a data table containing the message’s selections and content. This preview format appears by default when an Open Channel is the only selected plaltform. It can also be selected from the preview dropdown menu when an Open Channel has been combined with other channels.

Content Elements

These elements appear in the Content step of the Message, Automation, A/B Test, and Journey composers.

Truncation Indicator

Below the content text box is a color-coded indicator that warns when your message may be truncated on some devices.

  • Green: Full length of message will appear in most cases
  • Orange: Message may be shortened on some devices
  • Red: Message will be shortened on all devices
 Tip

Best practice is to make your message as brief as possible, though some customers find success when a message truncates, teasing their audience to learn more.

In-App Message Text

For app channels, when you combine a push notification and in-app message, the in-app message’s alert text is the same as the push notification text by default. To use different messages, select Write Alternative for In-App Message Text and enter your text.

Tabs

When you select multiple channels, you will configure content on a tab for each channel. All app platforms (iOS, Android, Amazon) are configured on the App tab.

Set a Tag

You can set and/or remove tags when the user interacts with your message.

 Tip

Setting one or more tags when a user interacts with a message can help you track user interactions for follow-on retargeting campaigns. For example, if you set a tag “responded-campaign1”, you can target users bearing the “responded-campaign1” tag with another message at a later date, knowing that they are active users. Alternatively, you can re-engage users with this tag using an automated message if they are inactive for a period of time.

Drafts

Your drafts are saved automatically. Go back to a saved message, journey, or A/B test in Messages OverviewA view of all your project’s messages, journeys, and A/B tests, with options for editing their settings, content, status, and more. .

  1. Go to Messages » Messages Overview.
  2. Click the Drafts view.
 Note

The last step in creating an In-App Automation is clicking Finish. If you exit before this final step, the message is still a draft.