Flat rate reporting
How reports record the revenue of flat-rate Flights, and how to include it, for media owners who read revenue reports.
Flat-rate Flights charge a fixed price for the entire Flight period, regardless of performance. This pricing model is typically used for premium inventory and requires prior negotiation with the advertiser.
Flat rate reporting adds the fee of each flat-rate Flight to your revenue reports. You use it to see flat-rate revenue in your totals and in the metrics that use revenue, such as eCPM, CPC and ROAS. To set up a flat-rate Flight, read Flat-rate Flights.
Flat-rate revenue is accrued per networkKevel does not turn flat-rate accrual on by default. If your network does not accrue flat-rate revenue, reports that follow the network setting show $0 revenue for flat-rate Flights. A queued report request can turn it on for that one report with
FlatRateAccrualMethod. To turn it on for your network, or to check your network's setting, contact your Kevel representative.
How it works
A report adds one amount for each flat-rate Flight. The amount is the Flight's Price. Reports do not spread it over the days of the Flight or tie it to impressions.
- The fee is recorded at the Flight's start. If a Flight starts on December 1, all of its revenue appears on December 1, however long the Flight runs. A report range that does not include the start shows none of it.
- Time zone decides the day. Reports place the fee using the time zone of the report request. UTC is the default.
- Grouped by hour, the fee is in the hour of the start. A Flight that starts at 09:37 appears in the 09:00 to 10:00 bucket on its start date.
- Each report uses the Flight as it is when you request it. A new report for past dates uses the current Price and start date, even if you edited them later. A report that has already run keeps the values from when you requested it, until it expires after 10 days.
- Other metrics follow revenue. eCPM, CPC and ROAS include the fee. Impressions, clicks and GMV do not change. A fee that sits in its own row has no impressions or clicks, so eCPM and CPC are blank on that row.

What you control
| Control | Where it is set | Effect |
|---|---|---|
| Network default | Your Kevel representative sets it | Decides whether reports include the fee when a request does not say |
FlatRateAccrualMethod | A report request to Create Queued Report | startdateaccrual records the fee at the start date. norevenueaccrual leaves it out. The request overrides the network default for that report |
| Reports in the Ad Server UI | No setting | The report follows your network default |
| Ad Program Insights | No setting | The dashboards use only your network's accrual setting and cannot override it. A network with no setting is treated as not accruing. See Ad Program Insights |
In a queued report request, the value of FlatRateAccrualMethod is not case sensitive. Any other value returns a 400 error with the message Invalid FlatRateAccrualMethod.
Reading flat-rate revenue by dimension
A flat-rate fee belongs to a Flight, so it has no Site, Zone, location or device. What a report does with it depends on how you group.
| You group by | What you see |
|---|---|
| Nothing, or Flight, Campaign or Advertiser | The fee is in that row's Revenue |
| Any other dimension, such as Site, Zone, Ad Type or Priority | The fee is in its own row, with no value for that dimension. In API output the row has FlatRateGroup set to true. In the Ad Server UI the device, location (city, region and country), bid modifier and product columns read flat_rate on that row. In other columns, such as Site, the cell is blank or reads flat_rate. Rows with a value show the revenue their own events earned |
| A Flight or Campaign and another dimension | The fee is in a separate row for that Flight or Campaign, with no value for the other dimension |
| Wallet, search term, matched search term or matched placement category | The fee is left out |

Filtering on a dimension the fee does not have, such as Site, Zone, Ad Type, Creative or Priority, also leaves the fee out. Filtered totals therefore do not add up to unfiltered ones.
Examples
Thai Constellation is a flat-rate Flight with a Price of $2,000 that starts on December 1. Jade Plant is a flat-rate Flight with a Price of $1,000 that starts on December 2. Your network accrues flat-rate revenue.
| Report | What you see |
|---|---|
| December 1 to 31, grouped by Flight | Thai Constellation $2,000 and Jade Plant $1,000 |
| December 2 to 31, grouped by Flight | Jade Plant $1,000. Thai Constellation starts on December 1, outside the range, so it shows none of the fee |
| December 1 to 31, grouped by day | $2,000 on December 1 and $1,000 on December 2 |
| December 1 to 31, grouped by Site | Each Site row shows its own event revenue. One extra row, with no Site name, shows $3,000 |
| Any of these reports that follow a network that does not accrue flat-rate revenue | $0 for both Flights |
Defaults and scope
- Where it applies. Flat-rate revenue applies to queued reports, including reports you build in the Ad Server UI, and to Ad Program Insights.
- Currency. Reports use Price as you entered it. They do not convert currency.
- Changing a Flight's Rate. If a Flight delivered under another Rate before you changed it to Flat, its earlier event revenue stays in reports and the fee is added on top. Reports cannot net the two out. To correct revenue for a Flight in this state, contact your Kevel representative.
Troubleshooting
| What you see | Cause and fix |
|---|---|
| A flat-rate Flight shows $0 revenue | Your network may not accrue flat-rate revenue, the report may use norevenueaccrual, or the Flight's Price may be $0. Add "FlatRateAccrualMethod": "startdateaccrual" to the request. If the Flight still shows $0, contact your Kevel representative |
| A flat-rate Flight shows $0 for part of its run | The fee is recorded at the start date. Set the report range to include it |
| Revenue spikes on one day | The whole fee is recorded on the start date, so eCPM and CPC rise on that day and ROAS falls |
| A grouped or filtered total is lower than the total without the grouping or filter | The fee is left out when you group by wallet, search term, matched search term or matched placement category, or filter on a dimension the fee does not have, such as a Site, Zone, Ad Type or Creative |
| Ad Program Insights does not match a report you ran | The dashboards use only your network's accrual setting and ignore FlatRateAccrualMethod on a request. Run the report without it to compare, or contact your Kevel representative |
Related
Updated about 1 month ago
