You are here: Publishers > Event-level Feeds > Event level feeds with revenue

Event level feeds with revenue

Last updated on March 10, 2016

In addition to the existing set of event level feeds, OpenX also provides event level feeds with revenue data, allowing you to gain monetization insights and potentially optimize your inventoryAd space available on a website or app. The basic unit of inventory for OpenX is an ad unit. setup. You can obtain high granularity information with revenue for performance, optimization, and deep analytics. This provides access to requests, impressions, clicks, and conversion event level feeds with revenue.

Note: If you are an existing event level feed customer and have existing scripts that parse the log files, this additional set of feeds will not negatively impact your current way of parsing the data.

You can easily switch from event level feeds without revenue to event level feeds with revenue. Also, in the same manner as existing feeds without revenue, you can specify feeds by the minute or by the hour.

Important: EventLogs version 5 contains revenue attributes; EventLogs version 4 and lower do not.

Event level feed sets

The OpenX API provides two sets of event level feeds (with and without revenue). OpenX provides four event level feed types without revenue: request, impressionA single display of an ad on a web page, mobile app, or other delivery medium. For deals, impression is a metric to relay the total number of ads that have served. See also billable impression, forecasted impressions., click, and conversion. Three event level feed types with revenue are provided: request, impression, and click, explained below.

Revenue event level feed types

Field type Description
Request_Revenue Each row in the feed corresponds to one request. The attributes are the same as a request feed without revenue, with the following additional fields: revenue_type, currency, and a revenue metric. For requests where no ad impression was served, revenue returns zero, and revenue_type returns blank or null.
Impression_Revenue Each row in the feed corresponds to one impression. The attributes are the same as an impression feed without revenue, with the following additional fields: revenue_type, currency, and a revenue metric. This revenue is earned per impression. If the revenue per 1,000 impressions (CPMCost per mille, a pricing method which calculates cost based on the number of impressions (per 1000).) is $1.25 CPM, the revenue per impression for the feed displays $0.00125. This makes the revenue per row additive to calculate total impression-based revenue. This type does not include revenue earned per click (CPCCost per click, a pricing method which calculates cost based on the number of times a user clicks on an ad.) or conversion (CPACost per action, a pricing method which calculates cost based on the number of times a user takes action based on an ad (conversions).).
Click_Revenue Each row in the feed corresponds to one click. The attributes are the same as a click feed without revenue, with the following additional fields: revenue_type, currency, and a revenue metric. This is revenue associated to revenue per click (CPC) and does not include revenue earned per impression (CPM) or per conversion (CPA).

Revenue fields

Event level feeds with revenue provide three additional revenue metric fields, described below.

Revenue event level feed types

Field Description
revenue_type The type of demand or monetization (direct, exchange, SSPSupply-side platform, a platform or provider that allows publishers to manage and optimize revenue for their inventory from multiple sources, often in real time., deal, etc.). Revenue type is mapped from the lineitem.* type field to help you identify the type of demand.
currency The currency type, for example USD, GBP, JPY, etc.
revenue The amount of revenue

Sample Applications

Using the additional revenue fields allows for the following possible applications:

This topic applies to Ad Server. This topic applies to Ad Exchange. This topic applies to Programmatic Direct.

Feedback form