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 network

Kevel 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.
A report grouped by Advertiser, Campaign and Flight for December 1 to 31. Thai Constellation shows $2000.00 in Revenue and Jade Plant shows $1000.00.

What you control

ControlWhere it is setEffect
Network defaultYour Kevel representative sets itDecides whether reports include the fee when a request does not say
FlatRateAccrualMethodA report request to Create Queued Reportstartdateaccrual 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 UINo settingThe report follows your network default
Ad Program InsightsNo settingThe 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 byWhat you see
Nothing, or Flight, Campaign or AdvertiserThe fee is in that row's Revenue
Any other dimension, such as Site, Zone, Ad Type or PriorityThe 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 dimensionThe 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 categoryThe fee is left out
A report grouped by Country. Five countries show their own revenue. A sixth row reads flat_rate and shows $3000.00 in Revenue.

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.

ReportWhat you see
December 1 to 31, grouped by FlightThai Constellation $2,000 and Jade Plant $1,000
December 2 to 31, grouped by FlightJade 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 SiteEach 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 seeCause and fix
A flat-rate Flight shows $0 revenueYour 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 runThe fee is recorded at the start date. Set the report range to include it
Revenue spikes on one dayThe 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 filterThe 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 ranThe 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