Metrics can take 10 - 15 minutes to update after our servers have received the event.
Open a Message Report
- Open your messaging project from the dashboard, then go to Messages » Messages Overview.
- Select a tab:
- History: Messages created with the Message composer and
- Automation: Messages created with the Automation composer and
- In-App Automation: Messages created with the In-App Automation composer.
After 14 days, messages with Expired or Stopped status move from In-App Automation to the History tab.
- History: Messages created with the Message composer and
at the end of a message row to open the report preview.
The row expands, displaying metrics from the message report. Click the icon again to collapse the preview. Available metrics vary per message type. Click
to see definitions. Click Expand All and Collapse All to expose and hide report previews for all listed messages.
In-App Automation does not have report previews.
- Click to open the message report.
Open a Message Report for A/B Tests
- Open your messaging project from the dashboard, then go to Messages » A/B Tests.
- Click on the History tab.
- Click a variant name to open the message report.
Duplicate Message or Change Message Status
Open a message report, then click an option in the report header. Options vary depending on which composer was used to create the message.
- Message and A/B Test Composers
- The header displays the message's notification text and creation date, time, and time zone. Options:
- Duplicate: Creates a copy of the message and prompts you to choose a composer for the new message. You must complete the composer steps in order to send the new message.
- Automation Composer
- The header displays the message's notification text and creation date, time,
and time zone, as well as the message status and Automation Limits
Automation limits control over-notification to users who repeatedly meet automation criteria, capping automated messages per device per given time interval, e.g., a maximum of 4 messages every 10 hours.
to open your project’s Configuration settings. See: Manage Automation Limits. Options:
- Pause/Resume: Active messages have the option to Pause. Paused messages have the option to Resume.
- Cancel: Deletes the message.
- Edit: Opens the message for editing.
- Duplicate: Creates a copy of the message and opens it for editing. You must complete the composer steps in order to send the new message.
- In-App Automation Composer
- The header displays the message's name and status.
- Stop: Changes the status of an Active message to Canceled. This is effectively the same as specifying an end date, immediately applying an end date of "now." Active messages can be canceled at any time.
- Restart: Changes the status of a Canceled or Expired message to Active. See: Restart Message. This is effectively a shortcut to editing the message and either eliminating or specifying an end date. Expired messages can be restarted within a grace period of 14 days. After 14 days they can only be duplicated.
- Edit: Opens the message for editing. Availability depends on message status. Active messages can be edited at any time. An Expired or Canceled message can be edited and its end date extended, making it active again, within a grace period of 14 days. After 14 days they can only be duplicated.
- Duplicate: Creates a copy of the message and opens it for editing. You must complete the composer steps in order to save the new message.
View the API Payload
- Open a message report.
on right side of the page to expose the message's API Payload.
The content included in the API Payload is what we call a push object. The
push object describes everything about a push notification, including the
audience and push payload. For more details on the push object, see:
API: Push Object.
In-App Automation does not have a public API, so the API Payload is not available for those messages.
Evaluate Message Performance
Open a message report, then click Performance.
Engagement data does not apply to or appear for In-App Automation.
- Latest Message Activity
- The username, date, time, and activity associated with the most recent change to the message. Last Message Activity data is available for 90 days after message creation. Click Show all to open a modal window that displays all message activity. This is only an option for messages with more than one activity.
- Statistics panes are directly below Latest Message Activity. Click to see term definitions. Note that Direct Engagements will not appear if the message included a send to an Open Channel.
- Engagement Over Time
- Engagement data is available for all messages sent via push. The bar chart includes engagement data for 12 hours following a message being sent. By default, the chart displays Direct Engagement for the message sent, e.g., a direct open on a mobile app or a click on a web notification. Check the boxes to see additional information:
- Channel Breakdown: Displays the chart data broken down by channel, e.g., iOS, Android, and Web.
- Attributed Engagement: Displays the message's total engagement attributed to the notification. For messages sent to mobile app platforms, this uses our Influenced Opens metric. For messages sent to a web browser, this uses our Attributed Web Sessions metric. See definitions at the end of this document.
The chart remembers your selected preferences. If you visit a message report and enable Channel Breakdown, the next report you view will default to this presentation as well.
- Engagement Channels
- Following the bar chart are metrics tables for channels, and also for In-App Message and Message Center (Rich Page), if included in the message.
- Channel: Notification sends and engagement metrics by channel.
- In-App Messages: Total number of message views by opt-in and opt-out status.
- Message Center (Rich Page): Total number of message sends, views, and deletions.
Send a Follow-Up Message
Audience Retargeting makes it easy to send follow-up messages to the audience of a parent message. See: Audience Retargeting.
If a push notification was used to generate retargeting segments, you will see them listed under Retargeting Segments in the Performance section of the report. The percentage and number of Direct Opens and No Action are followed by the total number of recipients.
Click Compose Follow-up to start creating a new message for the segment you want to target. Follow the steps in the audience retargeting tutorial.
View Message Detail
Open a message report, then click Message Detail. This is the same information shown in the Review step of a Composer A method of creating messages via the dashboard. Composers are defined by what you can include and control: message types, delivery, and automation. , so the content and display vary depending on the composer used to create the message. Click the arrows to page through the various previews. The channel and display type dynamically update in the dropdown menu above. You can also select a preview directly from the dropdown menu.
If a push notification was used to generate retargeting segments, the Audience table shows Retargeting as enabled. If a push notification was sent to a retargeting segment, the Audience table displays the Type as Retargeting Message, specifies the segment of the parent message, and lists the parent message as a link to its message report.
The Delivery by Time Zone table is included for messages delivered according to a user's local time zone. Metrics for Alerting Sends and Engagement are provided for each time zone. The bottom row lists the total number of time zones with zero sends; this represents the number of time zones where none of your message recipients are located.
View Attributed Events
Open a message report, then click Events. The Events pane displays a list of events attributed, both directly and indirectly to the message. You can click Download CSV to export the data.
- Event Name: Human-readable name assigned to a particular Custom Event.
- Notification Attribution: Displays whether your event was directly or indirectly attributed to the message.
- Location: The source from which the event originates.
- Count: Number of instances of this event.
- % of Total Count: Count divided by the Total Count (listed on the bottom row).
- Value: The value (monetary or otherwise) generated by the event.
- Average Value: Value divided by Count.
These definitions apply to the Engagement Over Time chart in the Performance section of a message report.
- In-App Message Send
- The number of in-app and silent sends associated with the message.
Silent sends are sent via Background Processing
An optional delivery feature that wakes the app and gives it some running time to perform work, such as downloading content for future display. Data included in the push notification is available for background processing, e.g., to send URLs and then download that content. iOS only.
An in-app message Send is logged for these scenarios:
- An in-app message, with or without an associated push, is sent to an opted-out device. Because opted-out devices will only receive the in-app message, this is counted as an in-app message Send.
- An in-app message only is sent to an opted-in device.
An in-app message combined with a push notification that is sent to an opted-in device will always be counted as a notification Send rather than an in-app message Send.
- In-App Message View
- The number of times an in-app message was displayed.
An in-app message View is logged when a user encounters an in-app message, whether the in-app message was sent by itself or in combination with a push notification. Either of the two scenarios that result in an in-app message Send being logged will most likely also result in a View on open, assuming a user opens the app before the in-app message expires.
An in-app message combined with a push notification that is sent to an opted-in user can also result in a View; if the user opens the app without tapping the push notification, the in-app message will still display, counting as a View.
- Attributed Web Sessions
- The total number of sessions attributed to the push notification.
An attributed session is a session that occurs within a 12-hour window of a web push notification. Sessions are generated when a user directly visits the website with the Airship Web SDK present, or by clicking a web notification that leads the visitor to the site. The page the user visits must have the Web SDK present in order to track sessions.
If a user visits the web page within 30 minutes prior to when the web push notification arrives, and they:
Click the web push notification, a new attributed session will be generated.
DO NOT click the web push notification, an attributed session will be generated only if there has been 30 minutes of inactivity on the website.