> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build a report

> Build a report in Cometly's Report Builder: pick a report type, date range, metrics, sources, filters and attribution, then save it to a dashboard.

The Report Builder is where you turn the data Cometly tracks into a chart or table. To build a report in Cometly's Report Builder, you pick a report type, a date range and the metrics to show, then decide how the numbers are filtered, attributed and grouped. This guide covers every section in order.

A report answers one question about your marketing, such as which source produced this week's leads or which ad creative brought in the most purchases. Once it is saved to a dashboard, you can check the answer at any time and see where your ad budget is working.

To open it, click **Report Builder** in the sidebar. The settings are in the left panel, on the **Report** tab, and the preview is on the right.

## Step 1: Select a report type

Select a report type. There are **8 report types** to choose from:

* Line
* Column
* Bar
* Combo
* Area
* Pie
* Table
* KPI Summary

## Step 2: Select a date range and metrics

Select the **Date Range** the report covers, then add the metrics you want to include under **Metrics**.

Every metric in your Cometly account is in the metrics list, in four groups: **Analytics Metrics**, **Ad Metrics**, **Conversion Metrics** (which includes your custom events; an event is an action Cometly records for a contact, such as a lead or a purchase) and **User Defined Metrics**.

> [!TIP]
>
> There are many metrics. Type in the search box to narrow the list.

With **Report Metrics By**, you choose whether metrics are counted by **Contact** or by **Company**.

## Step 3: Select sources (optional)

Selecting sources is optional. Leaving **Sources** empty is the same as **All Sources**.

You can select as many or as few sources as you want.

## Step 4: Add filters (optional)

Filters narrow the report down. They come in three groups: **Contact**, **Ad** and **Activity**.

**Example:** you are analyzing this week's purchases and want to see how many came from the United States. Add a **Country** filter set to United States.

A few useful filters:

* **Country:** narrow the report to specific countries.
* **URL:** see how specific landing pages perform. Choose **URL**, then **contains**, and enter a word from the URL of your landing page.
* **Campaign Name**, **Ad Set / Ad Group Name** or **Ad Name:** filter by the naming conventions in your campaign, ad set or ad names. If you name your ads consistently, this lets you filter by audience, ad copy, headline or creative. For example, **Ad Name** > **contains** > `Red Image` shows the performance of every ad that uses the "Red Image" creative.
* **Date filters:** each event has date filters, such as **First Purchase Date** or **First Lead Date**, that tell you when a contact first purchased or first became a lead. **Original Source Date** and **Latest Source Date** tell you when a contact first and last engaged with you.

## Step 5: Select an attribution model and window

> [!NOTE]
>
> **Attribution** means giving credit to the ad or channel that influenced a customer's conversion.

An attribution model is the rule that splits credit across the marketing touchpoints in a customer's journey. It helps you judge how effective each channel is, so you can spend your budget where it works.

Cometly offers 8 attribution models:

* First Touch
* Last Touch
* Last Non-Direct Touch
* Last Touch - Source Specific
* First Touch - Source Specific
* Linear
* Linear Paid
* U-Shaped

To learn what each one does, see [Attribution models and windows](https://docs.cometly.com/guides/analyzing-data/attribution-models-and-windows.md).

> [!NOTE]
>
> An **attribution window** is the period of time during which an event can be attributed to a marketing source or ad.

Cometly offers 8 attribution windows:

* **LTV:** no time limit. This is the default.
* **1 Day:** attributes conversions that occur within 1 day.
* **7 Days:** attributes conversions that occur within 7 days.
* **14 Days:** attributes conversions that occur within 14 days.
* **28 Days:** attributes conversions that occur within 28 days.
* **30 Days:** attributes conversions that occur within 30 days.
* **60 Days:** attributes conversions that occur within 60 days.
* **90 Days:** attributes conversions that occur within 90 days.

With **Attribute By**, you choose between **Conversion Date** (conversions that happened in your date range, whenever the click was) and **Click Date** (conversions that came from clicks in a date range, whenever the conversion happened).

## Step 6: Select a Group By option

**Group By** controls how the report is broken down. You can group by:

* **Time:** by Day, Week, Month, Quarter or Year
* **Sources**
* **Country**, **Region** or **City**
* **Device**, **OS**, **Browser** or **Language**
* **Keyword**, **URL Parameters**, **URL** or **Referrer**
* Ad details: **Ad Account**, **Campaign**, **Ad Set / Ad Group** or **Ad**, by Id or by Name
* Your [custom contact fields](https://docs.cometly.com/guides/events/custom-fields.md)

Most report types let you add a second level with **Add Another Group By**. See [Create grouped reports](https://docs.cometly.com/guides/report-builder/grouped-reports.md).

> [!TIP]
>
> When you group by Sources, turn on **Display only sources with data** to hide every source with no data.

## Step 7: Save the report

1. Enter a **Report Name** at the top of the panel.
2. Click **Add To Dashboard**.
3. Pick the dashboard to add the report to, then click **Add to dashboard**.

Reports are saved on dashboards. To change one later, open it from its dashboard card with **Edit Report**.

The **Options** tab holds display settings such as chart headers, colors, a target goal and data labels.

## Check it worked

After you click **Add to dashboard**, Cometly opens the dashboard you picked. Your new report appears there as a card.

## Frequently asked questions

### Why is my Report Builder preview empty?

The preview stays empty until the report has at least one metric. Until then it shows **Build your report**. Add a metric under **Metrics** and the chart or table appears on the right.

### How do I change a report without overwriting the original?

Open the report from its dashboard card with **Edit Report**, make your changes, then click **Add To Dashboard**. That saves your changes as a new report and leaves the original as it was. **Update Existing Report** overwrites the report you opened.

### Can I export a Cometly report to CSV or Excel?

Yes. Click the number for a metric in the report to open a panel with the contacts (or companies) behind it, then click **Download** and choose **Download CSV** or **Download Excel**. See [Export and analyze Cometly data](https://docs.cometly.com/guides/analyzing-data/export-data.md) for the full steps.

## Next steps

* [Customize your dashboards](https://docs.cometly.com/guides/dashboards/customize.md): resize, move and update the reports you save.
* [Create grouped reports](https://docs.cometly.com/guides/report-builder/grouped-reports.md): break a report down by two levels at once.
* [Attribution models and windows](https://docs.cometly.com/guides/analyzing-data/attribution-models-and-windows.md): choose the model and window that fit your sales cycle.
* [Report Builder 101](https://docs.cometly.com/guides/report-builder/overview.md): follow along as two starter reports are built from scratch.
* [Contact support](https://docs.cometly.com/support/contact.md): get help from the Cometly team.

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.