How mediation works
For each mediation request from a publisher's mobile app, DFP uses yield groups targeting to determine which ad networks are eligible to compete and then assembles a list, or chain, of ad networks to receive that request in sequence.
- Publisher's mobile app sends an ad request to DFP via the Google Mobile Ads SDK.
- DFP determines which DFP line items and yield groups are eligible for the request.
- DFP creates a chain of ad networks to call in mediation.
- DFP compares the mediation chain's expected yield with other DFP line items.
- DFP sends the mediation chain back to the Google Mobile Ads SDK.
- Google Mobile Ads SDK sends a request, or "callout," to each ad network until an ad is returned.
- Google Mobile Ads SDK displays the returned ad in the publisher's mobile app.
1. Publisher's mobile app sends an ad request to DFP via the Google Mobile Ads SDK
An ad request is sent to the DFP ad server using the Google Mobile Ads SDK and special third-party ad network adapters. Learn more
2. DFP determines which DFP line items and yield groups are eligible for the request
DFP assembles a list of eligible line items and yield groups based on inventory targeting.
3. DFP creates a chain of ad networks to call in mediation
If one or more yield groups matches the ad request, a single, sequential list, or "chain," of Mediation networks contained in the eligible yield groups is compiled, ordered from highest to lowest expected yield using historical performance data or user-entered CPM values. Ad Exchange uses real-time auction-winning bids.
DFP Mediation sorts ad network tags by CPM in decreasing order, using the estimated CPM for each ad network tag and the real time Ad Exchange CPM.
- The estimated CPM reflects either the “default CPM” entered for each mediation network, or the “dynamic CPM” if automatic data collection is enabled. If DFP collects data automatically, the estimated CPM reflects the historical CPM observed for that ad network tag adjusted for impression discrepancies with DFP recorded impressions.
- Fill rate is only used to calculate the expected value of the entire mediation chain for competition in dynamic allocation. Fill rate is not used to discount estimated CPM for an ad network tag.
- If the number of competing network tags in a mediation chain exceeds the system limit, DFP uses ad network tag fill rate, CPM and calculated order to discard ad tags and meet the limit with a maximum possible expected value.
4. DFP compares the mediation chain's expected yield with other DFP line items
The mediation chain competes against other DFP line items in dynamic allocation based on its expected yield. Ad Exchange competes with mediation networks as part of a mediation chain. However, if Ad Exchange or another DFP line item returns a higher bid than any mediation network, the DFP or Ad Exchange creative is returned directly to the publisher and no Mediation chain is returned.
5. DFP sends the mediation chain back to publisher's mobile app
The mediation chain, with Ad Exchange at the end, is returned to the publisher's mobile app.
6. Google Mobile Ads SDK sends a request to each ad network until an ad is returned
Using the returned mediation chain, the mobile app's SDK can then use the network adapters to send a request, or "callout," to each ad network until an ad is returned.
If none of the Mediation networks in the mediation chain are able to fill the ad request, the request will be unfilled and no automatic passback to the ad server is triggered. Enable automatic data collection or ensure that each mediation network’s CPM is adjusted periodically according to the bids actually received by each partner.