> For the complete documentation index, see [llms.txt](https://kbase.whitelabel-loyalty.com/product/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/users/calculating-monthly-active-users.md).

# Calculating monthly active users

Understand what counts as a Monthly Active User (MAU) in the WLL platform and how this impacts usage and billing.

{% hint style="info" %}

## TLDR

If any [event](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/get-started-with-events.md) at all – intrinsic or custom – is reported for a user during the calendar month, that user is considered active and will count towards your MAU total.
{% endhint %}

***

## What is a Monthly Active User (MAU)?

MAU stands for **Monthly Active User**. It's a billing metric used to measure program usage and scale. It’s also how many WLL contracts and licences are priced.

In the WLL platform, an MAU is defined as any user who triggers **at least one** [**event**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/get-started-with-events.md) during the month. Events can include actions like making a purchase, redeeming a reward, completing a task, or any other behavior tracked by your program.

{% hint style="info" %}
MAUs are counted based on unique user IDs. If a one user triggers 50 events in one month, they still count as just **one** MAU.
{% endhint %}

***

## What counts as an event?

Any time an [event is reported](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/reporting-events.md) to the Loyalty Engine for a user, it contributes to MAU calculation.

#### System event types

These are predefined event types used internally by the platform, such as:

* `PURCHASED_REWARD`
* `REDEEMED_VOUCHER`
* `CLOSED_ACCOUNT`
* `AUDIENCE_JOINED`

These are automatically reported by the Loyalty Engine, and are triggered by platform activity. Some events may be triggered by system logic even if the user isn’t actively engaging with your program.

> For example, if you enable [**audience joined/left events**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/audiences/audience-joined-and-left-events.md) for a specific audience, those events will count toward MAU.
>
> Let’s say you create an audience of users who joined *over a year ago* and you enable audience joined events. When a user enters that audience, the platform will automatically report an `AUDIENCE_JOINED` event for that user.
>
> That means even if they haven’t interacted with your program in 6 months, they will still count as an MAU in the month that `AUDIENCE_JOINED` event is reported.

#### Custom event types

These are defined by you to track user behavior that matters to your program, such as:

* `NEW_TRANSACTION`
* `SIGNED_UP_NEWSLETTER`
* `COMPLETED_SURVEY`

You report these events using the API, and they can be used to award points, segment users, or trigger other actions through campaigns. Learn more about [custom event types](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/event-types.md#custom-event-types).

***

## What about other activity?

Unless otherwise specified in your agreement, users only count as an MAU if an event is reported against their loyalty account.

This means that simply opening or browsing your app or program interface does not necessarily cause them to count as an MAU (unless you report an event each time they access your interface).&#x20;

If you’re unsure how MAU is applied to your agreement, or how to monitor usage, contact your account manager or [WLL Support](mailto:support@whitelabel-loyalty.com).


---

# 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://kbase.whitelabel-loyalty.com/product/loyalty-engine/users/calculating-monthly-active-users.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.
