Advanced Options
Cognitive Preferences
From the Cognitive3D menu, select Preferences to open the Cognitive3D_Preferences asset.
General
- Application Key - Your application API key, used to send your data to your project. Find it in the Project Keys dialog, opened from Manage Developer Key on the dashboard.
- Attribution Key - This is used to send events to your project from outside the VR app. This is available in the Administration page on the Dashboard.
- Enable Logging - This displays Cognitive3D specific logs. This is useful for setting up the SDK, but this should be disabled before release.
- Enable Development Logging - Displays a detailed logs for serious troubleshooting. This should be disabled before release.
Player Tracking
- Record Gaze - This can be disabled to skip tracking the player's gaze in the world. It still records their head position
- Dynamic Object Search in Parent - This allows dynamic object components to use child colliders to track gaze.
- Gaze Layer Mask - Allows you to skip certain physics layers when calculating gaze
- Dynamic Object Layer Mask - Allows you to skip certain physics layers when calculating gaze specifically for Dynamic Objects
- Gaze Query Trigger Interaction - Allows you to hit or skip triggers when calculating gaze
- Record Floor Position - Record the floor position beneath the HMD position. Uses a physics raycast to determine position.
Location
These options require adding C3D_LOCATION to the scripting define symbol in Project Settings. See Troubleshooting for details.
- Record GPS Location - Records the participant's GPS location once at the start of the session. The latitude and longitude are saved as the
c3d.geo.origin.latitudeandc3d.geo.origin.longitudesession properties. This relies on devices that have a GPS chip, such as mobile phones in an augmented reality context. - GPS Accuracy - Sets the desired accuracy of the GPS, in meters. Higher values, such as 500, may not require the GPS chip and can save battery power.
Unity SDK 2.6 and above
In SDK 2.5 and older, this option was named Record GPS Location with HMD Position and recorded GPS and compass data at the same rate as HMD position. In SDK 2.6 and above, GPS and compass data are no longer included with gaze data, and the GPS Location component is deprecated. Remove the component from your scene and enable Record GPS Location instead.
Sending Data Batches
- Automatic Send Timer - The time (in seconds) to automatically send any outstanding data
- Gaze Snapshot Batch Size - The number of gaze events that are recorded before automatically sent to Session Replay
- Event Snapshot Batch Size - The number of custom events that are recorded before automatically sent to Session Replay
- Dynamic Snapshot Batch Size - The number of dynamic object events that are recorded before automatically sent to Session Replay
- Sensor Snapshot Batch Size - The number of sensor events that are recorded before automatically sent to Session Replay
- Fixation Snapshot Batch Size - The number of Fixations that are recorded before they are automatically sent to the Dashboard
Local Data Cache
- Save data to Local Cache if no internet connection - Enables creating a Local Data Cache file in the Application's Persistent Data Path
- Cache Size - The maximum size of the Local Data Cache. If this is at capacity, data that can't reach the internet will not be saved
- Upload Local Cache Rate - The number of outstanding data requests that will be read from the Local Data Cache and sent whenever there is a successful response from the Cognitive3D Dashboard
The Local Cache allows sessions to be recorded even without an internet connection. It is enabled by default to hold 100MB of session data and to upload that data slowly if a session is running and internet is available.
Sending Data
- Custom Gateway - Sets a custom endpoint domain for data collection. You probably don't need to change this!
Scene Export
Unity SDK 2.2 and older
This section only applies to Unity SDK 2.2 and older. In SDK 2.3 and above, scene export and upload is handled through the Scene Manager.
The currently active scene and version number is displayed. This requires the scene is exported and uploaded to Session Replay. It is generally recommended you use the Scene Setup Window to upload a scene.
- Texture Export Quality - Export and Scale required textures. Lower resolutions load faster in Session Replay
- Export Lowest LOD from LODGroup components - If LOD components are found in the scene, the lowest LOD mesh will be exported. If unchecked, the highest resolution mesh will be exported.
- Export AO Maps - Skips exporting Ambient Occlusion maps from standard shaders. These maps display with incorrect UVs when exported in the GLTF format.
- Export exports the scene to a folder in the root directory of the project. You can examine or modify the scene
- Upload uploads the scene to Session Replay (either as a new scene or a new version)
- Refresh Latest Scene Versions gets the current scene's version number and version id from Session Replay. This happens automatically after a scene is uploaded
- Scene Settings is a collection of all the scene data needed by the project
In the Unity 2.0 SDK, you can export and upload scenes through Scene Settings. You can also view the tracked scene directly in the dashboard by selecting Open Scene on Dashboard.

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.