> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/gamification-basics/activity-log.md).

# Activity Log

## Activity Log

The Activity Log is a complete history of everything a player does in gamification. It covers transactional changes to points, gems and diamonds, as well as gamification changes like missions, tasks, badges, levels, leaderboards, tournaments, clans, mini-games, prize drops, raffles, jackpots and avatars. Players see their own history in the widget, and operators see the history of every player in the Back Office.

A clear history reduces support questions about "missing" rewards and makes the player experience more transparent.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FkBBL3HUxuGrzdn3HbCX1%2FScreenshot%202026-11-04%20154207.png?alt=media&amp;token=6f353acb-3e7e-44d9-bb6e-4f1cd198f6d2" alt=""><figcaption></figcaption></figure>

### What is logged

<table data-search="false"><thead><tr><th>Area</th><th>Events in the log</th></tr></thead><tbody><tr><td>Points, gems and diamonds</td><td>Awarded, deducted or set, with the amount and the balance after the change</td></tr><tr><td>Missions</td><td>Unlocked, completed</td></tr><tr><td>Tasks</td><td>Completed</td></tr><tr><td>Badges</td><td>Completed</td></tr><tr><td>Levels</td><td>Upgraded, downgraded</td></tr><tr><td>Leaderboards</td><td>Won</td></tr><tr><td>Tournaments and clan tournaments</td><td>Registered, registration cancelled, won</td></tr><tr><td>Clans</td><td>Joined, left</td></tr><tr><td>Mini-games</td><td>Attempts (spins) given or used, prizes won, no-prize results</td></tr><tr><td>Raffles</td><td>Tickets given, registered for a draw, prize won</td></tr><tr><td>Jackpots</td><td>Opted in, won</td></tr><tr><td>Avatars</td><td>Received</td></tr><tr><td>Store and prize drops</td><td>Tangible prizes and prize drop prizes won</td></tr></tbody></table>

Rewards that a mission, badge, tournament or raffle gives in points, gems or diamonds appear as their own entries (for example **Points awarded from Mission**), next to the event that triggered them.

{% hint style="info" %}
Bonuses are not shown as separate entries. When a bonus gives points, gems or diamonds, the log shows the change of that balance. Hidden tasks that only unlock a mission or badge are not shown either.
{% endhint %}

### In the widget

Players open the **Activity log** section from the widget menu. Each entry shows:

* **Activity**: an icon and the type of event, for example **Points awarded**, **Mission completed**, **Level upgraded**, **Raffle won,** **Clan joined,** e**tc.**
* **Source**: where the event came from. For balance changes this reads **from Mission**, **from Store**, **from Raffle**, **from Avatar**, **from Clan** and so on. For missions, tasks, badges, raffles, leaderboards and levels it shows the name of the item, for example the mission name or the new level.
* **Amount**: the value added (green) or deducted (red), for balance changes.
* **Balance**: the balance right after the change, with the wallet icon.
* **Time**: when it happened. Entries are grouped under a header per day, newest first.

Sources with a link icon open the related item in the widget: a mission opens its details, a store purchase opens the **Store**, and so on.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FZG8A1sjVamj0CAtwKjxX%2FGIF%20for%20Redirection%20of%20RN%202.gif?alt=media&amp;token=38478b8d-41ee-43d3-85b8-21cfd6a3ad96" alt=""><figcaption></figcaption></figure>

#### Filters

Two filters sit at the top right of the section:

* **Category**: **All** *(default)*, **Missions**, **Badges**, **Levels**, **Leaderboards**, **Tournaments**, **Clans,** **Mini-games, Prize drop, Raffles, Jackpots, Avatars, Diamonds, Gems, Points**.
* **Time period**: **Today**, **This week** *(default)* or **Previous week**. A week runs from Monday to Sunday.

#### Source names shown to players

<table data-search="false"><thead><tr><th>Source of the change</th><th>Shown to the player as</th></tr></thead><tbody><tr><td>Mission, mission task</td><td>from Mission (with a link to the mission)</td></tr><tr><td>Store purchase</td><td>from Store (with a link to the Store)</td></tr><tr><td>Mini-game</td><td>from Mini-game</td></tr><tr><td>Raffle</td><td>from Raffle</td></tr><tr><td>Jackpot</td><td>from Jackpot</td></tr><tr><td>Tournament, clan tournament</td><td>from Tournament</td></tr><tr><td>Leaderboard</td><td>from Leaderboard</td></tr><tr><td>Clan</td><td>from Clan</td></tr><tr><td>Avatar</td><td>from Avatar</td></tr><tr><td>Campaigns, automation rules, manual adjustments, API, dynamic formulas, refunds</td><td>from Marketing</td></tr></tbody></table>

