@capacitor-community/admob 8.0.1 → 8.1.0

package/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/maintenance/yes/2025?style=flat-square" />
+  <img src="https://img.shields.io/maintenance/yes/2026?style=flat-square" />
   <a href="https://www.npmjs.com/package/@capacitor-community/admob"><img src="https://img.shields.io/npm/l/@capacitor-community/admob?style=flat-square" /></a>
 <br>
   <a href="https://www.npmjs.com/package/@capacitor-community/admob"><img src="https://img.shields.io/npm/dw/@capacitor-community/admob?style=flat-square" /></a>
@@ -32,7 +32,7 @@ Made with [contributors-img](https://contrib.rocks).
 
 ## Demo
 
-[Demo code is here.](https://github.com/capacitor-community/admob/tree/master/demo)
+[Demo code is here.](https://github.com/capacitor-community/admob/tree/main/demo)
 
 ### Screenshots
 
@@ -43,13 +43,21 @@ Made with [contributors-img](https://contrib.rocks).
 
 ## Installation
 
-If you use capacitor 6:
+If you use Capacitor 7:
 
 ```
-% npm install --save @capacitor-community/admob@6
+% npm install --save @capacitor-community/admob@7
 % npx cap update
 ```
 
+### Google Mobile Ads SDK compatibility
+
+To preserve behavior for users of the current major version, this plugin continues to use Google Mobile Ads SDK APIs that are deprecated but still supported. Replacing those APIs can change banner sizing and age-restricted treatment behavior, so that migration is deferred until the next major release.
+
+Migration to the [GMA Next-Gen SDK for Android](https://developers.google.com/admob/android/next-gen) is also deferred until the next major release because it requires breaking changes to SDK initialization, ad requests, and mediation integration.
+
+Android continues to use GMA SDK (Legacy) 25.4.x. On iOS, both Swift Package Manager and CocoaPods are fixed to GMA SDK 13.6.0 until CocoaPods support is removed in the next major release.
+
 ### Android configuration
 
 In file `android/app/src/main/AndroidManifest.xml`, add the following XML elements under `<manifest><application>` :
@@ -72,8 +80,8 @@ Don't forget to replace `[APP_ID]` by your AdMob application Id.
 
 This plugin will use the following project variables (defined in your app's `variables.gradle` file):
 
-- `playServicesAdsVersion` version of `com.google.android.gms:play-services-ads` (default: `23.0.0`)
-- `androidxCoreKTXVersion`: version of `androidx.core:core-ktx` (default: `1.13.0`)
+- `playServicesAdsVersion` version of `com.google.android.gms:play-services-ads` (default: `25.4.+`)
+- `androidxCoreKTXVersion`: version of `androidx.core:core-ktx` (default: `1.15.0`)
 
 ### iOS configuration
 
@@ -102,7 +110,7 @@ Don't forget to replace `[APP_ID]` by your AdMob application Id.
 ### Initialize AdMob
 
 ```ts
-import { AdMob } from '@capacitor-community/admob';
+import { AdMob, AdmobConsentStatus } from '@capacitor-community/admob';
 
 export async function initialize(): Promise<void> {
   await AdMob.initialize();
@@ -174,6 +182,8 @@ showPrivacyOptionsForm() {
 If you testing on real device, you have to set `debugGeography` and add your device ID to `testDeviceIdentifiers`. You can find your device ID with logcat (Android) or XCode (iOS).
 
 ```ts
+import { AdMob, AdmobConsentDebugGeography } from '@capacitor-community/admob';
+
 const consentInfo = await AdMob.requestConsentInfo({
   debugGeography: AdmobConsentDebugGeography.EEA,
   testDeviceIdentifiers: ['YOUR_DEVICE_ID'],
@@ -196,12 +206,13 @@ import {
   AdMob,
   AppOpenAdPluginEvents,
   AppOpenAdOptions,
+  AdLoadInfo,
 } from '@capacitor-community/admob';
 
 export async function showAppOpenAd(): Promise<void> {
   // listen to events
-  AdMob.addListener(AppOpenAdPluginEvents.Loaded, () => {
-    console.log('App Open Ad loaded');
+  AdMob.addListener(AppOpenAdPluginEvents.Loaded, (info: AdLoadInfo) => {
+    console.log('App Open Ad loaded', info.adUnitId);
   });
   AdMob.addListener(AppOpenAdPluginEvents.FailedToLoad, (error) => {
     console.log('Failed to load App Open Ad', error);
@@ -219,10 +230,10 @@ export async function showAppOpenAd(): Promise<void> {
   const options: AppOpenAdOptions = {
     adId: 'YOUR_AD_UNIT_ID',
   };
-  await AdMob.loadAppOpen(options);
-  const { value } = await AdMob.isAppOpenLoaded();
+  const { adUnitId } = await AdMob.loadAppOpen(options);
+  const { value } = await AdMob.isAppOpenLoaded({ adId: adUnitId });
   if (value) {
-    await AdMob.showAppOpen();
+    await AdMob.showAppOpen({ adId: adUnitId });
   }
 }
 ```
@@ -262,6 +273,30 @@ export async function banner(): Promise<void> {
 }
 ```
 
+### Impression-level ad revenue
+
+Full-screen ad formats emit revenue data through their `AdImpression` event. Banners use the separate `AdPaid` event.
+
+```ts
+import {
+  AdMob,
+  AdMobRevenueData,
+  BannerAdPluginEvents,
+  InterstitialAdPluginEvents,
+} from '@capacitor-community/admob';
+
+AdMob.addListener(
+  InterstitialAdPluginEvents.AdImpression,
+  (data: AdMobRevenueData) => {
+    console.log(data);
+  },
+);
+
+AdMob.addListener(BannerAdPluginEvents.AdPaid, (data: AdMobRevenueData) => {
+  console.log(data);
+});
+```
+
 ### Show Interstitial
 
 ```ts
@@ -285,6 +320,16 @@ export async function interstitial(): Promise<void> {
   };
   await AdMob.prepareInterstitial(options);
   await AdMob.showInterstitial();
+
+  // You can also prepare multiple interstitials and show a specific one by passing its adId:
+  await AdMob.prepareInterstitial({ adId: 'ca-app-pub-xxx/interstitial-1' });
+  await AdMob.prepareInterstitial({ adId: 'ca-app-pub-xxx/interstitial-2' });
+
+  // Show a specific prepared ad
+  await AdMob.showInterstitial({ adId: 'ca-app-pub-xxx/interstitial-1' });
+
+  // Or omit adId to show the most recently prepared one (default behavior)
+  await AdMob.showInterstitial();
 }
 ```
 
@@ -324,6 +369,30 @@ export async function rewardVideo(): Promise<void> {
   };
   await AdMob.prepareRewardVideoAd(options);
   const rewardItem = await AdMob.showRewardVideoAd();
+
+  // You can also prepare multiple reward ads and show a specific one by passing its adId:
+  await AdMob.prepareRewardVideoAd({ adId: 'ca-app-pub-xxx/reward-1' });
+  await AdMob.prepareRewardVideoAd({ adId: 'ca-app-pub-xxx/reward-2' });
+
+  // Show a specific prepared ad
+  const reward = await AdMob.showRewardVideoAd({ adId: 'ca-app-pub-xxx/reward-1' });
+
+  // Or omit adId to show the most recently prepared one (default behavior)
+  const reward2 = await AdMob.showRewardVideoAd();
+}
+```
+
+### Show Rewarded Interstitial
+
+```ts
+import { AdMob, RewardInterstitialAdOptions } from '@capacitor-community/admob';
+
+export async function rewardInterstitial(): Promise<void> {
+  const options: RewardInterstitialAdOptions = {
+    adId: 'YOUR ADID',
+  };
+  const { adUnitId } = await AdMob.prepareRewardInterstitialAd(options);
+  await AdMob.showRewardInterstitialAd({ adId: adUnitId });
 }
 ```
 
@@ -372,13 +441,14 @@ AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
 * [`setApplicationMuted(...)`](#setapplicationmuted)
 * [`setApplicationVolume(...)`](#setapplicationvolume)
 * [`loadAppOpen(...)`](#loadappopen)
-* [`showAppOpen()`](#showappopen)
-* [`isAppOpenLoaded()`](#isappopenloaded)
+* [`showAppOpen(...)`](#showappopen)
+* [`isAppOpenLoaded(...)`](#isappopenloaded)
 * [`addListener(AppOpenAdPluginEvents.Loaded, ...)`](#addlistenerappopenadplugineventsloaded-)
 * [`addListener(AppOpenAdPluginEvents.FailedToLoad, ...)`](#addlistenerappopenadplugineventsfailedtoload-)
 * [`addListener(AppOpenAdPluginEvents.Opened, ...)`](#addlistenerappopenadplugineventsopened-)
 * [`addListener(AppOpenAdPluginEvents.Closed, ...)`](#addlistenerappopenadplugineventsclosed-)
 * [`addListener(AppOpenAdPluginEvents.FailedToShow, ...)`](#addlistenerappopenadplugineventsfailedtoshow-)
+* [`addListener(AppOpenAdPluginEvents.AdImpression, ...)`](#addlistenerappopenadplugineventsadimpression-)
 * [`showBanner(...)`](#showbanner)
 * [`hideBanner()`](#hidebanner)
 * [`resumeBanner()`](#resumebanner)
@@ -389,33 +459,37 @@ AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
 * [`addListener(BannerAdPluginEvents.Opened, ...)`](#addlistenerbanneradplugineventsopened-)
 * [`addListener(BannerAdPluginEvents.Closed, ...)`](#addlistenerbanneradplugineventsclosed-)
 * [`addListener(BannerAdPluginEvents.AdImpression, ...)`](#addlistenerbanneradplugineventsadimpression-)
+* [`addListener(BannerAdPluginEvents.AdPaid, ...)`](#addlistenerbanneradplugineventsadpaid-)
 * [`requestConsentInfo(...)`](#requestconsentinfo)
 * [`showPrivacyOptionsForm()`](#showprivacyoptionsform)
 * [`showConsentForm()`](#showconsentform)
 * [`resetConsentInfo()`](#resetconsentinfo)
 * [`prepareInterstitial(...)`](#prepareinterstitial)
-* [`showInterstitial()`](#showinterstitial)
+* [`showInterstitial(...)`](#showinterstitial)
 * [`addListener(InterstitialAdPluginEvents.FailedToLoad, ...)`](#addlistenerinterstitialadplugineventsfailedtoload-)
 * [`addListener(InterstitialAdPluginEvents.Loaded, ...)`](#addlistenerinterstitialadplugineventsloaded-)
 * [`addListener(InterstitialAdPluginEvents.Dismissed, ...)`](#addlistenerinterstitialadplugineventsdismissed-)
 * [`addListener(InterstitialAdPluginEvents.FailedToShow, ...)`](#addlistenerinterstitialadplugineventsfailedtoshow-)
 * [`addListener(InterstitialAdPluginEvents.Showed, ...)`](#addlistenerinterstitialadplugineventsshowed-)
+* [`addListener(InterstitialAdPluginEvents.AdImpression, ...)`](#addlistenerinterstitialadplugineventsadimpression-)
 * [`prepareRewardVideoAd(...)`](#preparerewardvideoad)
-* [`showRewardVideoAd()`](#showrewardvideoad)
+* [`showRewardVideoAd(...)`](#showrewardvideoad)
 * [`addListener(RewardAdPluginEvents.FailedToLoad, ...)`](#addlistenerrewardadplugineventsfailedtoload-)
 * [`addListener(RewardAdPluginEvents.Loaded, ...)`](#addlistenerrewardadplugineventsloaded-)
 * [`addListener(RewardAdPluginEvents.Rewarded, ...)`](#addlistenerrewardadplugineventsrewarded-)
 * [`addListener(RewardAdPluginEvents.Dismissed, ...)`](#addlistenerrewardadplugineventsdismissed-)
 * [`addListener(RewardAdPluginEvents.FailedToShow, ...)`](#addlistenerrewardadplugineventsfailedtoshow-)
 * [`addListener(RewardAdPluginEvents.Showed, ...)`](#addlistenerrewardadplugineventsshowed-)
+* [`addListener(RewardAdPluginEvents.AdImpression, ...)`](#addlistenerrewardadplugineventsadimpression-)
 * [`prepareRewardInterstitialAd(...)`](#preparerewardinterstitialad)
-* [`showRewardInterstitialAd()`](#showrewardinterstitialad)
+* [`showRewardInterstitialAd(...)`](#showrewardinterstitialad)
 * [`addListener(RewardInterstitialAdPluginEvents.FailedToLoad, ...)`](#addlistenerrewardinterstitialadplugineventsfailedtoload-)
 * [`addListener(RewardInterstitialAdPluginEvents.Loaded, ...)`](#addlistenerrewardinterstitialadplugineventsloaded-)
 * [`addListener(RewardInterstitialAdPluginEvents.Rewarded, ...)`](#addlistenerrewardinterstitialadplugineventsrewarded-)
 * [`addListener(RewardInterstitialAdPluginEvents.Dismissed, ...)`](#addlistenerrewardinterstitialadplugineventsdismissed-)
 * [`addListener(RewardInterstitialAdPluginEvents.FailedToShow, ...)`](#addlistenerrewardinterstitialadplugineventsfailedtoshow-)
 * [`addListener(RewardInterstitialAdPluginEvents.Showed, ...)`](#addlistenerrewardinterstitialadplugineventsshowed-)
+* [`addListener(RewardInterstitialAdPluginEvents.AdImpression, ...)`](#addlistenerrewardinterstitialadplugineventsadimpression-)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -433,11 +507,11 @@ AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
 initialize(options?: AdMobInitializationOptions | undefined) => Promise<void>
 ```
 
-Initialize AdMob with <a href="#admobinitializationoptions">AdMobInitializationOptions</a>
+Initializes the Google Mobile Ads SDK.
 
-| Param         | Type                                                                              | Description                                                          |
-| ------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| **`options`** | <code><a href="#admobinitializationoptions">AdMobInitializationOptions</a></code> | <a href="#admobinitializationoptions">AdMobInitializationOptions</a> |
+| Param         | Type                                                                              | Description                           |
+| ------------- | --------------------------------------------------------------------------------- | ------------------------------------- |
+| **`options`** | <code><a href="#admobinitializationoptions">AdMobInitializationOptions</a></code> | Optional SDK initialization settings. |
 
 **Since:** 1.1.2
 
@@ -450,7 +524,8 @@ Initialize AdMob with <a href="#admobinitializationoptions">AdMobInitializationO
 trackingAuthorizationStatus() => Promise<TrackingAuthorizationStatusInterface>
 ```
 
-Confirm requestTrackingAuthorization status (iOS &gt;14)
+Returns the current App Tracking Transparency authorization status on iOS 14 and later.
+Returns `authorized` on earlier iOS versions, Android, and web.
 
 **Returns:** <code>Promise&lt;<a href="#trackingauthorizationstatusinterface">TrackingAuthorizationStatusInterface</a>&gt;</code>
 
@@ -465,7 +540,8 @@ Confirm requestTrackingAuthorization status (iOS &gt;14)
 requestTrackingAuthorization() => Promise<void>
 ```
 
-request requestTrackingAuthorization (iOS &gt;14).
+Requests App Tracking Transparency authorization on iOS 14 and later.
+Resolves without taking action on earlier iOS versions, Android, and web.
 
 **Since:** 5.2.0
 
@@ -478,7 +554,7 @@ request requestTrackingAuthorization (iOS &gt;14).
 setApplicationMuted(options: ApplicationMutedOptions) => Promise<void>
 ```
 
-Report application mute state to AdMob SDK
+Reports whether the application audio is muted to the Google Mobile Ads SDK.
 
 | Param         | Type                                                                        |
 | ------------- | --------------------------------------------------------------------------- |
@@ -495,7 +571,7 @@ Report application mute state to AdMob SDK
 setApplicationVolume(options: ApplicationVolumeOptions) => Promise<void>
 ```
 
-Report application volume to AdMob SDK
+Reports the application audio volume to the Google Mobile Ads SDK.
 
 | Param         | Type                                                                          |
 | ------------- | ----------------------------------------------------------------------------- |
@@ -509,36 +585,46 @@ Report application volume to AdMob SDK
 ### loadAppOpen(...)
 
 ```typescript
-loadAppOpen(options: AppOpenAdOptions) => Promise<void>
+loadAppOpen(options: AppOpenAdOptions) => Promise<AdLoadInfo>
 ```
 
-Load an App Open ad
+Loads an App Open ad and returns the loaded ad unit ID.
 
 | Param         | Type                                                          |
 | ------------- | ------------------------------------------------------------- |
 | **`options`** | <code><a href="#appopenadoptions">AppOpenAdOptions</a></code> |
 
+**Returns:** <code>Promise&lt;<a href="#adloadinfo">AdLoadInfo</a>&gt;</code>
+
 --------------------
 
 
-### showAppOpen()
+### showAppOpen(...)
 
 ```typescript
-showAppOpen() => Promise<void>
+showAppOpen(options?: AdShowOptions | undefined) => Promise<void>
 ```
 
-Shows the App Open ad if loaded
+Shows a loaded App Open ad.
+
+| Param         | Type                                                    | Description                                                                            |
+| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#adshowoptions">AdShowOptions</a></code> | Optional. Pass { adId } to show a specific prepared ad instead of the most recent one. |
 
 --------------------
 
 
-### isAppOpenLoaded()
+### isAppOpenLoaded(...)
 
 ```typescript
-isAppOpenLoaded() => Promise<{ value: boolean; }>
+isAppOpenLoaded(options?: AdShowOptions | undefined) => Promise<{ value: boolean; }>
 ```
 
-Check if the App Open ad is loaded
+Checks whether an App Open ad is loaded.
+
+| Param         | Type                                                    | Description                                                                            |
+| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#adshowoptions">AdShowOptions</a></code> | Optional. Pass an adId to check a specific prepared ad instead of the most recent one. |
 
 **Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>
 
@@ -548,13 +634,15 @@ Check if the App Open ad is loaded
 ### addListener(AppOpenAdPluginEvents.Loaded, ...)
 
 ```typescript
-addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>
+addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for App Open ad load events.
+
 | Param              | Type                                                                           |
 | ------------------ | ------------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.Loaded</a></code> |
-| **`listenerFunc`** | <code>() =&gt; void</code>                                                     |
+| **`listenerFunc`** | <code>(info: <a href="#adloadinfo">AdLoadInfo</a>) =&gt; void</code>           |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
 
@@ -567,6 +655,8 @@ addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: () => void) =
 addListener(eventName: AppOpenAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for App Open ad load failures.
+
 | Param              | Type                                                                                 |
 | ------------------ | ------------------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.FailedToLoad</a></code> |
@@ -583,6 +673,8 @@ addListener(eventName: AppOpenAdPluginEvents.FailedToLoad, listenerFunc: (error:
 addListener(eventName: AppOpenAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for App Open ad opened events.
+
 | Param              | Type                                                                           |
 | ------------------ | ------------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.Opened</a></code> |
@@ -599,6 +691,8 @@ addListener(eventName: AppOpenAdPluginEvents.Opened, listenerFunc: () => void) =
 addListener(eventName: AppOpenAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for App Open ad closed events.
+
 | Param              | Type                                                                           |
 | ------------------ | ------------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.Closed</a></code> |
@@ -615,6 +709,8 @@ addListener(eventName: AppOpenAdPluginEvents.Closed, listenerFunc: () => void) =
 addListener(eventName: AppOpenAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for App Open ad show failures.
+
 | Param              | Type                                                                                 |
 | ------------------ | ------------------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.FailedToShow</a></code> |
@@ -625,13 +721,31 @@ addListener(eventName: AppOpenAdPluginEvents.FailedToShow, listenerFunc: (error:
 --------------------
 
 
+### addListener(AppOpenAdPluginEvents.AdImpression, ...)
+
+```typescript
+addListener(eventName: AppOpenAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
+```
+
+Listens for App Open impression-level ad revenue events.
+
+| Param              | Type                                                                                 |
+| ------------------ | ------------------------------------------------------------------------------------ |
+| **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents.AdImpression</a></code> |
+| **`listenerFunc`** | <code>(data: <a href="#admobrevenuedata">AdMobRevenueData</a>) =&gt; void</code>     |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### showBanner(...)
 
 ```typescript
 showBanner(options: BannerAdOptions) => Promise<void>
 ```
 
-Show a banner Ad
+Displays a banner ad.
 
 | Param         | Type                                                        | Description                        |
 | ------------- | ----------------------------------------------------------- | ---------------------------------- |
@@ -648,7 +762,7 @@ Show a banner Ad
 hideBanner() => Promise<void>
 ```
 
-Hide the banner, remove it from screen, but can show it later
+Hides the current banner without destroying it.
 
 **Since:** 1.1.2
 
@@ -661,7 +775,7 @@ Hide the banner, remove it from screen, but can show it later
 resumeBanner() => Promise<void>
 ```
 
-Resume the banner, show it after hide
+Shows a previously hidden banner.
 
 **Since:** 1.1.2
 
@@ -674,7 +788,7 @@ Resume the banner, show it after hide
 removeBanner() => Promise<void>
 ```
 
-Destroy the banner, remove it from screen.
+Destroys the current banner and removes it from the screen.
 
 **Since:** 1.1.2
 
@@ -687,6 +801,8 @@ Destroy the banner, remove it from screen.
 addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: AdMobBannerSize) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for changes to the displayed banner dimensions.
+
 | Param              | Type                                                                              | Description         |
 | ------------------ | --------------------------------------------------------------------------------- | ------------------- |
 | **`eventName`**    | <code><a href="#banneradpluginevents">BannerAdPluginEvents.SizeChanged</a></code> | bannerAdSizeChanged |
@@ -705,7 +821,7 @@ addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: Ad
 addListener(eventName: BannerAdPluginEvents.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
-Notice: request loaded Banner ad
+Listens for banner ad load events.
 
 | Param              | Type                                                                         | Description    |
 | ------------------ | ---------------------------------------------------------------------------- | -------------- |
@@ -725,7 +841,7 @@ Notice: request loaded Banner ad
 addListener(eventName: BannerAdPluginEvents.FailedToLoad, listenerFunc: (info: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
-Notice: request failed Banner ad
+Listens for banner ad load failures.
 
 | Param              | Type                                                                               | Description          |
 | ------------------ | ---------------------------------------------------------------------------------- | -------------------- |
@@ -745,7 +861,7 @@ Notice: request failed Banner ad
 addListener(eventName: BannerAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
-Notice: full-screen banner view will be presented in response to the user clicking on an ad.
+Listens for banner overlay opened events.
 
 | Param              | Type                                                                         | Description    |
 | ------------------ | ---------------------------------------------------------------------------- | -------------- |
@@ -765,7 +881,7 @@ Notice: full-screen banner view will be presented in response to the user clicki
 addListener(eventName: BannerAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
-Notice: The full-screen banner view will been dismissed.
+Listens for banner overlay closed events.
 
 | Param              | Type                                                                         | Description    |
 | ------------------ | ---------------------------------------------------------------------------- | -------------- |
@@ -785,7 +901,7 @@ Notice: The full-screen banner view will been dismissed.
 addListener(eventName: BannerAdPluginEvents.AdImpression, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
-Unimplemented
+Listens for banner impression events.
 
 | Param              | Type                                                                               | Description  |
 | ------------------ | ---------------------------------------------------------------------------------- | ------------ |
@@ -799,6 +915,24 @@ Unimplemented
 --------------------
 
 
+### addListener(BannerAdPluginEvents.AdPaid, ...)
+
+```typescript
+addListener(eventName: BannerAdPluginEvents.AdPaid, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
+```
+
+Listens for banner impression-level ad revenue events.
+
+| Param              | Type                                                                             |
+| ------------------ | -------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#banneradpluginevents">BannerAdPluginEvents.AdPaid</a></code>     |
+| **`listenerFunc`** | <code>(data: <a href="#admobrevenuedata">AdMobRevenueData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### requestConsentInfo(...)
 
 ```typescript
@@ -865,7 +999,7 @@ Resets the UMP SDK state. Call requestConsentInfo function again to allow user m
 prepareInterstitial(options: AdOptions) => Promise<AdLoadInfo>
 ```
 
-Prepare interstitial banner
+Loads an interstitial ad and returns the loaded ad unit ID.
 
 | Param         | Type                                            | Description                        |
 | ------------- | ----------------------------------------------- | ---------------------------------- |
@@ -878,13 +1012,17 @@ Prepare interstitial banner
 --------------------
 
 
-### showInterstitial()
+### showInterstitial(...)
 
 ```typescript
-showInterstitial() => Promise<void>
+showInterstitial(options?: AdShowOptions | undefined) => Promise<void>
 ```
 
-Show interstitial ad when it’s ready
+Shows a loaded interstitial ad.
+
+| Param         | Type                                                    | Description                                                                            |
+| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#adshowoptions">AdShowOptions</a></code> | Optional. Pass { adId } to show a specific prepared ad instead of the most recent one. |
 
 **Since:** 1.1.2
 
@@ -897,6 +1035,8 @@ Show interstitial ad when it’s ready
 addListener(eventName: InterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for interstitial ad load failures.
+
 | Param              | Type                                                                                           |
 | ------------------ | ---------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.FailedToLoad</a></code> |
@@ -913,6 +1053,8 @@ addListener(eventName: InterstitialAdPluginEvents.FailedToLoad, listenerFunc: (e
 addListener(eventName: InterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for interstitial ad load events.
+
 | Param              | Type                                                                                     |
 | ------------------ | ---------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.Loaded</a></code> |
@@ -929,6 +1071,8 @@ addListener(eventName: InterstitialAdPluginEvents.Loaded, listenerFunc: (info: A
 addListener(eventName: InterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for interstitial ad dismissed events.
+
 | Param              | Type                                                                                        |
 | ------------------ | ------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.Dismissed</a></code> |
@@ -945,6 +1089,8 @@ addListener(eventName: InterstitialAdPluginEvents.Dismissed, listenerFunc: () =>
 addListener(eventName: InterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for interstitial ad show failures.
+
 | Param              | Type                                                                                           |
 | ------------------ | ---------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.FailedToShow</a></code> |
@@ -961,6 +1107,8 @@ addListener(eventName: InterstitialAdPluginEvents.FailedToShow, listenerFunc: (e
 addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for interstitial ad shown events.
+
 | Param              | Type                                                                                     |
 | ------------------ | ---------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.Showed</a></code> |
@@ -971,13 +1119,31 @@ addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => vo
 --------------------
 
 
+### addListener(InterstitialAdPluginEvents.AdImpression, ...)
+
+```typescript
+addListener(eventName: InterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
+```
+
+Listens for interstitial impression-level ad revenue events.
+
+| Param              | Type                                                                                           |
+| ------------------ | ---------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#interstitialadpluginevents">InterstitialAdPluginEvents.AdImpression</a></code> |
+| **`listenerFunc`** | <code>(data: <a href="#admobrevenuedata">AdMobRevenueData</a>) =&gt; void</code>               |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### prepareRewardVideoAd(...)
 
 ```typescript
 prepareRewardVideoAd(options: RewardAdOptions) => Promise<AdLoadInfo>
 ```
 
-Prepare a reward video ad
+Loads a rewarded ad and returns the loaded ad unit ID.
 
 | Param         | Type                                                        | Description                                    |
 | ------------- | ----------------------------------------------------------- | ---------------------------------------------- |
@@ -990,13 +1156,17 @@ Prepare a reward video ad
 --------------------
 
 
-### showRewardVideoAd()
+### showRewardVideoAd(...)
 
 ```typescript
-showRewardVideoAd() => Promise<AdMobRewardItem>
+showRewardVideoAd(options?: AdShowOptions | undefined) => Promise<AdMobRewardItem>
 ```
 
-Show a reward video ad
+Shows a loaded rewarded ad and resolves when the user earns the reward.
+
+| Param         | Type                                                    | Description                                                                            |
+| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#adshowoptions">AdShowOptions</a></code> | Optional. Pass { adId } to show a specific prepared ad instead of the most recent one. |
 
 **Returns:** <code>Promise&lt;<a href="#admobrewarditem">AdMobRewardItem</a>&gt;</code>
 
@@ -1011,6 +1181,8 @@ Show a reward video ad
 addListener(eventName: RewardAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded ad load failures.
+
 | Param              | Type                                                                               |
 | ------------------ | ---------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.FailedToLoad</a></code> |
@@ -1027,6 +1199,8 @@ addListener(eventName: RewardAdPluginEvents.FailedToLoad, listenerFunc: (error:
 addListener(eventName: RewardAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded ad load events.
+
 | Param              | Type                                                                         |
 | ------------------ | ---------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.Loaded</a></code> |
@@ -1043,6 +1217,8 @@ addListener(eventName: RewardAdPluginEvents.Loaded, listenerFunc: (info: AdLoadI
 addListener(eventName: RewardAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardItem) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for earned reward events.
+
 | Param              | Type                                                                             |
 | ------------------ | -------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.Rewarded</a></code>   |
@@ -1059,6 +1235,8 @@ addListener(eventName: RewardAdPluginEvents.Rewarded, listenerFunc: (reward: AdM
 addListener(eventName: RewardAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded ad dismissed events.
+
 | Param              | Type                                                                            |
 | ------------------ | ------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.Dismissed</a></code> |
@@ -1075,6 +1253,8 @@ addListener(eventName: RewardAdPluginEvents.Dismissed, listenerFunc: () => void)
 addListener(eventName: RewardAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded ad show failures.
+
 | Param              | Type                                                                               |
 | ------------------ | ---------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.FailedToShow</a></code> |
@@ -1091,6 +1271,8 @@ addListener(eventName: RewardAdPluginEvents.FailedToShow, listenerFunc: (error:
 addListener(eventName: RewardAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded ad shown events.
+
 | Param              | Type                                                                         |
 | ------------------ | ---------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.Showed</a></code> |
@@ -1101,17 +1283,35 @@ addListener(eventName: RewardAdPluginEvents.Showed, listenerFunc: () => void) =>
 --------------------
 
 
+### addListener(RewardAdPluginEvents.AdImpression, ...)
+
+```typescript
+addListener(eventName: RewardAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
+```
+
+Listens for rewarded impression-level ad revenue events.
+
+| Param              | Type                                                                               |
+| ------------------ | ---------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#rewardadpluginevents">RewardAdPluginEvents.AdImpression</a></code> |
+| **`listenerFunc`** | <code>(data: <a href="#admobrevenuedata">AdMobRevenueData</a>) =&gt; void</code>   |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### prepareRewardInterstitialAd(...)
 
 ```typescript
 prepareRewardInterstitialAd(options: RewardInterstitialAdOptions) => Promise<AdLoadInfo>
 ```
 
-Prepare a reward video ad
+Loads a rewarded interstitial ad and returns the loaded ad unit ID.
 
-| Param         | Type                                                                                | Description                                    |
-| ------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------- |
-| **`options`** | <code><a href="#rewardinterstitialadoptions">RewardInterstitialAdOptions</a></code> | <a href="#rewardadoptions">RewardAdOptions</a> |
+| Param         | Type                                                                                | Description                                                            |
+| ------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| **`options`** | <code><a href="#rewardinterstitialadoptions">RewardInterstitialAdOptions</a></code> | <a href="#rewardinterstitialadoptions">RewardInterstitialAdOptions</a> |
 
 **Returns:** <code>Promise&lt;<a href="#adloadinfo">AdLoadInfo</a>&gt;</code>
 
@@ -1120,13 +1320,17 @@ Prepare a reward video ad
 --------------------
 
 
-### showRewardInterstitialAd()
+### showRewardInterstitialAd(...)
 
 ```typescript
-showRewardInterstitialAd() => Promise<AdMobRewardInterstitialItem>
+showRewardInterstitialAd(options?: AdShowOptions | undefined) => Promise<AdMobRewardInterstitialItem>
 ```
 
-Show a reward video ad
+Shows a loaded rewarded interstitial ad and resolves when the user earns the reward.
+
+| Param         | Type                                                    | Description                                                                            |
+| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#adshowoptions">AdShowOptions</a></code> | Optional. Pass { adId } to show a specific prepared ad instead of the most recent one. |
 
 **Returns:** <code>Promise&lt;<a href="#admobrewardinterstitialitem">AdMobRewardInterstitialItem</a>&gt;</code>
 
@@ -1141,6 +1345,8 @@ Show a reward video ad
 addListener(eventName: RewardInterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded interstitial ad load failures.
+
 | Param              | Type                                                                                                       |
 | ------------------ | ---------------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.FailedToLoad</a></code> |
@@ -1157,6 +1363,8 @@ addListener(eventName: RewardInterstitialAdPluginEvents.FailedToLoad, listenerFu
 addListener(eventName: RewardInterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded interstitial ad load events.
+
 | Param              | Type                                                                                                 |
 | ------------------ | ---------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.Loaded</a></code> |
@@ -1173,6 +1381,8 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Loaded, listenerFunc: (i
 addListener(eventName: RewardInterstitialAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardInterstitialItem) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for earned reward events.
+
 | Param              | Type                                                                                                     |
 | ------------------ | -------------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.Rewarded</a></code>   |
@@ -1189,6 +1399,8 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Rewarded, listenerFunc:
 addListener(eventName: RewardInterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded interstitial ad dismissed events.
+
 | Param              | Type                                                                                                    |
 | ------------------ | ------------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.Dismissed</a></code> |
@@ -1205,6 +1417,8 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Dismissed, listenerFunc:
 addListener(eventName: RewardInterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded interstitial ad show failures.
+
 | Param              | Type                                                                                                       |
 | ------------------ | ---------------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.FailedToShow</a></code> |
@@ -1221,6 +1435,8 @@ addListener(eventName: RewardInterstitialAdPluginEvents.FailedToShow, listenerFu
 addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Listens for rewarded interstitial ad shown events.
+
 | Param              | Type                                                                                                 |
 | ------------------ | ---------------------------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.Showed</a></code> |
@@ -1231,25 +1447,45 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: ()
 --------------------
 
 
+### addListener(RewardInterstitialAdPluginEvents.AdImpression, ...)
+
+```typescript
+addListener(eventName: RewardInterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
+```
+
+Listens for rewarded interstitial impression-level ad revenue events.
+
+| Param              | Type                                                                                                       |
+| ------------------ | ---------------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#rewardinterstitialadpluginevents">RewardInterstitialAdPluginEvents.AdImpression</a></code> |
+| **`listenerFunc`** | <code>(data: <a href="#admobrevenuedata">AdMobRevenueData</a>) =&gt; void</code>                           |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
 #### AdMobInitializationOptions
 
-| Prop                               | Type                                                              | Description                                                                                                                                                                                                                                                 | Default            | Since |
-| ---------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`testingDevices`**               | <code>string[]</code>                                             | An Array of devices IDs that will be marked as tested devices if {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.initializeForTesting</a>} is true (Real Ads will be served to Testing devices, but they will not count as 'real'). |                    | 1.2.0 |
-| **`initializeForTesting`**         | <code>boolean</code>                                              | If set to true, the devices on {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.testingDevices</a>} will be registered to receive test production ads.                                                                               | <code>false</code> | 1.2.0 |
-| **`tagForChildDirectedTreatment`** | <code>boolean</code>                                              | For purposes of the Children's Online Privacy Protection Act (COPPA), there is a setting called tagForChildDirectedTreatment.                                                                                                                               |                    | 3.1.0 |
-| **`tagForUnderAgeOfConsent`**      | <code>boolean</code>                                              | When using this feature, a Tag For Users under the Age of Consent in Europe (TFUA) parameter will be included in all future ad requests.                                                                                                                    |                    | 3.1.0 |
-| **`maxAdContentRating`**           | <code><a href="#maxadcontentrating">MaxAdContentRating</a></code> | As an app developer, you can indicate whether you want Google to treat your content as child-directed when you make an ad request.                                                                                                                          |                    | 3.1.0 |
+| Prop                               | Type                                                              | Description                                                                                                                                                                                                                                     | Default            | Since |
+| ---------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`testingDevices`**               | <code>string[]</code>                                             | Device IDs to register as test devices when {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.initializeForTesting</a>} is `true`. Requests from registered devices receive test ads and do not generate invalid traffic. |                    | 1.2.0 |
+| **`initializeForTesting`**         | <code>boolean</code>                                              | Whether to register {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.testingDevices</a>} as test devices.                                                                                                                | <code>false</code> | 1.2.0 |
+| **`tagForChildDirectedTreatment`** | <code>boolean</code>                                              | For purposes of the Children's Online Privacy Protection Act (COPPA), there is a setting called tagForChildDirectedTreatment.                                                                                                                   |                    | 3.1.0 |
+| **`tagForUnderAgeOfConsent`**      | <code>boolean</code>                                              | When using this feature, a Tag For Users under the Age of Consent in Europe (TFUA) parameter will be included in all future ad requests.                                                                                                        |                    | 3.1.0 |
+| **`maxAdContentRating`**           | <code><a href="#maxadcontentrating">MaxAdContentRating</a></code> | The maximum ad content rating applied to all ad requests. Ads with a higher rating are excluded.                                                                                                                                                |                    | 3.1.0 |
 
 
 #### TrackingAuthorizationStatusInterface
 
-| Prop         | Type                                                                     |
-| ------------ | ------------------------------------------------------------------------ |
-| **`status`** | <code>'authorized' \| 'denied' \| 'notDetermined' \| 'restricted'</code> |
+The current iOS App Tracking Transparency authorization status.
+
+| Prop         | Type                                                                     | Description                                                     |
+| ------------ | ------------------------------------------------------------------------ | --------------------------------------------------------------- |
+| **`status`** | <code>'authorized' \| 'denied' \| 'notDetermined' \| 'restricted'</code> | The authorization status reported by App Tracking Transparency. |
 
 
 #### ApplicationMutedOptions
@@ -1261,16 +1497,36 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: ()
 
 #### ApplicationVolumeOptions
 
-| Prop         | Type                                                                               | Description                                                                                                                                                                                                                          | Since |
-| ------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
-| **`volume`** | <code>0 \| 1 \| 0.1 \| 0.2 \| 0.3 \| 0.4 \| 0.5 \| 0.6 \| 0.7 \| 0.8 \| 0.9</code> | If your app has its own volume controls (such as custom music or sound effect volumes), disclosing app volume to the Google Mobile Ads SDK allows video ads to respect app volume settings. enable set 0.0 - 1.0, any float allowed. | 4.1.1 |
+| Prop         | Type                                                                               | Description                                                                                                                                                                                                                                               | Since |
+| ------------ | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`volume`** | <code>0 \| 1 \| 0.1 \| 0.2 \| 0.3 \| 0.4 \| 0.5 \| 0.6 \| 0.7 \| 0.8 \| 0.9</code> | If your app has its own volume controls (such as custom music or sound effect volumes), disclosing app volume to the Google Mobile Ads SDK allows video ads to respect app volume settings. Use a supported value from 0.0 (silent) to 1.0 (full volume). | 4.1.1 |
+
+
+#### AdLoadInfo
+
+Information returned after an ad loads successfully.
+
+| Prop           | Type                | Description                      |
+| -------------- | ------------------- | -------------------------------- |
+| **`adUnitId`** | <code>string</code> | The ad unit ID of the loaded ad. |
 
 
 #### AppOpenAdOptions
 
-| Prop       | Type                |
-| ---------- | ------------------- |
-| **`adId`** | <code>string</code> |
+Options for loading an App Open ad.
+
+| Prop       | Type                | Description                      |
+| ---------- | ------------------- | -------------------------------- |
+| **`adId`** | <code>string</code> | The App Open ad unit ID to load. |
+
+
+#### AdShowOptions
+
+Options for selecting a previously loaded ad to show or inspect.
+
+| Prop       | Type                | Description                                                                                                            | Since |
+| ---------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`adId`** | <code>string</code> | The ad unit ID of a previously prepared ad to target. If omitted, the operation targets the most recently prepared ad. | 8.0.1 |
 
 
 #### PluginListenerHandle
@@ -1282,8 +1538,7 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: ()
 
 #### AdMobError
 
-For more information
-https://developers.google.com/android/reference/com/google/android/gms/ads/AdError
+An error returned by the Google Mobile Ads SDK.
 
 | Prop          | Type                | Description                            |
 | ------------- | ------------------- | -------------------------------------- |
@@ -1291,29 +1546,46 @@ https://developers.google.com/android/reference/com/google/android/gms/ads/AdErr
 | **`message`** | <code>string</code> | Gets the message describing the error. |
 
 
+#### AdMobRevenueData
+
+Impression-level ad revenue data emitted by a paid event.
+
+| Prop               | Type                                                          | Description                                                                                       |
+| ------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| **`adUnitId`**     | <code>string</code>                                           | The ad unit ID associated with the paid event.                                                    |
+| **`valueMicros`**  | <code>number</code>                                           | The ad value in micros, where 1,000,000 micros equals one currency unit.                          |
+| **`currencyCode`** | <code>string</code>                                           | The ISO 4217 currency code for `valueMicros`.                                                     |
+| **`precision`**    | <code><a href="#advalueprecision">AdValuePrecision</a></code> | The precision of the reported ad value.                                                           |
+| **`networkName`**  | <code>string</code>                                           | The mediation adapter class name that served the impression, or an empty string when unavailable. |
+| **`impressionId`** | <code>string</code>                                           | The response identifier associated with the impression, or an empty string when unavailable.      |
+
+
 #### BannerAdOptions
 
-This interface extends <a href="#adoptions">AdOptions</a>
+Options for displaying a banner ad.
 
-| Prop                | Type                                                          | Description                                                                                                                                                                                                                                                                                                          | Default                      | Since |
-| ------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----- |
-| **`adSize`**        | <code><a href="#banneradsize">BannerAdSize</a></code>         | Banner Ad Size, defaults to ADAPTIVE_BANNER. IT can be: ADAPTIVE_BANNER, SMART_BANNER, BANNER, MEDIUM_RECTANGLE, FULL_BANNER, LEADERBOARD                                                                                                                                                                            | <code>ADAPTIVE_BANNER</code> | 3.0.0 |
-| **`position`**      | <code><a href="#banneradposition">BannerAdPosition</a></code> | Set Banner Ad position. TOP_CENTER or CENTER or BOTTOM_CENTER                                                                                                                                                                                                                                                        | <code>TOP_CENTER</code>      | 1.1.2 |
-| **`adId`**          | <code>string</code>                                           | The ad unit ID that you want to request                                                                                                                                                                                                                                                                              |                              | 1.1.2 |
-| **`isTesting`**     | <code>boolean</code>                                          | You can use test mode of ad.                                                                                                                                                                                                                                                                                         | <code>false</code>           | 1.1.2 |
-| **`margin`**        | <code>number</code>                                           | Margin Banner. Default is 0px; If position is BOTTOM_CENTER, margin is be margin-bottom. If position is TOP_CENTER, margin is be margin-top.                                                                                                                                                                         | <code>0</code>               | 1.1.2 |
-| **`npa`**           | <code>boolean</code>                                          | The default behavior of the Google Mobile Ads SDK is to serve personalized ads. Set this to true to request Non-Personalized Ads                                                                                                                                                                                     | <code>false</code>           | 1.2.0 |
-| **`immersiveMode`** | <code>boolean</code>                                          | Sets a flag that controls if this interstitial or reward object will be displayed in immersive mode. Call this method before show. During show, if this flag is on and immersive mode is supported, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION will be turned on for interstitial or reward ad. |                              | 7.0.3 |
+This interface extends <a href="#adoptions">AdOptions</a>.
+
+| Prop                | Type                                                          | Description                                                                                                                                                             | Default                      | Since |
+| ------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----- |
+| **`adSize`**        | <code><a href="#banneradsize">BannerAdSize</a></code>         | The banner size to display.                                                                                                                                             | <code>ADAPTIVE_BANNER</code> | 3.0.0 |
+| **`position`**      | <code><a href="#banneradposition">BannerAdPosition</a></code> | The position where the banner is displayed.                                                                                                                             | <code>TOP_CENTER</code>      | 1.1.2 |
+| **`adId`**          | <code>string</code>                                           | The ad unit ID to load.                                                                                                                                                 |                              | 1.1.2 |
+| **`isTesting`**     | <code>boolean</code>                                          | Whether to request a test ad.                                                                                                                                           | <code>false</code>           | 1.1.2 |
+| **`margin`**        | <code>number</code>                                           | The banner margin in logical display units (dp on Android and points on iOS). For `BOTTOM_CENTER`, this is the bottom margin. For `TOP_CENTER`, this is the top margin. | <code>0</code>               | 1.1.2 |
+| **`npa`**           | <code>boolean</code>                                          | Whether to request non-personalized ads.                                                                                                                                | <code>false</code>           | 1.2.0 |
+| **`immersiveMode`** | <code>boolean</code>                                          | Whether to display a full-screen ad in immersive mode on Android.                                                                                                       |                              | 7.0.3 |
 
 
 #### AdMobBannerSize
 
-When notice listener of OnAdLoaded, you can get banner size.
+The displayed banner dimensions in logical display units (dp on Android and points on iOS).
+A hidden, removed, or failed banner can report both dimensions as `0`.
 
-| Prop         | Type                |
-| ------------ | ------------------- |
-| **`width`**  | <code>number</code> |
-| **`height`** | <code>number</code> |
+| Prop         | Type                | Description                  |
+| ------------ | ------------------- | ---------------------------- |
+| **`width`**  | <code>number</code> | The displayed banner width.  |
+| **`height`** | <code>number</code> | The displayed banner height. |
 
 
 #### AdmobConsentInfo
@@ -1335,68 +1607,65 @@ When notice listener of OnAdLoaded, you can get banner size.
 | **`tagForUnderAgeOfConsent`** | <code>boolean</code>                                                              | Set to `true` to provide the option for the user to accept being shown personalized ads.                     | <code>false</code> | 5.0.0 |
 
 
-#### AdLoadInfo
-
-| Prop           | Type                |
-| -------------- | ------------------- |
-| **`adUnitId`** | <code>string</code> |
-
-
 #### AdOptions
 
-| Prop                | Type                 | Description                                                                                                                                                                                                                                                                                                          | Default            | Since |
-| ------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`adId`**          | <code>string</code>  | The ad unit ID that you want to request                                                                                                                                                                                                                                                                              |                    | 1.1.2 |
-| **`isTesting`**     | <code>boolean</code> | You can use test mode of ad.                                                                                                                                                                                                                                                                                         | <code>false</code> | 1.1.2 |
-| **`margin`**        | <code>number</code>  | Margin Banner. Default is 0px; If position is BOTTOM_CENTER, margin is be margin-bottom. If position is TOP_CENTER, margin is be margin-top.                                                                                                                                                                         | <code>0</code>     | 1.1.2 |
-| **`npa`**           | <code>boolean</code> | The default behavior of the Google Mobile Ads SDK is to serve personalized ads. Set this to true to request Non-Personalized Ads                                                                                                                                                                                     | <code>false</code> | 1.2.0 |
-| **`immersiveMode`** | <code>boolean</code> | Sets a flag that controls if this interstitial or reward object will be displayed in immersive mode. Call this method before show. During show, if this flag is on and immersive mode is supported, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION will be turned on for interstitial or reward ad. |                    | 7.0.3 |
+Common options for requesting an ad.
+
+| Prop                | Type                 | Description                                                                                                                                                             | Default            | Since |
+| ------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`adId`**          | <code>string</code>  | The ad unit ID to load.                                                                                                                                                 |                    | 1.1.2 |
+| **`isTesting`**     | <code>boolean</code> | Whether to request a test ad.                                                                                                                                           | <code>false</code> | 1.1.2 |
+| **`margin`**        | <code>number</code>  | The banner margin in logical display units (dp on Android and points on iOS). For `BOTTOM_CENTER`, this is the bottom margin. For `TOP_CENTER`, this is the top margin. | <code>0</code>     | 1.1.2 |
+| **`npa`**           | <code>boolean</code> | Whether to request non-personalized ads.                                                                                                                                | <code>false</code> | 1.2.0 |
+| **`immersiveMode`** | <code>boolean</code> | Whether to display a full-screen ad in immersive mode on Android.                                                                                                       |                    | 7.0.3 |
 
 
 #### RewardAdOptions
 
-| Prop                | Type                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                          | Default            | Since |
-| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`ssv`**           | <code><a href="#atleastone">AtLeastOne</a>&lt;{ /** * An optional UserId to pass to your SSV callback function. */ userId: string; /** * An optional custom set of data to pass to your SSV callback function. */ customData: string; }&gt;</code> | If you have enabled SSV in your AdMob Application. You can provide customData or a userId be passed to your callback to do further processing on. *Important* You *HAVE* to define one of them.                                                                                                                      |                    |       |
-| **`adId`**          | <code>string</code>                                                                                                                                                                                                                                | The ad unit ID that you want to request                                                                                                                                                                                                                                                                              |                    | 1.1.2 |
-| **`isTesting`**     | <code>boolean</code>                                                                                                                                                                                                                               | You can use test mode of ad.                                                                                                                                                                                                                                                                                         | <code>false</code> | 1.1.2 |
-| **`margin`**        | <code>number</code>                                                                                                                                                                                                                                | Margin Banner. Default is 0px; If position is BOTTOM_CENTER, margin is be margin-bottom. If position is TOP_CENTER, margin is be margin-top.                                                                                                                                                                         | <code>0</code>     | 1.1.2 |
-| **`npa`**           | <code>boolean</code>                                                                                                                                                                                                                               | The default behavior of the Google Mobile Ads SDK is to serve personalized ads. Set this to true to request Non-Personalized Ads                                                                                                                                                                                     | <code>false</code> | 1.2.0 |
-| **`immersiveMode`** | <code>boolean</code>                                                                                                                                                                                                                               | Sets a flag that controls if this interstitial or reward object will be displayed in immersive mode. Call this method before show. During show, if this flag is on and immersive mode is supported, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION will be turned on for interstitial or reward ad. |                    | 7.0.3 |
+Options for loading a rewarded ad.
+
+| Prop                | Type                                                                                                                                                                                                     | Description                                                                                                                                                             | Default            | Since |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`ssv`**           | <code><a href="#atleastone">AtLeastOne</a>&lt;{ /** * A user identifier passed to the SSV callback. */ userId: string; /** * Custom data passed to the SSV callback. */ customData: string; }&gt;</code> | Server-side verification options for the rewarded ad. Provide at least one of `userId` or `customData`.                                                                 |                    |       |
+| **`adId`**          | <code>string</code>                                                                                                                                                                                      | The ad unit ID to load.                                                                                                                                                 |                    | 1.1.2 |
+| **`isTesting`**     | <code>boolean</code>                                                                                                                                                                                     | Whether to request a test ad.                                                                                                                                           | <code>false</code> | 1.1.2 |
+| **`margin`**        | <code>number</code>                                                                                                                                                                                      | The banner margin in logical display units (dp on Android and points on iOS). For `BOTTOM_CENTER`, this is the bottom margin. For `TOP_CENTER`, this is the top margin. | <code>0</code>     | 1.1.2 |
+| **`npa`**           | <code>boolean</code>                                                                                                                                                                                     | Whether to request non-personalized ads.                                                                                                                                | <code>false</code> | 1.2.0 |
+| **`immersiveMode`** | <code>boolean</code>                                                                                                                                                                                     | Whether to display a full-screen ad in immersive mode on Android.                                                                                                       |                    | 7.0.3 |
 
 
 #### AdMobRewardItem
 
-For more information
-https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
+The reward earned by the user after viewing a rewarded ad.
 
-| Prop         | Type                | Description              |
-| ------------ | ------------------- | ------------------------ |
-| **`type`**   | <code>string</code> | Rewarded type user got   |
-| **`amount`** | <code>number</code> | Rewarded amount user got |
+| Prop         | Type                | Description                                      |
+| ------------ | ------------------- | ------------------------------------------------ |
+| **`type`**   | <code>string</code> | The reward item type configured for the ad unit. |
+| **`amount`** | <code>number</code> | The reward amount earned by the user.            |
 
 
 #### RewardInterstitialAdOptions
 
-| Prop                | Type                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                          | Default            | Since |
-| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`ssv`**           | <code><a href="#atleastone">AtLeastOne</a>&lt;{ /** * An optional UserId to pass to your SSV callback function. */ userId: string; /** * An optional custom set of data to pass to your SSV callback function. */ customData: string; }&gt;</code> | If you have enabled SSV in your AdMob Application. You can provide customData or a userId be passed to your callback to do further processing on. *Important* You *HAVE* to define one of them.                                                                                                                      |                    |       |
-| **`adId`**          | <code>string</code>                                                                                                                                                                                                                                | The ad unit ID that you want to request                                                                                                                                                                                                                                                                              |                    | 1.1.2 |
-| **`isTesting`**     | <code>boolean</code>                                                                                                                                                                                                                               | You can use test mode of ad.                                                                                                                                                                                                                                                                                         | <code>false</code> | 1.1.2 |
-| **`margin`**        | <code>number</code>                                                                                                                                                                                                                                | Margin Banner. Default is 0px; If position is BOTTOM_CENTER, margin is be margin-bottom. If position is TOP_CENTER, margin is be margin-top.                                                                                                                                                                         | <code>0</code>     | 1.1.2 |
-| **`npa`**           | <code>boolean</code>                                                                                                                                                                                                                               | The default behavior of the Google Mobile Ads SDK is to serve personalized ads. Set this to true to request Non-Personalized Ads                                                                                                                                                                                     | <code>false</code> | 1.2.0 |
-| **`immersiveMode`** | <code>boolean</code>                                                                                                                                                                                                                               | Sets a flag that controls if this interstitial or reward object will be displayed in immersive mode. Call this method before show. During show, if this flag is on and immersive mode is supported, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION will be turned on for interstitial or reward ad. |                    | 7.0.3 |
+Options for loading a rewarded interstitial ad.
+
+| Prop                | Type                                                                                                                                                                                                     | Description                                                                                                                                                             | Default            | Since |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`ssv`**           | <code><a href="#atleastone">AtLeastOne</a>&lt;{ /** * A user identifier passed to the SSV callback. */ userId: string; /** * Custom data passed to the SSV callback. */ customData: string; }&gt;</code> | Server-side verification options for the rewarded interstitial ad. Provide at least one of `userId` or `customData`.                                                    |                    |       |
+| **`adId`**          | <code>string</code>                                                                                                                                                                                      | The ad unit ID to load.                                                                                                                                                 |                    | 1.1.2 |
+| **`isTesting`**     | <code>boolean</code>                                                                                                                                                                                     | Whether to request a test ad.                                                                                                                                           | <code>false</code> | 1.1.2 |
+| **`margin`**        | <code>number</code>                                                                                                                                                                                      | The banner margin in logical display units (dp on Android and points on iOS). For `BOTTOM_CENTER`, this is the bottom margin. For `TOP_CENTER`, this is the top margin. | <code>0</code>     | 1.1.2 |
+| **`npa`**           | <code>boolean</code>                                                                                                                                                                                     | Whether to request non-personalized ads.                                                                                                                                | <code>false</code> | 1.2.0 |
+| **`immersiveMode`** | <code>boolean</code>                                                                                                                                                                                     | Whether to display a full-screen ad in immersive mode on Android.                                                                                                       |                    | 7.0.3 |
 
 
 #### AdMobRewardInterstitialItem
 
-For more information
-https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
+The reward earned by the user after viewing a rewarded interstitial ad.
 
-| Prop         | Type                | Description              |
-| ------------ | ------------------- | ------------------------ |
-| **`type`**   | <code>string</code> | Rewarded type user got   |
-| **`amount`** | <code>number</code> | Rewarded amount user got |
+| Prop         | Type                | Description                                      |
+| ------------ | ------------------- | ------------------------------------------------ |
+| **`type`**   | <code>string</code> | The reward item type configured for the ad unit. |
+| **`amount`** | <code>number</code> | The reward amount earned by the user.            |
 
 
 ### Type Aliases
@@ -1429,47 +1698,59 @@ From T, pick a set of properties whose keys are in the union K
 
 #### AppOpenAdPluginEvents
 
-| Members            | Value                                |
-| ------------------ | ------------------------------------ |
-| **`Loaded`**       | <code>'appOpenAdLoaded'</code>       |
-| **`FailedToLoad`** | <code>'appOpenAdFailedToLoad'</code> |
-| **`Opened`**       | <code>'appOpenAdOpened'</code>       |
-| **`Closed`**       | <code>'appOpenAdClosed'</code>       |
-| **`FailedToShow`** | <code>'appOpenAdFailedToShow'</code> |
+| Members            | Value                                | Description                                                           |
+| ------------------ | ------------------------------------ | --------------------------------------------------------------------- |
+| **`Loaded`**       | <code>'appOpenAdLoaded'</code>       | Emits when an App Open ad has loaded.                                 |
+| **`FailedToLoad`** | <code>'appOpenAdFailedToLoad'</code> | Emits when an App Open ad fails to load.                              |
+| **`Opened`**       | <code>'appOpenAdOpened'</code>       | Emits when an App Open ad is shown.                                   |
+| **`Closed`**       | <code>'appOpenAdClosed'</code>       | Emits when an App Open ad is dismissed.                               |
+| **`FailedToShow`** | <code>'appOpenAdFailedToShow'</code> | Emits when a loaded App Open ad fails to show.                        |
+| **`AdImpression`** | <code>'appOpenAdImpression'</code>   | Emits impression-level ad revenue data when a paid event is recorded. |
+
+
+#### AdValuePrecision
+
+| Members                 | Value          | Description                                         |
+| ----------------------- | -------------- | --------------------------------------------------- |
+| **`Unknown`**           | <code>0</code> | The ad value precision is unknown.                  |
+| **`Estimated`**         | <code>1</code> | The ad value is estimated from aggregated data.     |
+| **`PublisherProvided`** | <code>2</code> | The ad value was provided by the publisher.         |
+| **`Precise`**           | <code>3</code> | The ad value is the precise value paid for this ad. |
 
 
 #### BannerAdSize
 
-| Members                | Value                           | Description                                                                                         |
-| ---------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------- |
-| **`BANNER`**           | <code>'BANNER'</code>           | Mobile Marketing Association (MMA) banner ad size (320x50 density-independent pixels).              |
-| **`FULL_BANNER`**      | <code>'FULL_BANNER'</code>      | Interactive Advertising Bureau (IAB) full banner ad size (468x60 density-independent pixels).       |
-| **`LARGE_BANNER`**     | <code>'LARGE_BANNER'</code>     | Large banner ad size (320x100 density-independent pixels).                                          |
-| **`MEDIUM_RECTANGLE`** | <code>'MEDIUM_RECTANGLE'</code> | Interactive Advertising Bureau (IAB) medium rectangle ad size (300x250 density-independent pixels). |
-| **`LEADERBOARD`**      | <code>'LEADERBOARD'</code>      | Interactive Advertising Bureau (IAB) leaderboard ad size (728x90 density-independent pixels).       |
-| **`ADAPTIVE_BANNER`**  | <code>'ADAPTIVE_BANNER'</code>  | A dynamically sized banner that is full-width and auto-height.                                      |
-| **`SMART_BANNER`**     | <code>'SMART_BANNER'</code>     |                                                                                                     |
+| Members                | Value                           | Description                                                                                                              |
+| ---------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **`BANNER`**           | <code>'BANNER'</code>           | Mobile Marketing Association (MMA) banner ad size (320x50 density-independent pixels).                                   |
+| **`FULL_BANNER`**      | <code>'FULL_BANNER'</code>      | Interactive Advertising Bureau (IAB) full banner ad size (468x60 density-independent pixels).                            |
+| **`LARGE_BANNER`**     | <code>'LARGE_BANNER'</code>     | Large banner ad size (320x100 density-independent pixels).                                                               |
+| **`MEDIUM_RECTANGLE`** | <code>'MEDIUM_RECTANGLE'</code> | Interactive Advertising Bureau (IAB) medium rectangle ad size (300x250 density-independent pixels).                      |
+| **`LEADERBOARD`**      | <code>'LEADERBOARD'</code>      | Interactive Advertising Bureau (IAB) leaderboard ad size (728x90 density-independent pixels).                            |
+| **`ADAPTIVE_BANNER`**  | <code>'ADAPTIVE_BANNER'</code>  | A dynamically sized banner that is full-width and auto-height.                                                           |
+| **`SMART_BANNER`**     | <code>'SMART_BANNER'</code>     | A legacy smart banner sized to the screen width. Retained for compatibility; use `ADAPTIVE_BANNER` for new integrations. |
 
 
 #### BannerAdPosition
 
-| Members             | Value                        | Description                               |
-| ------------------- | ---------------------------- | ----------------------------------------- |
-| **`TOP_CENTER`**    | <code>'TOP_CENTER'</code>    | Banner position be top-center             |
-| **`CENTER`**        | <code>'CENTER'</code>        | Banner position be center                 |
-| **`BOTTOM_CENTER`** | <code>'BOTTOM_CENTER'</code> | Banner position be bottom-center(default) |
+| Members             | Value                        | Description                                              |
+| ------------------- | ---------------------------- | -------------------------------------------------------- |
+| **`TOP_CENTER`**    | <code>'TOP_CENTER'</code>    | Positions the banner at the top center of the screen.    |
+| **`CENTER`**        | <code>'CENTER'</code>        | Positions the banner at the center of the screen.        |
+| **`BOTTOM_CENTER`** | <code>'BOTTOM_CENTER'</code> | Positions the banner at the bottom center of the screen. |
 
 
 #### BannerAdPluginEvents
 
-| Members            | Value                               | Description                                                                                            |
-| ------------------ | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| **`SizeChanged`**  | <code>"bannerAdSizeChanged"</code>  |                                                                                                        |
-| **`Loaded`**       | <code>"bannerAdLoaded"</code>       |                                                                                                        |
-| **`FailedToLoad`** | <code>"bannerAdFailedToLoad"</code> |                                                                                                        |
-| **`Opened`**       | <code>"bannerAdOpened"</code>       | Open "Adsense" Event after user click banner                                                           |
-| **`Closed`**       | <code>"bannerAdClosed"</code>       | Close "Adsense" Event after user click banner                                                          |
-| **`AdImpression`** | <code>"bannerAdImpression"</code>   | Similarly, this method should be called when an impression is recorded for the ad by the mediated SDK. |
+| Members            | Value                               | Description                                                           |
+| ------------------ | ----------------------------------- | --------------------------------------------------------------------- |
+| **`SizeChanged`**  | <code>"bannerAdSizeChanged"</code>  | Emits when the displayed banner size changes.                         |
+| **`Loaded`**       | <code>"bannerAdLoaded"</code>       | Emits when a banner ad has loaded.                                    |
+| **`FailedToLoad`** | <code>"bannerAdFailedToLoad"</code> | Emits when a banner ad fails to load.                                 |
+| **`Opened`**       | <code>"bannerAdOpened"</code>       | Emits when a banner opens an overlay after the user taps it.          |
+| **`Closed`**       | <code>"bannerAdClosed"</code>       | Emits when the banner overlay is closed.                              |
+| **`AdImpression`** | <code>"bannerAdImpression"</code>   | Emits when an impression is recorded for the banner ad.               |
+| **`AdPaid`**       | <code>"bannerAdPaid"</code>         | Emits impression-level ad revenue data when a paid event is recorded. |
 
 
 #### AdmobConsentStatus
@@ -1504,37 +1785,40 @@ From T, pick a set of properties whose keys are in the union K
 
 #### InterstitialAdPluginEvents
 
-| Members            | Value                                     | Description                                                                            |
-| ------------------ | ----------------------------------------- | -------------------------------------------------------------------------------------- |
-| **`Loaded`**       | <code>'interstitialAdLoaded'</code>       | Emits after trying to prepare and Interstitial, when it is loaded and ready to be show |
-| **`FailedToLoad`** | <code>'interstitialAdFailedToLoad'</code> | Emits after trying to prepare and Interstitial, when it could not be loaded            |
-| **`Showed`**       | <code>'interstitialAdShowed'</code>       | Emits when the Interstitial ad is visible to the user                                  |
-| **`FailedToShow`** | <code>'interstitialAdFailedToShow'</code> | Emits when the Interstitial ad is failed to show                                       |
-| **`Dismissed`**    | <code>'interstitialAdDismissed'</code>    | Emits when the Interstitial ad is not visible to the user anymore.                     |
+| Members            | Value                                     | Description                                                           |
+| ------------------ | ----------------------------------------- | --------------------------------------------------------------------- |
+| **`Loaded`**       | <code>'interstitialAdLoaded'</code>       | Emits when an interstitial ad has loaded and is ready to show.        |
+| **`FailedToLoad`** | <code>'interstitialAdFailedToLoad'</code> | Emits when an interstitial ad fails to load.                          |
+| **`Showed`**       | <code>'interstitialAdShowed'</code>       | Emits when an interstitial ad is shown.                               |
+| **`FailedToShow`** | <code>'interstitialAdFailedToShow'</code> | Emits when a loaded interstitial ad fails to show.                    |
+| **`Dismissed`**    | <code>'interstitialAdDismissed'</code>    | Emits when an interstitial ad is dismissed.                           |
+| **`AdImpression`** | <code>'interstitialAdImpression'</code>   | Emits impression-level ad revenue data when a paid event is recorded. |
 
 
 #### RewardAdPluginEvents
 
-| Members            | Value                                        | Description                                                                                                                                                                                                                                                                                                                                            |
-| ------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **`Loaded`**       | <code>'onRewardedVideoAdLoaded'</code>       | Emits after trying to prepare a RewardAd and the Video is loaded and ready to be show                                                                                                                                                                                                                                                                  |
-| **`FailedToLoad`** | <code>'onRewardedVideoAdFailedToLoad'</code> | Emits after trying to prepare a RewardAd when it could not be loaded                                                                                                                                                                                                                                                                                   |
-| **`Showed`**       | <code>'onRewardedVideoAdShowed'</code>       | Emits when the AdReward video is visible to the user                                                                                                                                                                                                                                                                                                   |
-| **`FailedToShow`** | <code>'onRewardedVideoAdFailedToShow'</code> | Emits when the AdReward video is failed to show                                                                                                                                                                                                                                                                                                        |
-| **`Dismissed`**    | <code>'onRewardedVideoAdDismissed'</code>    | Emits when the AdReward video is not visible to the user anymore. **Important**: This has nothing to do with the reward it self. This event will emits in this two cases: 1. The user starts the video ad but close it before the reward emit. 2. The user start the video and see it until end, then gets the reward and after that the ad is closed. |
-| **`Rewarded`**     | <code>'onRewardedVideoAdReward'</code>       | Emits when user get rewarded from AdReward                                                                                                                                                                                                                                                                                                             |
+| Members            | Value                                        | Description                                                                                                                                                        |
+| ------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`Loaded`**       | <code>'onRewardedVideoAdLoaded'</code>       | Emits when a rewarded ad has loaded and is ready to show.                                                                                                          |
+| **`FailedToLoad`** | <code>'onRewardedVideoAdFailedToLoad'</code> | Emits when a rewarded ad fails to load.                                                                                                                            |
+| **`Showed`**       | <code>'onRewardedVideoAdShowed'</code>       | Emits when a rewarded ad is shown.                                                                                                                                 |
+| **`FailedToShow`** | <code>'onRewardedVideoAdFailedToShow'</code> | Emits when a loaded rewarded ad fails to show.                                                                                                                     |
+| **`Dismissed`**    | <code>'onRewardedVideoAdDismissed'</code>    | Emits when a rewarded ad is dismissed. This event does not indicate whether the user earned a reward. Listen for `Rewarded` separately before granting the reward. |
+| **`Rewarded`**     | <code>'onRewardedVideoAdReward'</code>       | Emits when the user earns the advertised reward.                                                                                                                   |
+| **`AdImpression`** | <code>'onRewardedVideoAdImpression'</code>   | Emits impression-level ad revenue data when a paid event is recorded.                                                                                              |
 
 
 #### RewardInterstitialAdPluginEvents
 
-| Members            | Value                                               | Description                                                                                                                                                                                                                                                                                                                                            |
-| ------------------ | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **`Loaded`**       | <code>'onRewardedInterstitialAdLoaded'</code>       | Emits after trying to prepare a RewardAd and the Video is loaded and ready to be show                                                                                                                                                                                                                                                                  |
-| **`FailedToLoad`** | <code>'onRewardedInterstitialAdFailedToLoad'</code> | Emits after trying to prepare a RewardAd when it could not be loaded                                                                                                                                                                                                                                                                                   |
-| **`Showed`**       | <code>'onRewardedInterstitialAdShowed'</code>       | Emits when the AdReward video is visible to the user                                                                                                                                                                                                                                                                                                   |
-| **`FailedToShow`** | <code>'onRewardedInterstitialAdFailedToShow'</code> | Emits when the AdReward video is failed to show                                                                                                                                                                                                                                                                                                        |
-| **`Dismissed`**    | <code>'onRewardedInterstitialAdDismissed'</code>    | Emits when the AdReward video is not visible to the user anymore. **Important**: This has nothing to do with the reward it self. This event will emits in this two cases: 1. The user starts the video ad but close it before the reward emit. 2. The user start the video and see it until end, then gets the reward and after that the ad is closed. |
-| **`Rewarded`**     | <code>'onRewardedInterstitialAdReward'</code>       | Emits when user get rewarded from AdReward                                                                                                                                                                                                                                                                                                             |
+| Members            | Value                                               | Description                                                                                                                                                                     |
+| ------------------ | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`Loaded`**       | <code>'onRewardedInterstitialAdLoaded'</code>       | Emits when a rewarded interstitial ad has loaded and is ready to show.                                                                                                          |
+| **`FailedToLoad`** | <code>'onRewardedInterstitialAdFailedToLoad'</code> | Emits when a rewarded interstitial ad fails to load.                                                                                                                            |
+| **`Showed`**       | <code>'onRewardedInterstitialAdShowed'</code>       | Emits when a rewarded interstitial ad is shown.                                                                                                                                 |
+| **`FailedToShow`** | <code>'onRewardedInterstitialAdFailedToShow'</code> | Emits when a loaded rewarded interstitial ad fails to show.                                                                                                                     |
+| **`Dismissed`**    | <code>'onRewardedInterstitialAdDismissed'</code>    | Emits when a rewarded interstitial ad is dismissed. This event does not indicate whether the user earned a reward. Listen for `Rewarded` separately before granting the reward. |
+| **`Rewarded`**     | <code>'onRewardedInterstitialAdReward'</code>       | Emits when the user earns the advertised reward.                                                                                                                                |
+| **`AdImpression`** | <code>'onRewardedInterstitialAdImpression'</code>   | Emits impression-level ad revenue data when a paid event is recorded.                                                                                                           |
 
 </docgen-api>