@capacitor-community/admob 8.0.1 → 8.1.0

package/dist/esm/app-open/app-open-ad-options.interface.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Options for loading an App Open ad.
+ */
 export interface AppOpenAdOptions {
+    /**
+     * The App Open ad unit ID to load.
+     */
     adId: string;
 }

package/dist/esm/app-open/app-open-ad-plugin-events.enum.d.ts

@@ -1,7 +1,26 @@
 export declare enum AppOpenAdPluginEvents {
+    /**
+     * Emits when an App Open ad has loaded.
+     */
     Loaded = "appOpenAdLoaded",
+    /**
+     * Emits when an App Open ad fails to load.
+     */
     FailedToLoad = "appOpenAdFailedToLoad",
+    /**
+     * Emits when an App Open ad is shown.
+     */
     Opened = "appOpenAdOpened",
+    /**
+     * Emits when an App Open ad is dismissed.
+     */
     Closed = "appOpenAdClosed",
-    FailedToShow = "appOpenAdFailedToShow"
+    /**
+     * Emits when a loaded App Open ad fails to show.
+     */
+    FailedToShow = "appOpenAdFailedToShow",
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
+     */
+    AdImpression = "appOpenAdImpression"
 }

package/dist/esm/app-open/app-open-ad-plugin-events.enum.js

@@ -1,9 +1,28 @@
 export var AppOpenAdPluginEvents;
 (function (AppOpenAdPluginEvents) {
+    /**
+     * Emits when an App Open ad has loaded.
+     */
     AppOpenAdPluginEvents["Loaded"] = "appOpenAdLoaded";
+    /**
+     * Emits when an App Open ad fails to load.
+     */
     AppOpenAdPluginEvents["FailedToLoad"] = "appOpenAdFailedToLoad";
+    /**
+     * Emits when an App Open ad is shown.
+     */
     AppOpenAdPluginEvents["Opened"] = "appOpenAdOpened";
+    /**
+     * Emits when an App Open ad is dismissed.
+     */
     AppOpenAdPluginEvents["Closed"] = "appOpenAdClosed";
+    /**
+     * Emits when a loaded App Open ad fails to show.
+     */
     AppOpenAdPluginEvents["FailedToShow"] = "appOpenAdFailedToShow";
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
+     */
+    AppOpenAdPluginEvents["AdImpression"] = "appOpenAdImpression";
 })(AppOpenAdPluginEvents || (AppOpenAdPluginEvents = {}));
 //# sourceMappingURL=app-open-ad-plugin-events.enum.js.map

package/dist/esm/app-open/app-open-ad-plugin-events.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-open-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/app-open/app-open-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,mDAA0B,CAAA;IAC1B,+DAAsC,CAAA;IACtC,mDAA0B,CAAA;IAC1B,mDAA0B,CAAA;IAC1B,+DAAsC,CAAA;AACxC,CAAC,EANW,qBAAqB,KAArB,qBAAqB,QAMhC"}
+{"version":3,"file":"app-open-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/app-open/app-open-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,qBA8BX;AA9BD,WAAY,qBAAqB;IAC/B;;OAEG;IACH,mDAA0B,CAAA;IAE1B;;OAEG;IACH,+DAAsC,CAAA;IAEtC;;OAEG;IACH,mDAA0B,CAAA;IAE1B;;OAEG;IACH,mDAA0B,CAAA;IAE1B;;OAEG;IACH,+DAAsC,CAAA;IAEtC;;OAEG;IACH,6DAAoC,CAAA;AACtC,CAAC,EA9BW,qBAAqB,KAArB,qBAAqB,QA8BhC"}

package/dist/esm/app-open/app-open-definitions.interface.d.ts

@@ -1,27 +1,50 @@
 import type { PluginListenerHandle } from '@capacitor/core';
 import type { ValidateAllEventsEnumAreImplemented } from '../private/validate-all-events-implemented.type';