#### Showing the section

In the Back Office, go to your label or brand settings and open **Section visibility**. Turn **Activity log** on to show it in the widget menu, and set its position relative to the other widget sections.

### In the Back Office

Go to **CRM → Gamification → Activity log** to see the activity of all players of the label.

{% hint style="info" %}
The Activity log replaces the earlier **CRM → Gamification → Points** page. It keeps everything the points log showed (points, gems and diamonds with amounts and balances) and adds missions, tasks, badges, levels, leaderboards, tournaments, clans, mini-games, prize drops, raffles, jackpots and avatars, with new filters by activity type and change type.
{% endhint %}

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FnOpTNJfEZKCJutwBb6so%2Fimage.png?alt=media&amp;token=7a834563-c13f-4734-8dde-c083b3659db8" alt=""><figcaption></figcaption></figure>

#### Filters

When you select some activity types, an extra filter appears for the kind of change:

<table data-search="false"><thead><tr><th>Activity type selected</th><th>Extra filter</th><th>Options</th></tr></thead><tbody><tr><td>Points, Gems or Diamonds</td><td><strong>Operation type</strong></td><td>Add, Deduct, Set</td></tr><tr><td>Mission</td><td><strong>Mission change type</strong></td><td>Unlock, Complete</td></tr><tr><td>Task</td><td><strong>Task change type</strong></td><td>Unlock, Complete</td></tr><tr><td>Level Changed</td><td><strong>Level change type</strong></td><td>Increase, Decrease</td></tr><tr><td>Tournament</td><td><strong>Tournament change type</strong></td><td>Join, Cancelled, Win</td></tr><tr><td>Clan Tournament</td><td><strong>Clan change type</strong></td><td>Join, Kick</td></tr><tr><td>Raffle</td><td><strong>Raffle change type</strong></td><td>Registration, Win, Give Tickets</td></tr><tr><td>Jackpot</td><td><strong>Jackpot change type</strong></td><td>Registration, Win</td></tr></tbody></table>

An extra filter only narrows its own activity type. For example, **Mission change type: Complete** removes mission unlocks but keeps all other selected activity types.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2F6q8G2IDxZt8u1K84WbLV%2Fimage.png?alt=media&amp;token=3c9dd6cd-a1c6-4e61-822f-d12f02f0eea3" alt=""><figcaption></figcaption></figure>

#### Export

Click the **Export data** icon at the top right to export the filtered list. The export is prepared in the background, and you can download it from **Exports History**.

### In the player profile

Open a player from **CRM → Users search** and go to the **Activity log** tab. It shows the same list and filters for that player only, without the user filter.

The **Points log** and **Progress** tabs of the player profile are deprecated, as the **Activity log** tab covers everything they showed.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FnhbOYCZyZXQbUclhZnr8%2Fimage.png?alt=media&amp;token=a3531e4f-a69b-43fd-99b9-331ebbfd3589" alt=""><figcaption></figcaption></figure>

### API

The activity log is also available through the External API at `/api/external/activity_log/v1`, with the same activity types and change types as the Back Office. The earlier endpoint `/api/external/user_points/history/v1` still works for points history.

### Frequently Asked Questions

**Q: Can players click an entry to open the mission or other item?**

A: Yes. Sources with a link icon open the related item in the widget. For example, a mission opens its details and a store purchase opens the Store.

**Q: Why do some changes show "from Marketing" instead of a campaign name?**

A: Changes made by campaigns, automation rules, manual adjustments, the API, dynamic formulas and refunds are grouped under "from Marketing". This keeps the player view clean and keeps internal names private. In the Back Office, the **Changes source** column shows the exact campaign or rule.

**Q: Why don't I see a bonus in the log?**

A: Bonuses are not listed as separate entries. If a bonus gave points, gems or diamonds, the log shows that balance change.

**Q: How far back can players or operators see history?**

A: In the widget players choose between **Today**, **This week** or **Previous week** (Monday to Sunday). In the Back Office you can view any period of up to 30 days at a time. Records are kept for up to 1 year and start from July 2026.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/products/gamification-basics/activity-log.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
