Skip to content

Session Queries

Session queries provide access to user engagement data, device analytics, and behavioral metrics for specific scenes in your XR applications.

Tips

  • Compare across scenes: Run session queries for multiple scenes to identify which content resonates most
  • Follow-up queries: After viewing sessions, try "What objectives are configured for this project?" to understand success metrics

Get scene sessions

Returns session data for a specific scene, including device breakdowns, duration statistics, and engagement analytics. This tool helps you understand how users are interacting with your XR content.

Sample queries for scene sessions

  • "Show me sessions for scene X in project Y."
  • "What devices are users using in my training scene?"
  • "Get the last 30 days of sessions for the lobby scene."
  • "How many sessions has my demo scene had?"
  • "What's the average session duration for project 123?"

Response for scene sessions includes

  • Total session count
  • Session duration statistics (average, min, max)
  • Device type breakdown (Quest, Vive, etc.)
  • Temporal distribution of sessions
  • User engagement indicators

Understanding the scene sessions response

The session response includes several key metrics:

  • Session Count: Total number of completed sessions
  • Device Analytics: Which hardware platforms users are using
  • Duration Metrics: How long users spend in the experience
  • Time Distribution: When sessions occur (useful for identifying peak usage)

Parameters for scene sessions

Parameter Required Description
project_id Yes The numeric project ID
scene_id Yes The scene ID (obtained from project details)
version_id Yes The version ID (obtained from project details)

Finding IDs

You can obtain scene_id and version_id from the get_project_details tool response.

Available Tools

Tool Purpose
get_scene_sessions Session data, device analytics, and engagement metrics for a scene

intercom If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.