> For the complete documentation index, see [llms.txt](https://machinations.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://machinations.gitbook.io/docs/machinations-up/key-features/game-aware-analytics.md).

# Game-Aware Analytics

{% hint style="warning" %}
This feature is under heavy development and is considered unstable.
{% endhint %}

Game-Aware Analytics allows you to record any **Game** or **Game Object** *State Changes* and *Events*. 

Sets of data may be saved during various key-points. You will also be able to import Analytics data from other providers.

**Game-Aware Analytics** provides game designers a new way of understanding valuable gameplay data. We have devised a way to supercharge analytics data by mapping it onto Machinations diagrams, so you can see exactly how your changes impact the game.

You can use this throughout your game's lifecycle.

### During Prototyping & Development

1. Collect the data from internal/beta play testing, analyse it and make the initial tweaks based on it
2. Test different design models and see how they fare against each other

### Post-launch

1. Balance your game based on real player behaviour data

This is based on our **Machinations Inference Protocol,** which allows you to **debug** and **fine-tune** a diagram by employing **Machinations Game Analytics**. You can connect Diagram elements to formulas defined in **UP**. The resulting values can be synch’ed back to the Diagram. This process can signal if there are unexpected differences between the diagram and the game.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://machinations.gitbook.io/docs/machinations-up/key-features/game-aware-analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.