4. Install the Logger

Add the Metalitix Logger to your Babylon.js experience

Add the Metalitix Logger to your experience using HTML or NPM.

Run the below command if you have npm installed.

npm install @metalitix/metalitix-babylonjs

Copy and paste the below script tag into the <head></head> of your A-Frame project.

<script src="https://cdn.metalitix.com/logger/babylon-js/latest/babylon-js.js"></script>

Instantiate the MetalitixLogger by passing in the apiKey from your project settings found in the Metalitix dashboard. Then, start the logger session by calling startSession() and passing in the Babylon scene (BabylonScene) and your own scene (TransformNode). Your own scene is main 3D model from your experience or the parent for your scene's models.

<canvas id="renderCanvas"></canvas>
...
<script>
  ...
  const apiKey = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
  const logger = new MetalitixLogger(apiKey);
  ...
  const canvas = document.getElementById("renderCanvas");
  const engine = new BABYLON.Engine(canvas, true);
  const babylonScene = new BABYLON.Scene(engine);
  ...
  const mySceneModel = new BABYLON.TransformNode("mySceneModel");
  ...
  logger.startSession(babylonScene, mySceneModel);
</script>

Metalitix will record camera movement relative to your scene object's transformations. So, it is not necessary to manually calibrate the scene in the [Metalitix dashboard](https://app.metalitix.com/). If you do not pass a scene object, then recorded camera movement will be in world coordinates and manual calibration may be necessary.

Metalitix is now configured to gather analytics on your project! 🎉 To test, engage with your experience to create a session. Then, navigate to the Sessions tab within your project on the Metalitix dashboard. Within a few minutes, you will see your session appear at the top of the table. It will be marked as Active until the session ends. When a session no longer says Active, its data will appear on the Metrics tab. Heatmap data, on the other hand, is calculated in real-time for small projects and every 24 hours for large projects.

Previous3. Allowing Domains NextCustom Metrics

Last updated 4 months ago