> For the complete documentation index, see [llms.txt](https://wiki.letsterra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.letsterra.com/product-features/analytics-ninja.md).

# 📈 Analytics Ninja

Ask natural language questions about your game — no SQL, no schema headaches.

<a href="https://flow.letsterra.com/" class="button primary">Visit Website</a> <a href="https://cal.com/terra-demo/30min?overlayCalendar=true" class="button secondary">Schedule a demo</a>

### Feature Overview

Analytics Ninja transforms game analytics from manual SQL workflows into conversational intelligenc&#x65;**.** Connect your existing analytics platform, ask questions in plain English, and get precise answers with rich visualizations—no code required.

***

### Core capabilities&#x20;

#### 🧠 **Intelligent Schema Discover:**&#x20;

Automatically reconstructs your data model and fills knowledge gaps without manual documentation.

#### 🎮 **Gameplay Flow Auto-Detection:**&#x20;

Discovers user journeys from event sequences - no manual mapping required.

#### 💬 **Conversational Analytics Interface:**&#x20;

Natural language queries with business context awareness across guided and free-form modes.

#### 🔄 **Persistent Learning & Memory:**&#x20;

Gets smarter with every interaction, building permanent institutional knowledge.

## User Flow

### Phase 1: Initial Setup&#x20;

{% stepper %}
{% step %}
**Step 1 : Login with Google ID**

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FuVda6FtAGZlebzy47Lej%2FScreenshot%202025-08-22%20at%2010.50.26%E2%80%AFAM.png?alt=media&amp;token=5861fb70-46fc-4abb-8c86-00223e5925ab" alt="" width="253"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Step 2: Connect to your data source**

* Select analytics platform from visual grid
* Enter platform-specific credentials
* Instant validation and data access confirmation

<div data-full-width="true"><figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FOlwNx8BVD7q1Qif8bafZ%2FScreenshot%202025-08-22%20at%203.02.52%E2%80%AFPM.png?alt=media&amp;token=67f22fc7-2d94-4b81-9e5c-300ffccb21b7" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FTNOdZefexztwNSUlQdPi%2FScreenshot%202025-08-22%20at%203.03.31%E2%80%AFPM.png?alt=media&amp;token=c0aba9eb-faaf-492c-a17a-304ecc876063" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FhNKtBHbZzqNLHNwYkB3K%2FScreenshot%202025-08-22%20at%2011.25.07%E2%80%AFAM.png?alt=media&amp;token=d08af7ce-cbd7-49a9-8de5-eb6c9aa5fc13" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Step 3: Schema Enhancement (Optional)**

* Upload existing documentation for enhanced accuracy
* Skip to AI-powered analysis if no docs available
* 10-minute processing for automatic schema reconstruction

<div><figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FCsIILFoCpqBkDyWJsIqM%2FScreenshot%202025-08-22%20at%203.03.40%E2%80%AFPM.png?alt=media&amp;token=e548816e-ba13-49d5-93e0-c5160e5703fa" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2F1YWPmvCGYdzkAhpvdzQv%2FScreenshot%202025-08-22%20at%203.03.48%E2%80%AFPM.png?alt=media&amp;token=a4be8ed4-e1fb-465b-b1d1-b090bb56525e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Step 4 : Allow for data processing**&#x20;

This may take upto 10 minutes

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FR8eg1NIxcPDlkSqsBxUv%2FScreenshot%202025-08-22%20at%203.03.54%E2%80%AFPM.png?alt=media&amp;token=6f3e28bb-33aa-4294-89b0-29a6a29a2cf7" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Phase 2: Resolve ambiguities

{% stepper %}
{% step %}
**Step 1: View all the flagged events & ambiguities**

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FJzPIbMi75WK28U6BMZhu%2FScreenshot%202025-08-22%20at%203.04.20%E2%80%AFPM.png?alt=media&amp;token=a762ace0-463b-4cb6-8667-b6971ada1744" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Step 2: Event Clarification (2-3 minutes)**

* Review 3-5 flagged ambiguous events
* Confirm or correct AI interpretations

<div><figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FEWzs1wp1LhwpC3D0fd5n%2FScreenshot%202025-08-22%20at%203.04.40%E2%80%AFPM.png?alt=media&amp;token=2b5f1e25-1aa6-4e0e-a8f7-3471643cba78" alt=""><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FEJ7z7r0nAKY2ztuJ48Gy%2FScreenshot%202025-08-22%20at%203.05.05%E2%80%AFPM.png?alt=media&amp;token=3347582c-a676-4257-b72a-75e6a0c77114" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Step 3: Provided business and product Context**&#x20;

* Validate auto-detected game type
* Add optional context (monetization, audience, features)
* Set terminology preferences

<div><figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2F7iRvJOHsDqCaKUUKAG8Y%2FScreenshot%202025-08-22%20at%203.05.16%E2%80%AFPM.png?alt=media&amp;token=ee41603f-9542-4432-94b9-d24c2abb6989" alt=""><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FqbCbX7VSDZeb0Al44e7q%2FScreenshot%202025-08-22%20at%203.05.39%E2%80%AFPM.png?alt=media&amp;token=95257703-ab05-47c7-8730-6e56fd9ab2e0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Step 4: Validate user journey**

* Review 5-7 auto-discovered gameplay / user journeys
* Edit event sequences as needed
* Approve flows for analysis use

<div><figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FgzByVa7ZxMJuaKWkU6eD%2FScreenshot%202025-08-22%20at%203.07.53%E2%80%AFPM.png?alt=media&amp;token=b16cfbfd-2643-4e19-8051-f3f024c3e579" alt=""><figcaption></figcaption></figure> <figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FZfweY6Gu0QtExmW2DRdi%2FScreenshot%202025-08-22%20at%203.36.51%E2%80%AFPM.png?alt=media&amp;token=fcdc18da-f2b1-4f8f-9495-e27b15684a59" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Phase 3:  Ask questions & get insights

{% stepper %}
{% step %}

#### **Guided Mode: Step-by-Step Validation**

&#x20;Best for complex analysis where accuracy is critical and you want to verify each step

How it works:

* AI breaks down your query into logical steps
* Confirms data interpretation and business logic at each stage
* Validates event selection and filtering criteria with you
* Ensures analysis methodology aligns with your expectations before proceeding

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FhF7D5klKNKiVmGVXxYMk%2FScreenshot%202025-08-22%20at%203.40.08%E2%80%AFPM.png?alt=media&amp;token=934fef17-c003-4b58-bea8-a3e7a04d437f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **One Shot Mode: Complete Autonomous Analysis**

Best for well-defined questions where you trust the AI to handle all interpretation and analysis decisions

How it works:

* AI processes your complete query independently
* Makes all data interpretation and methodology decisions automatically
* Delivers comprehensive analysis without intermediate confirmations
* Uses learned business context to resolve ambiguities

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2Fo7rB1ipdZfd1b1nAyOR9%2FScreenshot%202025-08-28%20at%206.00.55%E2%80%AFPM.png?alt=media&amp;token=441072c4-eccb-44ce-8da5-b69007cc0c26" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Ask any question about your data

Enter your query in plan English.&#x20;

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2F05I6NTCEi9OccA6Z9yUy%2FScreenshot%202025-09-01%20at%202.49.05%E2%80%AFPM.png?alt=media&amp;token=151db6d8-bf1e-4b1d-bd53-b868b4ee5c17" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Get a detailed analysis with visualization

You can follow-up and ask more questions for details&#x20;

<figure><img src="https://3777505098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGd8RR9TPbiGza2LHqkh7%2Fuploads%2FxdmHeSGb4lGBTyKGLvmb%2FScreenshot%202025-09-01%20at%202.48.53%E2%80%AFPM.png?alt=media&amp;token=6ab1fdff-f0be-44d0-9972-ae07c634f8c8" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
