> For the complete documentation index, see [llms.txt](https://docs.adlibertas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adlibertas.com/the-platform/user-level-audience-reporting/creating-reports/creating-a-new-user-report.md).

# Creating a New User Report

<img src="/files/55gRbOW79DtyPU0lQqiL" alt="" data-size="original">

Your first step in user-level reporting will be to create a new user report, either in the main menu or on the home page, click "Create New User Report"

## Name and App Filter

Report names don't need to be unique but we highly recommend you consider a naming scheme that allows easy search functionality.

{% hint style="info" %}
When selecting an app, you will filter all events, conditions, and properties to only the app selected. If you don't choose an app, users will be included across all apps.
{% endhint %}

![](/files/dZDW3S2S9kNsO7Ir2HPP)

## Date Ranges

The date range selected in the Absolute Date Range will include users active during the chosen range. For details on the Advanced functionality, see [<mark style="color:blue;">Absolute vs. Relative Reports</mark>](https://docs.adlibertas.com/the-platform/user-level-audience-reporting/absolute-vs.-relative-reports)<mark style="color:blue;">.</mark>

![](/files/WbfXdqznzVmB0Ul6FxDx)

## Create Audience Grouping

Here you can choose groups that will define individual audiences, one for each parameter value of the group. Choosing a single group, in our example, an AB test will automatically create an individual group for each test variant.

![](/files/hkCSirtOZK2oR0p0wb0j)

Selecting multiple groups will create an audience for each unique parameter value. In our example, grouping on an experiment + geo will create an audience for **each variant and each geo.**

For groupings that generate over the maximum number of audiences (15), only the largest groups will be returned.

![](/files/e1kGkFQESlFRwJeX4f0I)

## Email Notification

We will send an email to each address when the report is completed or updated. Especially useful when you've created a scheduled report to be updated periodically.

![](/files/d6iAKZIlm8jcW7ui4FRF)

## Filter Created Audiences

![](/files/hUMvviLfP1viFSwRhdwC)

**Maximum number of users in audience:**  We allow you to filter to audience groupings above a minimum number of users.

**Maximum number of audiences, ranked by the number of users:**  Because the UI lags with too many reports, we limit the maximum number of audience groupings to 15.&#x20;

{% hint style="info" %}
If you'd like to run reports with more than 15 audiences (e.g. campaign and ROAS reporting) please contact your AdLibertas account manager to schedule csv reporting.
{% endhint %}

## Walk-through creating a report

{% embed url="<https://youtu.be/uM5xMKZ5adE>" %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.adlibertas.com/the-platform/user-level-audience-reporting/creating-reports/creating-a-new-user-report.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
