Analytics
This page describes how you can utilize the tools within Emperia 3D Kit to enhance the analytics and the data that gets reported to the client.
Interactable Component
Most IC (Emperia 3D Kit Interactable Components) has analytics tracking built in. ICs that have the type of Navigation, Product, Text, and Clickable have tracking enabled on them automatically, and you do not need to do anything. Please note they use the Description field on the components, so it is crucial that the field is filled in and has very clear naming.
Rooms
To understand where in the space are actions happening, certain areas of the 3D environment are defined in ‘Rooms’. These ‘Rooms’ are essentially bounding boxes, which also let you define a name for a specific room.
Properties
Name | Values | Usage |
ID | Read-Only | Unique ID of the object. |
Name | String | A human-readable name will be used for reporting. Example: ‘Beauty & Accessories’, ‘Fragrance Room’. |
Room objects get defined by setting the room name, for example, ‘Beauty & Accessories’, defining the extent of that room, so it would encompass all the elements that are inside the Room. These Room objects are crucial for clarity when it comes to Analytics and tracking where events & actions happen.
The AR model allows you to visualize 3D models within the experience.
To create a new AR model, follow these steps:
- Right-click in the Content Browser.
- Go to Miscellaneous → Data Asset.
- Search for "ARModel" and select the corresponding type.
- Click "Create" to generate the asset.
- The AR Data Asset contains all necessary configurations for the AR Viewer.
Key | Description |
MeshURL | The URL or references for the 3D Mesh to display in the AR model. |
iFrame Model
The iFrame model allows you to embed websites or iframes within the experience.
To create a new iFrame model, follow these steps:
- Right-click in the Content Browser.
- Navigate to Miscellaneous → Data Asset.
- Search for "iFrame" and select the appropriate type.
- Click "Create" to generate the asset.
- The iFrame Data Asset contains all necessary configurations for the iFrame Viewer.
Key | Description |
URL | The URL or references for the web page to display in the iFrame model. |
Media Model
The Media model allows you to embed videos and images within the experience.
To create a new Media model, follow these steps:
- Right-click in the Content Browser.
- Navigate to Miscellaneous → Data Asset.
- Search for "Media" and select the appropriate type.
- Click "Create" to generate the asset.
- The Media Data Asset contains all necessary configurations for the Media Viewer.
Key | Description |
URLs | The URL or references for the Videos, Images to display in the Media model. |
Automated Action Model Creation Process
To streamline the process of creating action models, assets, and attaching them to interactables, we now support direct editing within the Details Panel of interactables placed in the scene.
Using the Action Type dropdown, you can specify the type of interactable action. Once selected, the relevant properties will appear below the dropdown for configuration. This automatically creates and attaches the corresponding action models and action type assets to the interactable, significantly reducing the number of steps required.
If you forget to save your action models or action type assets, you can simply clear the action models array on the interactable and make a slight modification to any Action Type property. This will automatically regenerate the entire asset.
Help & Support
If you have questions, suggestions, or feature requests, please join the Official Emperia Discord channel!
You can find support here through private support tickets or general conversation. You will also have the opportunity to showcase your work and chat with like-minded individuals across industries using Creator Tools, Unreal Engine, those creating immersive experiences, and more!
If you prefer, you can also reach out to us via email.