Get started

This guide shows you how to integrate a mediation adapter with your Unity app.

Prerequisites

Before you can integrate mediation for an ad format, you need to integrate that ad format into your app:

• Banner Ads
• Interstitial Ads
• Native Ads
• Rewarded Ads
• Rewarded Interstitial Ads

New to mediation? Read Introduction to mediation .

For bidding: Google Mobile Ads Unity plugin 4.2.0 or higher.

Initialize Google Mobile Ads SDK

The quick start guide shows you how to initialize the Google Mobile Ads SDK . During that initialization call, mediation adapters also get initialized. It is important to wait for initialization to complete before you load ads in order to verify full participation from every ad network on the first ad request.

The following sample code shows how you can check each adapter's initialization status prior to making an ad request.

  MobileAds 
 . 
 Initialize 
 (( 
 InitializationStatus 
  
 initializationStatus 
 ) 
  
 = 
> { 
  
 Dictionary<string 
 , 
  
 AdapterStatus 
>  
 map 
  
 = 
  
 initializationStatus 
 . 
 getAdapterStatusMap 
 (); 
  
 foreach 
  
 ( 
 KeyValuePair<string 
 , 
  
 AdapterStatus 
>  
 keyValuePair 
  
 in 
  
 map 
 ) 
  
 { 
  
 string 
  
 className 
  
 = 
  
 keyValuePair 
 . 
 Key 
 ; 
  
 AdapterStatus 
  
 status 
  
 = 
  
 keyValuePair 
 . 
 Value 
 ; 
  
 switch 
  
 ( 
 status 
 . 
 InitializationState 
 ) 
  
 { 
  
 case 
  
 AdapterState 
 . 
 NotReady 
 : 
  
 // The adapter initialization did not complete. 
  
 Debug 
 . 
 Log 
 ( 
 $"Adapter: {className} is not ready." 
 ); 
  
 break 
 ; 
  
 case 
  
 AdapterState 
 . 
 Ready 
 : 
  
 // The adapter was successfully initialized. 
  
 Debug 
 . 
 Log 
 ( 
 $"Adapter: {className} is initialized." 
 ); 
  
 break 
 ; 
  
 } 
  
 } 
 }); 
 
  MediationSnippets 
 . 
 cs 
 
 
 

Use banner ads with mediation

Make sure to disable refresh in all third-party ad source UIs for banner ad units used in mediation. This prevents a double refresh since Ad Manager also triggers a refresh based on your banner ad unit's refresh rate.

Use native ads with mediation

The following are some best practices to consider when implementing native mediation.

Native ad presentation policy

Each ad network has its own policies. When using mediation, it's important to remember that your app still needs to abide by the policies of the mediated network that provided the ad.

US states privacy laws and GDPR

If you need to comply with the U.S. states privacy laws or General Data Protection Regulation (GDPR) , follow the steps in US state regulations settings or GDPR settings to add your mediation partners in Ad Manager Privacy & messaging's US states or GDPR ad partners list. Failure to do so can lead to partners failing to serve ads on your app.

Learn more about enabling restricted data processing (RDP) and obtaining GDPR consent with the Google User Messaging Platform (UMP) SDK .