> For the complete documentation index, see [llms.txt](https://docs.helix.voodoo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helix.voodoo.io/user-acquisition/monitor-and-optimize-performance/view-reports.md).

# View Reports

Consolidated view of user acquisition performance across spend, efficiency, and monetization.

User acquisition reports consolidate performance across spend, efficiency, and monetization. Use them to assess organization-wide results for a selected time range and filters.

Reports combine key KPIs, trends, spend distribution, recommendations, and campaign-level spend data.

To view reports, navigate to **User Acquisition → Reporting**.

***

## Recommendations

The **Recommendations** panel surfaces important campaign events and operational signals, such as:

* Daily budget limits being reached
* Delivery or pacing changes
* Campaign or ad set status updates

Each item links directly to the relevant campaign or ad set so you can act immediately.

***

## Key metrics

* **eCPI** — Average cost per install.
* **Spend** — Total advertising spend.
* **Revenue (IAP + Ads)** — Revenue generated by acquired users.

***

## Trend analysis

The **Trend** chart shows performance over time:

* **Spend** (bars)
* **Revenue** (line)
* **ROAS** (line)

Use it to spot pacing changes, revenue lag, and efficiency trends.

***

## Campaign spend trend

The **Last 30 days Spend trend by campaign** table compares spend across rolling windows. Use it to identify accelerating and slowing campaigns.

| Column                | Definition                                                                                       |
| --------------------- | ------------------------------------------------------------------------------------------------ |
| Campaign              | Campaign name.                                                                                   |
| 30-day spend ($)      | Total spend during the last 30 days.                                                             |
| 14-day spend ($)      | Total spend during the last 14 days.                                                             |
| 14-day / 30-day ratio | Share of 30-day spend that occurred in the last 14 days. Above 50% indicates accelerating spend. |
| 7-day spend ($)       | Total spend during the last 7 days.                                                              |
| 7-day / 14-day ratio  | Share of 14-day spend that occurred in the last 7 days. Above 50% indicates accelerating spend.  |

{% hint style="info" %}
All currency related values are in USD.
{% endhint %}

***

## Spend distribution

Distribution widgets show how spend is split across key dimensions:

* **Spend by Promoted App** — Spend across advertised apps.
* **Spend by Source App** — Spend across inventory sources, or apps displaying ads.
* **Spend by Country** — Spend by user location.

Each widget includes:

* A donut chart for comparison.
* A ranked list with each item's percentage share.
* Total spend at the center.

***

## Filters and breakdowns

Use the filter bar to refine and segment reporting data.

### Time filters

* **Date range** — Select a predefined or custom range.
* **Date grouping** — Aggregate results by hour, day, week, month, year, or another interval.

### Campaign structure

Filter or break down data by:

* **Campaign**
* **Campaign ID**
* **Ad**
* **Ad ID**

### App and geography

Segment performance by:

* **Promoted App**
* **Source App**
* **Country**

Combine filters to analyze a precise segment. For example, review one promoted app in one country.

{% hint style="info" %}
All values update dynamically as filters change.
{% endhint %}

***

## Export reports

Export each report as **CSV**, **XLSX**, or **JSON**. Export reports with visualizations as **PNG**.

Select the **three-dot menu** in a report's top-right corner. Then choose an export format.

***

{% hint style="info" %}
**Typical Use Cases**

* **Daily health check** — Review spend, ROAS trends, and recommendations.
* **Budget allocation** — Compare spend by promoted app and country.
* **Pacing check** — Identify accelerating or slowing campaigns.
* **Investigation** — Open a campaign to review delivery and breakdowns.
  {% endhint %}


---

# 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.helix.voodoo.io/user-acquisition/monitor-and-optimize-performance/view-reports.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.