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)

For how Cognitive3D classifies session devices into canonical categories and families, see Device classification fields.

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.