Skip to content

Get started

AdMob mediation is a valuable feature that allows you to deliver ads to your applications from various sources. These sources encompass the AdMob Network, third-party ad networks, and AdMob campaigns. The primary goal of AdMob mediation is to optimize your fill rate and enhance your monetization efforts. It achieves this by directing ad requests to multiple networks, ensuring that your app utilizes the most suitable network available to serve ads. This approach is exemplified through a case study.

This comprehensive guide serves as your all-inclusive resource for integrating mediation into your AdMob app. It encompasses both bidding and waterfall integration methods, providing you with a complete reference for optimizing your ad serving strategy.

Info

Crucial Note: Before proceeding with mediation configuration, it's essential to ensure that you possess the required account permissions. These permissions encompass access to inventory management, app access, and privacy and messaging features. For further details, please refer to the New User Roles article.

If you are new to mediation, it's advisable to review the Overview of AdMob mediation for a better understanding of the concept.

This document is based on:

Initialize the Mobile Ads SDK

The quick start guide provides instructions on how to initialize the Mobile Ads SDK. During this initialization process, mediation and bidding adapters are also initialized. It's crucial to wait for this initialization to complete before loading ads to ensure that every ad network fully participates in the first ad request.

The following sample code demonstrates how you can verify the initialization status of each adapter before initiating an ad request.

extends Control

func _ready() -> void:
    var on_initialization_complete_listener := OnInitializationCompleteListener.new()
    on_initialization_complete_listener.on_initialization_complete = _on_initialization_complete
    MobileAds.initialize(on_initialization_complete_listener)

func _on_initialization_complete(initialization_status : InitializationStatus) -> void:
    print("MobileAds initialization complete")
    for key in initialization_status.adapter_status_map:
        var adapterStatus : AdapterStatus = initialization_status.adapter_status_map[key]
        prints(
            "Key:", key, 
            "Latency:", adapterStatus.latency, 
            "Initialization Status:", adapterStatus.initialization_status, 
            "Description:", adapterStatus.description
        )

When utilizing banner ads in AdMob mediation, it's essential to disable refresh settings in all third-party ad networks' user interfaces for the banner ad units you're using in mediation. This action prevents the occurrence of double refreshes, as AdMob also triggers a refresh based on your banner ad unit's predefined refresh rate.

Rewarded ads mediation

We strongly advise you to customize all default reward values by configuring reward values within the AdMob UI. To accomplish this, select the Apply to all networks in Mediation groups option to ensure that the reward remains uniform across all networks. Keep in mind that certain ad networks may not provide a reward value or type. By overriding the reward value, you guarantee a consistent reward, regardless of the ad network responsible for serving the ad. apply_all_networks

For more information on setting reward values in the AdMob UI, refer to create a rewarded ad unit.

For comprehensive details on how to set reward values within the AdMob UI, please consult the Create a Rewarded Ad Unit documentation.

CCPA and GDPR

Warning

Critical Note: Before proceeding with the configuration for EU Consent, GDPR, CCPA, and User Messaging Platform, it is crucial to ensure that you have the necessary Account Management permission. These permissions are essential for managing privacy-related settings. To obtain more information, please refer to the New User Roles article.

If your app needs to adhere to the California Consumer Privacy Act (CCPA) or the General Data Protection Regulation (GDPR), please adhere to the steps outlined in the CCPA settings or GDPR settings to include your mediation partners in AdMob Privacy & Messaging's CCPA or GDPR ad partners list. Failing to do so may result in your partners being unable to serve ads on your app.

To acquire further insights, explore the process of enabling CCPA restricted data processing and obtaining GDPR consent using the Google User Messaging Platform (UMP) SDK.