The Additional Reading Developer Hub

Welcome to the Additional Reading developer hub. You'll find comprehensive guides and documentation to help you start working with Additional Reading as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Auctions Report

📘

This report is intended for use by Publishers.

Introduction

The Auctions report provides a convenient way to track performance metrics such as revenue, number of impressions, number of clicks and more. It also enables you to perform in-depth analysis on your auction landscape and gather insights on the performance of the millions of transactions happening daily. The data shown in the Auctions report is based on aggregated data collected from the Fyber Marketplace, it is updated on an hourly basis with data latency of approximately 3 hours.

📘

Note

For full instructions of the functionality available to you with Fyber's Dynamic Reports, click here.

Auctions Report Dimensions

Set out below are the groups and the dimensions contained within them, relevant to the Auctions report.

Group NameDimensionDescription
Date/Time-The date and time of the report
AuctionDeal IDThe unique identifier string passed in the bid request to signal the presence of a PMP
DeliverySDK/Tag VersionVersion of the source SDK or JavaScript tag
SDK RendererThe renderer of the SDK
Winning DemandAdvertiser DomainThe destination domain that the advertiser has set for a given ad
Buying MechanicProgrammatic or Mediation
Campaign IDThe campaign ID as defined by the advertiser and sent by the advertiser in the bid response
Creative IDThe creative ID as defined by the advertiser and sent by advertiser in the bid response
Creative TypeThe format of the ad that was displayed as returned in the ad response. Can be one of the following:

Display
Video
* Display or Video
Demand Source NameDemand partner that won the auction
Demand Source TypeType of demand integration. Can be one of the following:

Programmatic
Programmatic Mediation
Mediated Networks
Custom API
Seat IDSeat ID of the winning buyer on the DSP's side
Seat NameName of winning buyer on the DSP's side
DeviceDevice ID TypeThe type of unique device identifier. Can be either IDFA or AAID.
Device ManufacturerThe company that manufactured the device. For example Apple or Samsung.
Device OSThe mobile operating system on the device
Device OS VersionApp's mobile operating system
InventoryAd SizeThe creative ad size as was defined by the advertiser
Variant ID (Ad Unit ID)The unique identifier of the ad unit in the Fyber system
Variant Name (Ad Unit Name)The name of the ad unit
Ad Unit TypeType of ad unit container can be either video, display, video & display. The ad types available to an ad unit depend on the placement type you selected when creating it.

Display: An ad unit type that supports display only

Video: An ad unit type that supports video only

Video & Display: An ad unit type that supports video or display
App Bundle
App IDApp identifier within Fyber's system
App NameThe name of the app
Category (App Store)
DNTIndicated whether users has requested to not be tracked
Placement IDPlacement identifier in Fyber's system
Placement NameA name given by a publisher to a placement they created on Fyber
Placement TypePlacement type describes how ads will look in the app and where ads will be located. Optional placement types can be either banner, interstitial or rewarded.

Banner: A basic placement type that appears at the top or bottom of the device's screen. Doesn't' support video content.

Rewarded: An ad placement type that supports incentivized video content.

Interstitial: Full-page ads appear at natural breaks & transitions, such as level completion. Supports video content.
Product LineEither Fyber FairBid or Fyber Marketplace
LocationCountryThe country in which the user is located
MediationOverridden RankFor mediated networks, describes whether rank was manually overridden by publisher. Can be either "Overridden" or "Not Overridden".
Winning Demand Network RankThe rank of the demand partner that won the auction. Applicable only to mediation or custom API demand sources.
Winning DemandInstance IDThe instance ID as generated by the demand network. Notice: this is referred to differently, by various demand networks
Internal Instance ID
Instance NameA name manually provided by the publisher for a mediated network's placement

Auctions Report Metrics

Set out below are the groups and the metrics relevant to the Auctions reports.

Group NameMetricDescriptionFormula
AuctionAd RequestsThe number of requests for ads sent from an application to the servers of the exchange. Note - ad requests are not the same as bid requests.Sum (Ad Requests)
Avg. Clear PriceThe average price that the demand partner paid for 1000 impressions.Sum (Clear Price)/Sum (Cleared)
Clear RateReflects how many auctions were cleared out of the ad requests receivedSum (Bids Won)/Sum
(Ad Requests)
ClearedThe number of ads that were successfully sold via an auctionSum (Bids Won)
eCPM
Fill RateThe average cost of a thousand impressions{(Revenue/Sum (Impressions)}
x 1000
BidsAvg. Floor PriceAverage floor price of all the ad requests receivedSum (Floor Prices) /
Sum (Ad Requests)
Avg. Win eCPMAverage winning bid price, in terms of CPM. Reflects the average price of all bids that won the auction. In case of a second price auction, Avg. win bid price is higher than the the price the demand partner will pay for the impression.Sum (Win Bid Price) /
Sum (Cleared)
DeliverySurvival RateTotal number of impressions served divided by total winning bidsSum(Impressions) / Sum(Clears)
EngagementClicksThe number of times users click on an adSum (Clicks)
Completion RateThe ratio of rewarded video completions to rewarded video impressionsSum (Rewarded Completions) / Sum (Rewarded Impressions)
CTR"CTR" means clickthrough rate and equals the total number of clicks divided by the number of impressions.[Sum (Clicks) / Sum (Impressions) ] * 100%
FrequencyThe average number of ads served per unique user in a selected timeframeSum (Impressions) /
Sum (Unique Users)
ImpressionsThe number of ads shown to usersSum (Impressions)
Rewarded CompletionsThe number of times users completed watching a rewarded videoSum (Rewarded Completions)
Unique UsersThe number of all unique users that triggered at least one ad request during selected timeframe.
De-duplication is done in real time, based on the selected dimensions. This metrics is used to calculate the following metrics:

DAU (daily active users)
ARPDAU (average revenue per daily active user)
Ad Frequency (impressions / unique users)

To view DAU:

Select the Unique User metric
Filter selected timeframe to a one day range OR
Split by date/time and view with daily granularity (1D)
Sum (Unique Users [by device ID, with at least one ad request])
RevenueARPUARPU is calculated by dividing Total Revenue by the number of Unique Users. ARPDAU helps answer the question “how well do I monetise my users?” Typical splits include ARPDAU by app, creative type, and placement type

To view ARPDAU (Average Revenue per Daily Active User):

Select the ARPU metric
Filter selected timeframe to a one day range OR
* Split by date/time and view with daily granularity (1D)
(Total Revenue) / (Unique Users)
FeeA percentage of the eCPM. Fee is paid to Fyber by a publisher for Programmatic Mediation Impressions.Sum (fee)
Total RevenueTotal payment received from demand. Some of this revenue will be paid directly by demand partnerSum (Total Revenue)

Updated about a month ago

Auctions Report


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.