Scene reports
View aggregate survey reports and individual Scene performance metrics, including engagement statistics, user paths, screen interactions, and custom events.
Aggregate reports
For aggregate information about responses to questions and NPS surveys in your Scenes, see Surveys in Engagement Reports.
Individual Scene reports
To view Scene-level reports, go to Messages, then Messages OverviewA view of all your project’s messages, with options for editing their settings, content, status, and more., and select the report icon () for a Scene.
The report is in the same format as Message Reports. The header displays the Scene name and creation date, time and time zone, as well as its status.
These options are available in the header:
Stop () — Changes the status of an Active Scene 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.
Play () — Changes the status of a Canceled or Expired Scene to Active. See Restart an In-App Automation or Scene. This is effectively a shortcut to editing the Scene and either eliminating or specifying an end date. Expired Scenes can be restarted within a grace period of 14 days. After 14 days they can only be duplicated.
Edit () — Opens the Scene for editing. Availability depends on its status. Active Scenes can be edited at any time. An Expired or Canceled Scene 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 Scene and opens it for editing. You must complete the composer steps in order to save the new Scene.
Performance
The Performance section of a Scene report displays:
Latest Message Activity — The username, date, time, and activity associated with the most recent change to the Scene. Last Message Activity data is available for 90 days after Scene creation. For Scenes with more than one activity, select Show all to open a modal window that displays all activity.
Engagement Over Time — A chart displaying daily Completed, Dismissed, and Push Opt-in counts over the last 7 days. Hover over a date to see counts per day. You can select another time frame, and the chart will reload with the data for that period.
User Paths — A flow chart displaying each screen and its name, Impressions count, and Dismissed counts. A flow indicator shows the path taken between screens and the percentage of users that followed the path. Click and drag to move the chart, select the plus () and minus icons () to zoom in and out, or select the refresh icon to restore the initial view.
Statistics:
Statistic Description Survey Displayed For Scenes with questions or NPS, the total number of times the first screen with questions/NPS was displayed. Survey Submitted For Scenes with questions or NPS, the total number of times users clicked the button or image with action Submit Responses and the rate of submission. Survey Not Submitted For Scenes with questions or NPS, the total number of times users dismissed the Scene without tapping the button or image with action Submit Responses. Total Completed The total number of times all screens in a Scene were displayed and the rate of completion. This only appears for Scenes with more than one screen. Total Dismissed The total number of times the Scene was dismissed before the last screen was displayed. This count is not included in reporting for Scenes with a single screen. Total Impressions The total number of times the Scene was triggered and subsequently displayed on a device. This metric increments for repeat displays of the same Scene. See also View impressions usage in our View usage and manage payment guide. Total Push Opt-ins The total number of users that opted in from the system prompt or app settings after tapping a button or image with action Push Opt-in. Unique Device Impressions The total number of unique devices where the Scene was triggered and subsequently displayed. This metric does not increment for repeat displays of the same Scene. Note Ideally, Total Impressions = Total Completed + Total Dismissed, however discrepancies can occur due to:
- Users currently viewing a Scene — Users triggered the Scene but have not yet dismissed or completed it.
- Users closed the app, or users used the Back button on Android — These behaviors are not reported by the SDK, so the related events are not tracked or counted.
Scene detail
The Scene Detail section of a Scene report displays the same information shown in the Review step of the Scene composer, plus:
- Screen impressions — This is the total number of times the screen was displayed
- Interactions — The Interactions table lists click/tap counts for each screen.
- Screen dismissals — For Scenes with multiple screens, view a count of the times a screen was dismissed. Select the arrows to page through the previews of each screen. The counts update for the currently previewed screen.
If you are currently running an A/B test, you will see performance metrics for each variant. For more information, see Selecting the winning variant in Scene A/B tests.
If you included questions or an NPS survey in your A/B test, responses are included in the Surveys aggregate report. Select the link in Scene Detail to go to that report.
Events
The Events section of a Scene report displays a list of events directly and indirectly attributed to the Scene. The section is only displayed if you have Custom EventsEvents that indicate that a user performed a predefined action, such as adding an item to a shopping cart, viewing a screen, or clicking an Unsubscribe button. Custom Events can trigger automation, including Sequences and Scenes. You can code them into your app or website, or send them to Airship from an external source using the Custom Event API. Custom Events contain properties that you can use to personalize messages. enabled. Select Download CSV to export the data.
The following data appears in the Events table:
- Event Name — Human-readable name assigned to a particular Custom Event
- Notification Attribution — Displays whether your event was directly or indirectly attributed to the Scene
- Count — The number of instances of this event
- Value — The value (monetary or otherwise) generated by the event
- Average Value — Value divided by Count
- % of Total Count — Count divided by the Total Count, which is listed on the bottom row
If the Scene has a button, image, or screen configured with the action Emit a Custom Event, Notification Attribution for the event works as follows:
- Direct — A user opened the app by tapping a push and emitted the Custom Event by tapping a button/image/screen in the Scene.
- Indirect — A user opened the app sometime after a push was sent and emitted the Custom Event by tapping on a button/image/screen in the Scene.
- Unattributed — No push was sent, and a user emitted the Custom Event by tapping a button/image/screen in the Scene.
As of October 7, 2025, button tap events are listed per screen in the Interactions table in Scene detail. Before that date, events were listed in the Events table in the format button-tap-action--<label>, or if an event name was set, button-tap-<EventName>. Those events will still appear in the Events table for the following scenarios:
- A Scene was sent before October 7, 2025, and has not been edited. The report will not include the Interactions table.
- A Scene was sent before October 7, 2025, and has been edited since. The report will include the Interactions table and
button-tapevents, but those events will no longer increment. - A Scene was sent after October 7, 2025, but was displayed to users on an SDK version that is more than two years old. This scenario generates a low number of events.
The following events are accessible via Real-Time Data StreamingA service that delivers user-level events in real time to your backend or third-party systems using the Data Streaming API. and Performance AnalyticsA customizable marketing intelligence tool that provides access to reports and graphs based on engagement data.:
- Scene displayed
- Scene completed
- Scene incomplete
If your Scene contains questions and/or the Email element, these events are also included:
- Survey displayed
- Survey submitted
- Survey not submitted
- In-app form result (for Email submissions only)
Categories