-import type { AdMobError } from '../shared';
+import type { AdLoadInfo, AdMobError, AdMobRevenueData, AdShowOptions } from '../shared';
 import type { AppOpenAdOptions } from './app-open-ad-options.interface';
 import type { AppOpenAdPluginEvents } from './app-open-ad-plugin-events.enum';
 export type AppOpenDefinitionsHasAllEvents = ValidateAllEventsEnumAreImplemented<AppOpenAdPluginEvents, AppOpenAdPlugin>;
 export interface AppOpenAdPlugin {
     /**
-     * Load an App Open ad
+     * Loads an App Open ad and returns the loaded ad unit ID.
      */
-    loadAppOpen(options: AppOpenAdOptions): Promise<void>;
+    loadAppOpen(options: AppOpenAdOptions): Promise<AdLoadInfo>;
     /**
-     * Shows the App Open ad if loaded
+     * Shows a loaded App Open ad.
+     *
+     * @param options Optional. Pass { adId } to show a specific prepared ad instead of the most recent one.
      */
-    showAppOpen(): Promise<void>;
+    showAppOpen(options?: AdShowOptions): Promise<void>;
     /**
-     * Check if the App Open ad is loaded
+     * Checks whether an App Open ad is loaded.
+     *
+     * @param options Optional. Pass an adId to check a specific prepared ad instead of the most recent one.
      */
-    isAppOpenLoaded(): Promise<{
+    isAppOpenLoaded(options?: AdShowOptions): Promise<{
         value: boolean;
     }>;
-    addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open ad load events.
+     */
+    addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open ad load failures.
+     */
     addListener(eventName: AppOpenAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open ad opened events.
+     */
     addListener(eventName: AppOpenAdPluginEvents.Opened, listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open ad closed events.
+     */
     addListener(eventName: AppOpenAdPluginEvents.Closed, listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open ad show failures.
+     */
     addListener(eventName: AppOpenAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for App Open impression-level ad revenue events.
+     */
+    addListener(eventName: AppOpenAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void): Promise<PluginListenerHandle>;
 }

package/dist/esm/banner/banner-ad-options.interface.d.ts

@@ -2,21 +2,20 @@ import type { AdOptions } from '../shared';
 import type { BannerAdPosition } from './banner-ad-position.enum';
 import type { BannerAdSize } from './banner-ad-size.enum';
 /**
- * This interface extends AdOptions
+ * Options for displaying a banner ad.
+ *
+ * This interface extends AdOptions.
  */
 export interface BannerAdOptions extends AdOptions {
     /**
-     * Banner Ad Size, defaults to ADAPTIVE_BANNER.
-     * IT can be: ADAPTIVE_BANNER, SMART_BANNER, BANNER,
-     * MEDIUM_RECTANGLE, FULL_BANNER, LEADERBOARD
+     * The banner size to display.
      *
      * @default ADAPTIVE_BANNER
      * @since 3.0.0
      */
     adSize?: BannerAdSize;
     /**
-     * Set Banner Ad position.
-     * TOP_CENTER or CENTER or BOTTOM_CENTER
+     * The position where the banner is displayed.
      *
      * @default TOP_CENTER
      * @since 1.1.2

package/dist/esm/banner/banner-ad-plugin-events.enum.d.ts

@@ -1,17 +1,30 @@
 export declare enum BannerAdPluginEvents {
+    /**
+     * Emits when the displayed banner size changes.
+     */
     SizeChanged = "bannerAdSizeChanged",
+    /**
+     * Emits when a banner ad has loaded.
+     */
     Loaded = "bannerAdLoaded",
+    /**
+     * Emits when a banner ad fails to load.
+     */
     FailedToLoad = "bannerAdFailedToLoad",
     /**
-     * Open "Adsense" Event after user click banner
+     * Emits when a banner opens an overlay after the user taps it.
      */
     Opened = "bannerAdOpened",
     /**
-     * Close "Adsense" Event after user click banner
+     * Emits when the banner overlay is closed.
      */
     Closed = "bannerAdClosed",
     /**
-     * Similarly, this method should be called when an impression is recorded for the ad by the mediated SDK.
+     * Emits when an impression is recorded for the banner ad.
+     */
+    AdImpression = "bannerAdImpression",
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
      */
-    AdImpression = "bannerAdImpression"
+    AdPaid = "bannerAdPaid"
 }

package/dist/esm/banner/banner-ad-plugin-events.enum.js

@@ -1,20 +1,33 @@
 // This enum should be keep in sync with their native equivalents with the same name
 export var BannerAdPluginEvents;
 (function (BannerAdPluginEvents) {
+    /**
+     * Emits when the displayed banner size changes.
+     */
     BannerAdPluginEvents["SizeChanged"] = "bannerAdSizeChanged";
+    /**
+     * Emits when a banner ad has loaded.
+     */
     BannerAdPluginEvents["Loaded"] = "bannerAdLoaded";
+    /**
+     * Emits when a banner ad fails to load.
+     */
     BannerAdPluginEvents["FailedToLoad"] = "bannerAdFailedToLoad";
     /**
-     * Open "Adsense" Event after user click banner
+     * Emits when a banner opens an overlay after the user taps it.
      */
     BannerAdPluginEvents["Opened"] = "bannerAdOpened";
     /**
-     * Close "Adsense" Event after user click banner
+     * Emits when the banner overlay is closed.
      */
     BannerAdPluginEvents["Closed"] = "bannerAdClosed";
     /**
-     * Similarly, this method should be called when an impression is recorded for the ad by the mediated SDK.
+     * Emits when an impression is recorded for the banner ad.
      */
     BannerAdPluginEvents["AdImpression"] = "bannerAdImpression";
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
+     */
+    BannerAdPluginEvents["AdPaid"] = "bannerAdPaid";
 })(BannerAdPluginEvents || (BannerAdPluginEvents = {}));
 //# sourceMappingURL=banner-ad-plugin-events.enum.js.map

package/dist/esm/banner/banner-ad-plugin-events.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"banner-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/banner/banner-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAN,IAAY,oBAmBX;AAnBD,WAAY,oBAAoB;IAC9B,2DAAmC,CAAA;IACnC,iDAAyB,CAAA;IACzB,6DAAqC,CAAA;IAErC;;OAEG;IACH,iDAAyB,CAAA;IAEzB;;OAEG;IACH,iDAAyB,CAAA;IAEzB;;OAEG;IACH,2DAAmC,CAAA;AACrC,CAAC,EAnBW,oBAAoB,KAApB,oBAAoB,QAmB/B"}
+{"version":3,"file":"banner-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/banner/banner-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAN,IAAY,oBAmCX;AAnCD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,2DAAmC,CAAA;IAEnC;;OAEG;IACH,iDAAyB,CAAA;IAEzB;;OAEG;IACH,6DAAqC,CAAA;IAErC;;OAEG;IACH,iDAAyB,CAAA;IAEzB;;OAEG;IACH,iDAAyB,CAAA;IAEzB;;OAEG;IACH,2DAAmC,CAAA;IAEnC;;OAEG;IACH,+CAAuB,CAAA;AACzB,CAAC,EAnCW,oBAAoB,KAApB,oBAAoB,QAmC/B"}

package/dist/esm/banner/banner-ad-position.enum.d.ts

@@ -3,15 +3,15 @@
  */
 export declare enum BannerAdPosition {
     /**
-     * Banner position be top-center
+     * Positions the banner at the top center of the screen.
      */
     TOP_CENTER = "TOP_CENTER",
     /**
-     * Banner position be center
+     * Positions the banner at the center of the screen.
      */
     CENTER = "CENTER",
     /**
-     * Banner position be bottom-center(default)
+     * Positions the banner at the bottom center of the screen.
      */
     BOTTOM_CENTER = "BOTTOM_CENTER"
 }

package/dist/esm/banner/banner-ad-position.enum.js

@@ -4,15 +4,15 @@
 export var BannerAdPosition;
 (function (BannerAdPosition) {
     /**
-     * Banner position be top-center
+     * Positions the banner at the top center of the screen.
      */
     BannerAdPosition["TOP_CENTER"] = "TOP_CENTER";
     /**
-     * Banner position be center
+     * Positions the banner at the center of the screen.
      */
     BannerAdPosition["CENTER"] = "CENTER";
     /**
-     * Banner position be bottom-center(default)
+     * Positions the banner at the bottom center of the screen.
      */
     BannerAdPosition["BOTTOM_CENTER"] = "BOTTOM_CENTER";
 })(BannerAdPosition || (BannerAdPosition = {}));

package/dist/esm/banner/banner-ad-size.enum.d.ts

@@ -34,9 +34,10 @@ export declare enum BannerAdSize {
      */
     ADAPTIVE_BANNER = "ADAPTIVE_BANNER",
     /**
-     * @deprecated
-     * Will be removed in next AdMob versions use `ADAPTIVE_BANNER`
-     * Screen width x 32|50|90
+     * A legacy smart banner sized to the screen width.
+     * Retained for compatibility; use `ADAPTIVE_BANNER` for new integrations.
+     *
+     * @deprecated Use `ADAPTIVE_BANNER` instead.
      */
     SMART_BANNER = "SMART_BANNER"
 }

package/dist/esm/banner/banner-ad-size.enum.js

@@ -35,9 +35,10 @@ export var BannerAdSize;
      */
     BannerAdSize["ADAPTIVE_BANNER"] = "ADAPTIVE_BANNER";
     /**
-     * @deprecated
-     * Will be removed in next AdMob versions use `ADAPTIVE_BANNER`
-     * Screen width x 32|50|90
+     * A legacy smart banner sized to the screen width.
+     * Retained for compatibility; use `ADAPTIVE_BANNER` for new integrations.
+     *
+     * @deprecated Use `ADAPTIVE_BANNER` instead.
      */
     BannerAdSize["SMART_BANNER"] = "SMART_BANNER";
 })(BannerAdSize || (BannerAdSize = {}));

package/dist/esm/banner/banner-ad-size.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"banner-ad-size.enum.js","sourceRoot":"","sources":["../../../src/banner/banner-ad-size.enum.ts"],"names":[],"mappings":"AAAA;;;;;KAKK;AACJ,MAAM,CAAN,IAAY,YA0CZ;AA1CA,WAAY,YAAY;IACvB;;;OAGG;IACH,iCAAiB,CAAA;IAEjB;;;OAGG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACH,6CAA6B,CAAA;IAE7B;;;OAGG;IACF,qDAAqC,CAAA;IAEtC;;;OAGG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACF,mDAAmC,CAAA;IAEnC;;;;OAIG;IACH,6CAA6B,CAAA;AAEhC,CAAC,EA1CY,YAAY,KAAZ,YAAY,QA0CxB"}
+{"version":3,"file":"banner-ad-size.enum.js","sourceRoot":"","sources":["../../../src/banner/banner-ad-size.enum.ts"],"names":[],"mappings":"AAAA;;;;;KAKK;AACJ,MAAM,CAAN,IAAY,YA2CZ;AA3CA,WAAY,YAAY;IACvB;;;OAGG;IACH,iCAAiB,CAAA;IAEjB;;;OAGG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACH,6CAA6B,CAAA;IAE7B;;;OAGG;IACF,qDAAqC,CAAA;IAEtC;;;OAGG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACF,mDAAmC,CAAA;IAEnC;;;;;OAKG;IACH,6CAA6B,CAAA;AAEhC,CAAC,EA3CY,YAAY,KAAZ,YAAY,QA2CxB"}

package/dist/esm/banner/banner-definitions.interface.d.ts

@@ -1,13 +1,13 @@
 import type { PluginListenerHandle } from '@capacitor/core';
 import type { ValidateAllEventsEnumAreImplemented } from '../private/validate-all-events-implemented.type';
-import type { AdMobError } from '../shared';
+import type { AdMobError, AdMobRevenueData } from '../shared';
 import type { BannerAdOptions } from './banner-ad-options.interface';
 import type { BannerAdPluginEvents } from './banner-ad-plugin-events.enum';
 import type { AdMobBannerSize } from './banner-size.interface';
 export type BannerDefinitionsHasAllEvents = ValidateAllEventsEnumAreImplemented<BannerAdPluginEvents, BannerDefinitions>;
 export interface BannerDefinitions {
     /**
-     * Show a banner Ad
+     * Displays a banner ad.
      *
      * @group Banner
      * @param options AdOptions
@@ -15,27 +15,28 @@ export interface BannerDefinitions {
      */
     showBanner(options: BannerAdOptions): Promise<void>;
     /**
-     * Hide the banner, remove it from screen, but can show it later
+     * Hides the current banner without destroying it.
      *
      * @group Banner
      * @since 1.1.2
      */
     hideBanner(): Promise<void>;
     /**
-     * Resume the banner, show it after hide
+     * Shows a previously hidden banner.
      *
      * @group Banner
      * @since 1.1.2
      */
     resumeBanner(): Promise<void>;
     /**
-     * Destroy the banner, remove it from screen.
+     * Destroys the current banner and removes it from the screen.
      *
      * @group Banner
      * @since 1.1.2
      */
     removeBanner(): Promise<void>;
     /**
+     * Listens for changes to the displayed banner dimensions.
      *
      * @group Banner
      * @param eventName bannerAdSizeChanged
@@ -44,7 +45,7 @@ export interface BannerDefinitions {
      */
     addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: AdMobBannerSize) => void): Promise<PluginListenerHandle>;
     /**
-     * Notice: request loaded Banner ad
+     * Listens for banner ad load events.
      *
      * @group Banner
      * @param eventName bannerAdLoaded
@@ -53,7 +54,7 @@ export interface BannerDefinitions {
      */
     addListener(eventName: BannerAdPluginEvents.Loaded, listenerFunc: () => void): Promise<PluginListenerHandle>;
     /**
-     * Notice: request failed Banner ad
+     * Listens for banner ad load failures.
      *
      * @group Banner
      * @param eventName bannerAdFailedToLoad
@@ -62,7 +63,7 @@ export interface BannerDefinitions {
      */
     addListener(eventName: BannerAdPluginEvents.FailedToLoad, listenerFunc: (info: AdMobError) => 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.
      *
      * @group Banner
      * @param eventName bannerAdOpened
@@ -71,7 +72,7 @@ export interface BannerDefinitions {
      */
     addListener(eventName: BannerAdPluginEvents.Opened, listenerFunc: () => void): Promise<PluginListenerHandle>;
     /**
-     * Notice: The full-screen banner view will been dismissed.
+     * Listens for banner overlay closed events.
      *
      * @group Banner
      * @param eventName bannerAdClosed
@@ -80,7 +81,7 @@ export interface BannerDefinitions {
      */
     addListener(eventName: BannerAdPluginEvents.Closed, listenerFunc: () => void): Promise<PluginListenerHandle>;
     /**
-     * Unimplemented
+     * Listens for banner impression events.
      *
      * @group Banner
      * @param eventName AdImpression
@@ -88,4 +89,10 @@ export interface BannerDefinitions {
      * @since 3.0.0
      */
     addListener(eventName: BannerAdPluginEvents.AdImpression, listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for banner impression-level ad revenue events.
+     *
+     * @group Banner
+     */
+    addListener(eventName: BannerAdPluginEvents.AdPaid, listenerFunc: (data: AdMobRevenueData) => void): Promise<PluginListenerHandle>;
 }

package/dist/esm/banner/banner-size.interface.d.ts

@@ -1,7 +1,14 @@
 /**
- * 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`.
  */
 export interface AdMobBannerSize {
+    /**
+     * The displayed banner width.
+     */
     width: number;
+    /**
+     * The displayed banner height.
+     */
     height: number;
 }

package/dist/esm/definitions.d.ts

@@ -8,54 +8,55 @@ import type { TrackingAuthorizationStatusInterface } from './shared/tracking-aut
 type AdMobDefinitions = BannerDefinitions & RewardDefinitions & RewardInterstitialDefinitions & InterstitialDefinitions & AdmobConsentDefinitions & AppOpenAdPlugin;
 export interface AdMobPlugin extends AdMobDefinitions {
     /**
-     * Initialize AdMob with AdMobInitializationOptions
+     * Initializes the Google Mobile Ads SDK.
      *
      * @group Initialize
-     * @param options AdMobInitializationOptions
+     * @param options Optional SDK initialization settings.
      * @since 1.1.2
      */
     initialize(options?: AdMobInitializationOptions): Promise<void>;
     /**
-     * Confirm requestTrackingAuthorization status (iOS >14)
+     * Returns the current App Tracking Transparency authorization status on iOS 14 and later.
+     * Returns `authorized` on earlier iOS versions, Android, and web.
      *
      * @see https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547038-trackingauthorizationstatus
      * @since 3.1.0
      */
     trackingAuthorizationStatus(): Promise<TrackingAuthorizationStatusInterface>;
     /**
-     * request requestTrackingAuthorization (iOS >14).
+     * Requests App Tracking Transparency authorization on iOS 14 and later.
+     * Resolves without taking action on earlier iOS versions, Android, and web.
      *
-     * @see https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547038-trackingauthorizationstatus
+     * @see https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547038-requesttrackingauthorization
      * @since 5.2.0
      */
     requestTrackingAuthorization(): Promise<void>;
     /**
-     * Report application mute state to AdMob SDK
+     * Reports whether the application audio is muted to the Google Mobile Ads SDK.
      *
-     * @see https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547038-trackingauthorizationstatus
+     * @see https://developers.google.com/admob/android/global-settings
      * @since 4.1.1
      */
     setApplicationMuted(options: ApplicationMutedOptions): Promise<void>;
     /**
-     * Report application volume to AdMob SDK
+     * Reports the application audio volume to the Google Mobile Ads SDK.
      *
-     * @see https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547038-trackingauthorizationstatus
+     * @see https://developers.google.com/admob/android/global-settings
      * @since 4.1.1
      */
     setApplicationVolume(options: ApplicationVolumeOptions): Promise<void>;
 }
 export interface AdMobInitializationOptions {
     /**
-     * An Array of devices IDs that will be marked as tested devices if {@link AdMobInitializationOptions.initializeForTesting} is true
-     * (Real Ads will be served to Testing devices, but they will not count as 'real').
+     * Device IDs to register as test devices when {@link AdMobInitializationOptions.initializeForTesting} is `true`.
+     * Requests from registered devices receive test ads and do not generate invalid traffic.
      *
      * @see https://developers.google.com/admob/android/test-ads#enable_test_devices
      * @since 1.2.0
      */
     testingDevices?: string[];
     /**
-     * If set to true, the devices on {@link AdMobInitializationOptions.testingDevices} will
-     * be registered to receive test production ads.
+     * Whether to register {@link AdMobInitializationOptions.testingDevices} as test devices.
      *
      * @see AdMobInitializationOptions.testingDevices
      * @default false
@@ -79,8 +80,8 @@ export interface AdMobInitializationOptions {
      */
     tagForUnderAgeOfConsent?: boolean;
     /**
-     * As an app developer,
-     * you can indicate whether you want Google to treat your content as child-directed when you make an ad request.
+     * The maximum ad content rating applied to all ad requests.
+     * Ads with a higher rating are excluded.
      *
      * @see https://developers.google.com/admob/android/targeting#child-directed_setting
      * @since 3.1.0
@@ -120,7 +121,7 @@ export interface ApplicationVolumeOptions {
     /**
      * 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.
+     * Use a supported value from 0.0 (silent) to 1.0 (full volume).
      *
      * @see https://developers.google.com/admob/android/global-settings
      * @since 4.1.1

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA0GA,MAAM,CAAN,IAAY,kBAoBX;AApBD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,yCAAmB,CAAA;IAEnB;;OAEG;IACH,2DAAqC,CAAA;IAErC;;OAEG;IACH,mCAAa,CAAA;IAEb;;OAEG;IACH,uDAAiC,CAAA;AACnC,CAAC,EApBW,kBAAkB,KAAlB,kBAAkB,QAoB7B"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA2GA,MAAM,CAAN,IAAY,kBAoBX;AApBD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,yCAAmB,CAAA;IAEnB;;OAEG;IACH,2DAAqC,CAAA;IAErC;;OAEG;IACH,mCAAa,CAAA;IAEb;;OAEG;IACH,uDAAiC,CAAA;AACnC,CAAC,EApBW,kBAAkB,KAAlB,kBAAkB,QAoB7B"}

package/dist/esm/interstitial/interstitial-ad-plugin-events.enum.d.ts

@@ -1,22 +1,26 @@
 export declare enum InterstitialAdPluginEvents {
     /**
-     * Emits after trying to prepare and Interstitial, when it is loaded and ready to be show
+     * Emits when an interstitial ad has loaded and is ready to show.
      */
     Loaded = "interstitialAdLoaded",
     /**
-     * Emits after trying to prepare and Interstitial, when it could not be loaded
+     * Emits when an interstitial ad fails to load.
      */
     FailedToLoad = "interstitialAdFailedToLoad",
     /**
-     * Emits when the Interstitial ad is visible to the user
+     * Emits when an interstitial ad is shown.
      */
     Showed = "interstitialAdShowed",
     /**
-     * Emits when the Interstitial ad is failed to show
+     * Emits when a loaded interstitial ad fails to show.
      */
     FailedToShow = "interstitialAdFailedToShow",
     /**
-     * Emits when the Interstitial ad is not visible to the user anymore.
+     * Emits when an interstitial ad is dismissed.
      */
-    Dismissed = "interstitialAdDismissed"
+    Dismissed = "interstitialAdDismissed",
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
+     */
+    AdImpression = "interstitialAdImpression"
 }

package/dist/esm/interstitial/interstitial-ad-plugin-events.enum.js

@@ -2,24 +2,28 @@
 export var InterstitialAdPluginEvents;
 (function (InterstitialAdPluginEvents) {
     /**
-     * Emits after trying to prepare and Interstitial, when it is loaded and ready to be show
+     * Emits when an interstitial ad has loaded and is ready to show.
      */
     InterstitialAdPluginEvents["Loaded"] = "interstitialAdLoaded";
     /**
-     * Emits after trying to prepare and Interstitial, when it could not be loaded
+     * Emits when an interstitial ad fails to load.
      */
     InterstitialAdPluginEvents["FailedToLoad"] = "interstitialAdFailedToLoad";
     /**
-     * Emits when the Interstitial ad is visible to the user
+     * Emits when an interstitial ad is shown.
      */
     InterstitialAdPluginEvents["Showed"] = "interstitialAdShowed";
     /**
-     * Emits when the Interstitial ad is failed to show
+     * Emits when a loaded interstitial ad fails to show.
      */
     InterstitialAdPluginEvents["FailedToShow"] = "interstitialAdFailedToShow";
     /**
-     * Emits when the Interstitial ad is not visible to the user anymore.
+     * Emits when an interstitial ad is dismissed.
      */
     InterstitialAdPluginEvents["Dismissed"] = "interstitialAdDismissed";
+    /**
+     * Emits impression-level ad revenue data when a paid event is recorded.
+     */
+    InterstitialAdPluginEvents["AdImpression"] = "interstitialAdImpression";
 })(InterstitialAdPluginEvents || (InterstitialAdPluginEvents = {}));
 //# sourceMappingURL=interstitial-ad-plugin-events.enum.js.map

package/dist/esm/interstitial/interstitial-ad-plugin-events.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"interstitial-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/interstitial/interstitial-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAN,IAAY,0BAqBX;AArBD,WAAY,0BAA0B;IACpC;;OAEG;IACH,6DAA+B,CAAA;IAC/B;;OAEG;IACH,yEAA2C,CAAA;IAC3C;;OAEG;IACH,6DAA+B,CAAA;IAC/B;;OAEG;IACH,yEAA2C,CAAA;IAC3C;;OAEG;IACH,mEAAoC,CAAA;AACtC,CAAC,EArBW,0BAA0B,KAA1B,0BAA0B,QAqBrC"}
+{"version":3,"file":"interstitial-ad-plugin-events.enum.js","sourceRoot":"","sources":["../../../src/interstitial/interstitial-ad-plugin-events.enum.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAN,IAAY,0BAyBX;AAzBD,WAAY,0BAA0B;IACpC;;OAEG;IACH,6DAA+B,CAAA;IAC/B;;OAEG;IACH,yEAA2C,CAAA;IAC3C;;OAEG;IACH,6DAA+B,CAAA;IAC/B;;OAEG;IACH,yEAA2C,CAAA;IAC3C;;OAEG;IACH,mEAAoC,CAAA;IACpC;;OAEG;IACH,uEAAyC,CAAA;AAC3C,CAAC,EAzBW,0BAA0B,KAA1B,0BAA0B,QAyBrC"}