Reports and filters
Choose a date range, group by up to four dimensions, filter by country, format, device, campaign or zone, and export to CSV.
A report is a table of totals for a date range, split by the dimensions you choose. Open it at /app/advertiser/reports or /app/publisher/reports.
Run a report
- Set From and To. The range can be up to 92 days.
- Pick the dimensions to group by. You can combine up to four. With none selected, the report is grouped by date.
- Optionally fill in one or more filters.
- Select Run.
Rows are sorted by the grouping columns. A total row at the bottom adds up every metric. Reports fill in within minutes of the first impressions.
Dimensions
| Dimension | Advertisers | Publishers |
|---|---|---|
| Date | Yes | Yes |
| Country | Yes | Yes |
| Format | Yes | Yes |
| OS | Yes | Yes |
| Device | Yes | Yes |
| Zone | Yes | Yes |
| Site | Yes | Yes |
| Sub-ID | Yes | Yes |
| Campaign | Yes | No |
| Ad | Yes | No |
Where possible, ids are shown with a readable name: campaigns by their name for advertisers, zones by their name for publishers, and sites by their domain for both.
Site and sub-ID come from a separate traffic-source summary. They cannot be combined with country, format, OS, device or ad, either as a grouping or as a filter. The panel greys out the dimensions that cannot be added to your current selection. See Sub-IDs and sites.
Filters
| Filter | Accepts |
|---|---|
| Country code | Two capital letters, for example US |
| Format | One ad format |
| Device | desktop, mobile, tablet or other |
| Campaign ID | One of your campaign ids (advertisers) |
| Zone ID | One zone id |
| Sub-ID | One sub-ID value, up to 100 characters |
Filters narrow the rows before they are totalled. For example, group by date and filter by country DE to see a daily trend for Germany only.
Metrics
| Metric | Advertisers | Publishers |
|---|---|---|
| Impressions | Yes | Yes |
| Clicks | Yes | Yes |
| Conversions | Yes | Yes |
| Cost | Yes | No |
| Revenue | Yes | No |
| Earnings | No | Yes |
- Cost is what you were charged, in US dollars.
- Revenue is the sum of the payout values your postbacks reported. It is for your own reporting and is not charged.
- Earnings is your share of what advertisers were charged for your traffic. See Revenue share.
Traffic flagged by the quality checks is not charged and earns nothing, so it adds nothing to cost or earnings.
Useful combinations
| Question | Group by | Filter |
|---|---|---|
| How is spend moving day by day? | Date | Campaign ID |
| Which countries convert? | Country | Campaign ID |
| Which zones should I block? | Zone, Campaign | None |
| Which of my placements earns most? | Zone | None |
| Is a traffic source worth keeping? | Sub-ID, Date | Zone ID |
Export
Select Download CSV to save the rows on screen as a CSV file for a spreadsheet. A report returns at most 5,000 rows; if you need more, shorten the date range or use fewer dimensions.
Reports through the API
The same report is available at:
GET https://ulumob.com/api/v1/advertiser/reports
GET https://ulumob.com/api/v1/publisher/reports
Send from and to as YYYY-MM-DD, each dimension as group_by[], and filters by name. See Reports API.
Something missing or wrong? Tell us.