> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/analytics-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/analytics-docs/content-specific-analytics/learning-story-logs.md).

# Learning Story Logs

## Learning Story Logs

**Story Logs allow you to access a detailed account of every user's interaction with a story.**

## How to view Logs

**Open Analytics, open a Story, and access the Logs section from the left-hand menu.** View more detailed (and archived) logs by selecting the options icon on the log, and then selecting View Log.

{% embed url="<https://cdn.falkor.io/uploads/2019/12/cloud-file-2686/5f7a540ec195fbb4f8fc848d51f7de8d.mp4>" %}

## **Log Status**

**Story Logs** allow you to see the **state/progress** of each user.&#x20;

| Story Progress State | Description                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Started**          | Indicates that the user is busy doing the story for the first time.                                                                |
| **In Progress**      | Indicates that the user has started the story.                                                                                     |
| **Completed**        | This indicates that the user has completed the story (this will show in the export data).                                          |
| **Archived**         | Old logs of previous story versions that a user has completed. Logs are archived once a user completes a newer version of a story. |

{% hint style="warning" %}
**Whenever a user chooses to Redo a story, their progress will be reset.** Results from the redo will overwrite the user's previous log, and old logs will be archived.&#x20;
{% endhint %}

## Log Options

{% embed url="<https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LkZMvKQ0GKsnh74M3pT%2F-MCCP3exVVlhWFnWhuHL%2F-MCCQK7ivUvTQl8mwLN7%2FScreenshot%202020-07-14%20at%2015.02.37.png?alt=media&token=414fac08-1474-4515-895e-b12cdd7f10c0>" %}
Select the cogwheel icon to view options
{% endembed %}

| Story Log Option      | Description                                                                               |
| --------------------- | ----------------------------------------------------------------------------------------- |
| **View Log**          | View an individual user's story log                                                       |
| **Force Complete**    | If you want to set the user's status to "complete"                                        |
| **Delete Story Data** | If you want to remove the user's recorded data based on their interaction with the story  |
| **Delete App Data**   | If you want to remove the user's recorded data from their interaction with a platform app |

## Export Logs

**To export the story logs, simply select the export icon (top right) from the Logs section.**

<figure><img src="https://1578161750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNavXnju7lDmx1C2QHvrU%2Fuploads%2FlttTAdIrV8oLJSU8OoIH%2Fimage.png?alt=media&amp;token=cc501df1-99b4-40b8-b3ed-dd0539498eaa" alt=""><figcaption></figcaption></figure>

### **What does the Log .csv export contain?**

| Column           | Log description                                                                   |
| ---------------- | --------------------------------------------------------------------------------- |
| **Firstname(s)** | User's first name(s)                                                              |
| **Lastname**     | User's last name                                                                  |
| **Status**       | In Progress, Completed, Redoing                                                   |
| **Passed**       | Passed / Failed                                                                   |
| **Attempts**     | Number of attempts (if allowed)                                                   |
| **Duration**     | Time taken to complete (hh:mm:ss)                                                 |
| **Score**        | User's score expressed as a percentage                                            |
| **Last update**  | Date & time when the last story attempt was completed                             |
| **Version**      | [Story build version](/analytics-docs/content-specific-analytics/story-builds.md) |

## Export Group Logs

From [Analytics](/analytics-docs/analytics-explained/real-time-analytics.md), you can export logs per [Group](https://everyday-digital.gitbook.io/groups-cohort-docs/groups/creating-groups).

Exporting Group Logs means that you are **exporting users from all groups and comparing content/pathway records**.

The **export** is delivered in a **.csv** format and contains the following data:

* **Firstname** - User's first name&#x20;
* **Lastname** - User's last name&#x20;
* **Age** - User's age (if supplied)&#x20;
* **Email** - User's email address&#x20;
* **Telephone** - User's telephone number (if supplied)&#x20;
* **Country** - User's country of origin&#x20;
* **City** - User's city of origin&#x20;
* **Registered** - Date and time of user's account registration/sign up&#x20;
* **Group Status** - Active or Nudged&#x20;
* **Groups** - List of all groups a user has been added to&#x20;
* **Status** - Started (the user has opened the content/pathway), In Progress (the user has at least completed 1 page/activity), Complete, or Empty.
* **Progress** - Percentage completed&#x20;
* **Last Update** - Date and time of user's last recorded activity

{% hint style="info" %}
User rows with an empty status mean they have not opened or engaged with the content/pathway.
{% endhint %}

### Step-by-Step Group Log Export

1. **Open Analytics and select Groups.**
2. **Select the first group icon, top right.**&#x20;

<figure><img src="https://1578161750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNavXnju7lDmx1C2QHvrU%2Fuploads%2FdLvW8VGc6gcrdI8sl9fx%2Fexport%20group%20logs.png?alt=media&amp;token=1d1f1d48-e220-4518-8d94-ad0cef014147" alt=""><figcaption></figcaption></figure>

3. **Set the preferred format and content types.** The Format Options include Grouped Logs (Default), which formats the logs by group, and Inline Logs, which lists content types in a column. Choose the Content Types that should be included in your export of logs.

![](https://1578161750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNavXnju7lDmx1C2QHvrU%2Fuploads%2FNhsXAetsI0rB0jvuDmNP%2Fexport%20group%20log%20preferences.png?alt=media\&token=42234179-1d0f-43b5-9363-3e2b2a700da6)

4. **Select Export to download the group logs.**

## Build Analytics

**To see a specific release/build, you can select one using the filter option.** By default, all builds are loaded for analysis.&#x20;

Next to the question title you can see the range of builds being displayed.

{% embed url="<https://cdn.falkor.io/uploads/2021/08/cloud-file-8429/d4e9fa60b3ca799c2e8acc4dcad2b204.mp4>" %}

## Individual User Results & Logs

| User Log          | Description                                 |
| ----------------- | ------------------------------------------- |
| **Highest Mark**  | Highest mark achieved by a user             |
| **Average Mark**  | User average                                |
| **Lowest Mark**   | Lowest mark achieved by a user              |
| **Average Time**  | Average time required to complete the story |
| **Lowest Mark**   | Lowest mark achieved by a user, per chapter |
| **Average Score** | Average score, per chapter                  |
| **Highest Score** | Highest score achieved, per chapter         |

### **View Log, Delete Story Data, or Delete App Data**

Select View Log via the cogwheel icon to see the exact logs uploaded from the user's app.

| Log Type              | Log Detail                                            |
| --------------------- | ----------------------------------------------------- |
| **View Log**          | Time taken to complete each page                      |
|                       | Total score, max score and percentage                 |
| **Delete Story Data** | When last the log was updated                         |
| **Delete App Data**   | Delete a user's complete story logs (for all stories) |

<figure><img src="https://1578161750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNavXnju7lDmx1C2QHvrU%2Fuploads%2FrdRaNEzb5nOAGVNW5YEZ%2Fimage.png?alt=media&amp;token=e9b6d73a-4808-4fa9-8805-9aaaa941896a" alt=""><figcaption></figcaption></figure>

<br>