1. Home
  2. /Guides
  3. /Messaging
  4. /Data + Analytics
  5. /Performance Analytics
  6. /Exploring
  7. /Scenes Explore custom queries and reference

Scenes Explore custom queries and reference

Use the Scenes Explore to analyze the performance of your Scenes and the relevance of each screen.

Access history related to SceneA single or multi-screen in-app experience cached on users’ devices and displayed when users meet certain conditions in your app or website, such as viewing a particular screen or when a Custom Event occurs. They can be presented in fullscreen, modal, or embedded format using the default swipe/click mode or as a Story. Scenes can also contain survey questions.

Data availability depends on your Performance Analytics plan.

To access the Explore:

  1. Go to Reports, then Performance Analytics.
  2. Select the folder icon (), then Shared.
  3. Under Looks, select Explore Glossary (Explore Glossary EUCS for EU customers).
  4. Select Scenes, then Navigate to Explore.

For a list of all Explores in the glossary, see Predefined Explores in Exploring Performance Analytics data.

Field categories

The sidebar lists categories for various filters, DimensionsGenerally, a string field in Performance Analytics. They can be grouped and can act as filters or members of a data set., and MeasuresA numeric field in Performance Analytics — like a count or sum. Measures appear in orange within an explore. you can use to explore your data. To see their definitions, hover over an item, then select the “i” icon ().

Field categories in the Scenes Explore:

CategoryDescription
Attributes CurrentGet Attribute values associated with the channels at the time the report is run.
Attributes RelevantGet Attribute values associated with the channels at the time the Scene was displayed.
Device Properties CurrentGet device property values associated with the channels at the time the report is run.
Device Properties RelativeGet device property values associated with the channels at the time the Scene was displayed.
Query ParametersTarget all or specific projects, and specify dates and response windows, where relevant.
ScenesSet Scene parameters for the query. Includes survey-related data if NPS or Questions are included in a Scene.
SurveySet Survey parameters for the query. Does not include data from Scenes.
Tags CurrentGet Tag values associated with the channels at the time the report is run.
Tags RelativeGet Tag values associated with the channels at the time the Scene was displayed.
User DetailGet information about the channel that performed the filtered event.

Default filters

Use filters to reduce the number of records scanned and results returned. Each Explore includes filters that cannot be removed from the query.

The filter name, field category, and usage information for the default filters in the Scenes Explore:

Filter nameField categoryUse the filter to...
Current Project OnlyQuery ParametersDetermine which projects are included in the query. Default selection: Yes. To include other projects within your company, select No, then:
  1. In the sidebar, select Query Parameters.
  2. Under Dimensions, select the filter icon () next to Project name.
  3. In the Filters section, select the entry field next to the Project Name filter and choose which projects to include.
Date RangeQuery ParametersTarget events that occurred on a specific date or within a specific date range.

Building custom queries

The following sections walk you through using the Scenes Explore to create custom queries that answer:

  • How can I identify the users who completed a Scene?
  • To optimize my Scene, how do I determine which screen is the most relevant and which one generates churn?

Identify who completed a Scene

Follow these steps to get the Channel IDsAn Airship-specific unique identifier used to address a channel instance, e.g., a smartphone, web browser, email address. of the users who viewed all screens in a specific Scene and the number of times they viewed it.

First, get the Push IDA unique identifier for a push operation. for the Scene you want information about:

  1. Go to Messages, then Messages Overview.
  2. Search for an active or stopped Scene.
  3. If the list is in collapsed view, hover over the Scene and select the report icon () to open its message report. If in expanded view, select Report.
  4. Copy the Push ID from the address bar. The ID follows pushdetail/ in the URL. In this image, the ID is 644dae8d-4ff4-4688-9fe9-e7dac2138ea7:

Next, open the Scenes explore, and then configure your query:

  1. Set up the filters:
    1. Leave Current Project Only set to is Yes.
    2. Set Date Range to the range you are interested in.
    3. Select Filter, then Scenes, then Notification ID, and paste the Push ID for your Scene.
    4. Select Filter, then Scenes, then Scene Completed Count, and set the value to is >= 1 (greater than or equal to one).
  2. In the sidebar, specify the values and measurements to display:
    1. Select Scenes, then select the Dimension Notification ID.
    2. Select User Detail, then select the Dimension Channel ID.
    3. Select Scenes, then select the Measures Scene Displayed Count and Scene Completed Count.

Now you are ready to get your data. Select Run, and you should see results similar to the below image. To save your custom query for later access, follow the steps in Saving Performance Analytics queries.

Scenes Explore custom queries and reference
Using the Scenes Explore to identify who completed a Scene

Find relevant screens

Follow these steps to identify which screen is the most relevant to users and which generates churn.

First, get the Push IDA unique identifier for a push operation. for the Scene you want information about:

  1. Go to Messages, then Messages Overview.
  2. Search for an active or stopped Scene.
  3. If the list is in collapsed view, hover over the Scene and select the report icon () to open its message report. If in expanded view, select Report.
  4. Copy the Push ID from the address bar. The ID follows pushdetail/ in the URL. In this image, the ID is 644dae8d-4ff4-4688-9fe9-e7dac2138ea7:

Next, open the Scenes explore, and then configure your query:

  1. Set up the filters:
    1. Leave Current Project Only set to is Yes.
    2. Set Date Range to the range you are interested in.
    3. Select Filter, then Scenes, then Notification ID, and paste the Push ID for your Scene.
  2. In the sidebar, specify the value and measurements to display:
    1. Select Scenes, then select the Dimension Screen Number.
    2. Select Scenes, then select the Measures Screen View Count and Per Notification Rates: Button Tap Rate.
Scenes Explore custom queries and reference
Setting the calculation method for Button Tap Rate

Next, select Run to get your data, then select the gear icon () in the header of the Button Tap Rate column, then Calculations, then % of column. This sets the value to the percentage of views per screen.

As a final step, you can personalize the visualization in order to highlight the percentage of displays per screen and the percentage of engagement per screen. This can help you to quickly identify the impact of each screen of your Scene. Select an icon in the Visualization section header and hover over an icon to see its label. You may need to select the three dots icon () to expose all options. Select Edit for options specific to the current format. Some Visualization types may be incompatible with the currently selected Dimensions and Measures. The image below shows the report with the Column visualization selected.

Scenes Explore custom queries and reference
Using the Scenes Explore to find a Scene's relevant screens

To save your custom query for later access, follow the steps in Saving Performance Analytics queries.