Skip to content

Properties

You can set user properties and device metadata via a simple API.

User Identification

Identifying users is key to tracking their behavior across multiple sessions and applications.

User ID: This should be a unique, persistent identifier for each user.

c3d.userId = 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6';

User Name: This is a friendly, human-readable name to label the user's session on the dashboard. If you don't set one, a random name will be generated for you.

c3d.setUserName("John Smith");

Session Properties

You can also set properties that are specific to a single session.

Session Name: A descriptive name for the session, which can be useful for A/B testing or identifying specific playthroughs.

c3d.setSessionName("Onboarding Tutorial - Version B");

Lobby ID: If your application has multiplayer or shared social spaces, you can use this to group all users who were in the same lobby.

c3d.setLobbyId("Lobby-Alpha-42");

Custom User Properties

You can attach any custom key-value data to a user. This is perfect for tracking demographics, user progression, or experimental groups.

// The key is a string, and the value can be a string, number, or boolean.
c3d.setUserProperty('Age', 34);
c3d.setUserProperty('PlayerClass', 'Mage');
c3d.setUserProperty('HasCompletedTutorial', true);

Device Properties

The SDK automatically captures some device information, but you can also set properties manually to provide more specific details.

// A friendly name for the device being used
c3d.setDeviceName('My Custom VR Rig');

// Set a specific, known property
c3d.setDeviceProperty('AppName', 'VR-Training-Sim');
c3d.setDeviceProperty('AppVersion', '2.1.0');

Standard properties

The following properties are automatically tracked:

  • AppEngine (Three.js, Wonderland, etc...)
  • AppEngineVersion
  • DeviceType
  • AvailableDeviceMemory
  • DeviceOS
  • DevicePlatform
  • AvailableDeviceCPUCores
  • DeviceCPUVendor
  • DeviceGPU
  • DeviceGPUVendor
  • DeviceScreenHeight
  • DeviceScreenWidth
  • VRModel
  • VRVendor

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.