Skip to main content
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.
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

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.
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
Most report types let you add a second level with Add Another Group By. See Create grouped reports.
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 for the full steps.

Next steps

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.