@capgo/capacitor-admob 8.1.20 → 8.2.0

package/CapgoCapacitorAdmob.podspec

@@ -14,5 +14,6 @@ Pod::Spec.new do |s|
   s.ios.deployment_target = '15.0'
   s.dependency 'Capacitor'
   s.dependency 'Google-Mobile-Ads-SDK', '~> 13.1'
+  s.dependency 'GoogleUserMessagingPlatform', '~> 3.1'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -11,7 +11,8 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
-        .package(url: "https://github.com/googleads/swift-package-manager-google-mobile-ads.git", from: "13.11.0")
+        .package(url: "https://github.com/googleads/swift-package-manager-google-mobile-ads.git", from: "13.11.0"),
+        .package(url: "https://github.com/googleads/swift-package-manager-google-user-messaging-platform.git", from: "3.1.0")
     ],
     targets: [
         .target(
@@ -19,7 +20,8 @@ let package = Package(
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm"),
-                .product(name: "GoogleMobileAds", package: "swift-package-manager-google-mobile-ads")
+                .product(name: "GoogleMobileAds", package: "swift-package-manager-google-mobile-ads"),
+                .product(name: "GoogleUserMessagingPlatform", package: "swift-package-manager-google-user-messaging-platform")
             ],
             path: "ios/Sources/AdmobPlusPlugin"),
         .testTarget(

package/README.md

@@ -1,10 +1,29 @@
 # @capgo/capacitor-admob
-<a href="https://capgo.app/"><img src="https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-admob" alt="Capgo - Instant updates for Capacitor" /></a>
+
+Show Google AdMob ads in your Capacitor app on iOS and Android: banner, interstitial, rewarded and rewarded interstitial formats from one TypeScript API. Monetize your app with the official Google Mobile Ads SDKs underneath.
+
+<a href="https://capgo.app/?ref=plugin_admob"><img src="https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-admob" alt="Capgo - Instant updates for Capacitor" /></a>
 
 <div align="center">
-  <h2><a href="https://capgo.app/?ref=plugin_admob"> ➡️ Get Instant updates for your App with Capgo</a></h2>
-  <h2><a href="https://capgo.app/consulting/?ref=plugin_admob"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+  <p><b>Capgo</b>: push fixes to your Capacitor users in minutes, build signed iOS and Android apps without a Mac, and roll back in one click.</p>
+  <h2><a href="https://capgo.app/register/?ref=plugin_admob">➡️ Get started for free</a></h2>
+  <p>14-day unlimited free trial. No credit card required</p>
+  <p><a href="https://capgo.app/consulting/?ref=plugin_admob">Missing a feature? We'll build the plugin for you 💪</a></p>
 </div>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Cap-go/capacitor-admob/main/assets/github-social-preview.png" alt="@capgo/capacitor-admob for Capacitor apps" width="300" />
+</p>
+
+## Key features
+
+- **Four ad formats**: `BannerAd`, `InterstitialAd`, `RewardedAd` and `RewardedInterstitialAd` classes with load and show, plus `hide()` on `BannerAd`.
+- **Ad lifecycle**: `adCreate()`, `adLoad()`, `adIsLoaded()`, `adShow()` and `adHide()` give you full control over each ad instance.
+- **SDK setup**: `start()` initializes AdMob, `configure()` sets app-wide options and `configRequest()` sets request options.
+- **App Tracking Transparency**: `trackingAuthorizationStatus()` and `requestTrackingAuthorization()` handle the iOS tracking prompt.
+- **Current SDKs**: Google Mobile Ads Next Gen SDK on Android and Google Mobile Ads SDK on iOS.
+- **Platforms**: iOS and Android. The web implementation is a no-op stub.
+
 AdMob SDK bridge for Capacitor apps
 
 Android now uses the Google Mobile Ads Next Gen SDK, and iOS is aligned to Google Mobile Ads SDK `13.1.x`, while preserving the existing Capacitor-facing API.
@@ -45,6 +64,29 @@ npm install @capgo/capacitor-admob
 npx cap sync
 ```
 
+## Consent (UMP)
+
+For apps serving users in the EEA/UK, request consent with Google's User Messaging Platform (UMP) before loading ads. Configure GDPR messages in your AdMob account first.
+
+```typescript
+import { AdMob, AdmobConsentStatus } from '@capgo/capacitor-admob';
+
+await AdMob.start();
+
+let consentInfo = await AdMob.requestConsentInfo();
+if (consentInfo.isConsentFormAvailable && consentInfo.status === AdmobConsentStatus.REQUIRED) {
+  consentInfo = await AdMob.showConsentForm();
+}
+
+if (consentInfo.canRequestAds) {
+  // Load ads only after consent allows ad requests.
+}
+```
+
+To let users manage privacy choices later, call `showPrivacyOptionsForm()` from a settings screen when `privacyOptionsRequirementStatus` is `REQUIRED`.
+
+For local testing on a real device, pass `debugGeography` and `testDeviceIdentifiers` to `requestConsentInfo()`.
+
 ## API
 
 <docgen-index>
@@ -52,14 +94,23 @@ npx cap sync
 * [`start()`](#start)
 * [`configure(...)`](#configure)
 * [`configRequest(...)`](#configrequest)
+* [`requestConsentInfo(...)`](#requestconsentinfo)
+* [`showConsentForm()`](#showconsentform)
+* [`showPrivacyOptionsForm()`](#showprivacyoptionsform)
 * [`adCreate(...)`](#adcreate)
 * [`adIsLoaded(...)`](#adisloaded)
 * [`adLoad(...)`](#adload)
 * [`adShow(...)`](#adshow)
 * [`adHide(...)`](#adhide)
+* [`feedAdCreate(...)`](#feedadcreate)
+* [`feedAdDestroy(...)`](#feedaddestroy)
+* [`feedAdLoad(...)`](#feedadload)
+* [`feedAdIsLoaded(...)`](#feedadisloaded)
+* [`feedAdUpdateBounds(...)`](#feedadupdatebounds)
+* [`feedAdSetAutoRefresh(...)`](#feedadsetautorefresh)
 * [`trackingAuthorizationStatus()`](#trackingauthorizationstatus)
 * [`requestTrackingAuthorization()`](#requesttrackingauthorization)
-* [`addListener(string, ...)`](#addlistenerstring-)
+* [`addListener(E, ...)`](#addlistenere-)
 * [`getPluginVersion()`](#getpluginversion)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -119,6 +170,57 @@ Configure ad request settings.
 --------------------
 
 
+### requestConsentInfo(...)
+
+```typescript
+requestConsentInfo(options?: AdmobConsentRequestOptions | undefined) => Promise<AdmobConsentInfo>
+```
+
+Request user consent information from Google's User Messaging Platform (UMP).
+
+Call this after `start()` and before loading ads for users in the EEA/UK.
+
+| Param         | Type                                                                              | Description                                                  |
+| ------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| **`options`** | <code><a href="#admobconsentrequestoptions">AdmobConsentRequestOptions</a></code> | - Optional consent request options for debugging and tagging |
+
+**Returns:** <code>Promise&lt;<a href="#admobconsentinfo">AdmobConsentInfo</a>&gt;</code>
+
+**Since:** 8.2.0
+
+--------------------
+
+
+### showConsentForm()
+
+```typescript
+showConsentForm() => Promise<AdmobConsentInfo>
+```
+
+Shows the Google user consent form rendered from your GDPR message configuration.
+
+**Returns:** <code>Promise&lt;<a href="#admobconsentinfo">AdmobConsentInfo</a>&gt;</code>
+
+**Since:** 8.2.0
+
+--------------------
+
+
+### showPrivacyOptionsForm()
+
+```typescript
+showPrivacyOptionsForm() => Promise<void>
+```
+
+Shows the Google privacy options form rendered from your GDPR message configuration.
+
+Use this when your privacy message requires an in-app entry point for users to manage choices.
+
+**Since:** 8.2.0
+
+--------------------
+
+
 ### adCreate(...)
 
 ```typescript
@@ -206,6 +308,112 @@ Hide a currently displayed ad.
 --------------------
 
 
+### feedAdCreate(...)
+
+```typescript
+feedAdCreate(opts: FeedAdCreateOptions) => Promise<{ id: number; }>
+```
+
+Create an in-feed ad slot (native overlay or inline banner overlay).
+
+| Param      | Type                                                                | Description             |
+| ---------- | ------------------------------------------------------------------- | ----------------------- |
+| **`opts`** | <code><a href="#feedadcreateoptions">FeedAdCreateOptions</a></code> | - Feed ad configuration |
+
+**Returns:** <code>Promise&lt;{ id: number; }&gt;</code>
+
+**Since:** 8.3.0
+
+--------------------
+
+
+### feedAdDestroy(...)
+
+```typescript
+feedAdDestroy(opts: { id: number; }) => Promise<void>
+```
+
+Destroy a feed ad instance and remove its native overlay.
+
+| Param      | Type                         | Description                        |
+| ---------- | ---------------------------- | ---------------------------------- |
+| **`opts`** | <code>{ id: number; }</code> | - Object containing the feed ad id |
+
+**Since:** 8.3.0
+
+--------------------
+
+
+### feedAdLoad(...)
+
+```typescript
+feedAdLoad(opts: { id: number; }) => Promise<void>
+```
+
+Load or reload the feed ad. Listen for `feed.load` / `feed.loadfail` events.
+
+| Param      | Type                         | Description                        |
+| ---------- | ---------------------------- | ---------------------------------- |
+| **`opts`** | <code>{ id: number; }</code> | - Object containing the feed ad id |
+
+**Since:** 8.3.0
+
+--------------------
+
+
+### feedAdIsLoaded(...)
+
+```typescript
+feedAdIsLoaded(opts: { id: number; }) => Promise<boolean>
+```
+
+Whether the feed ad has finished loading.
+
+| Param      | Type                         | Description                        |
+| ---------- | ---------------------------- | ---------------------------------- |
+| **`opts`** | <code>{ id: number; }</code> | - Object containing the feed ad id |
+
+**Returns:** <code>Promise&lt;boolean&gt;</code>
+
+**Since:** 8.3.0
+
+--------------------
+
+
+### feedAdUpdateBounds(...)
+
+```typescript
+feedAdUpdateBounds(opts: FeedAdBounds & { id: number; }) => Promise<void>
+```
+
+Position the native overlay over an HTML placeholder. Call on scroll, resize, and orientation changes.
+
+| Param      | Type                                                                    | Description                                                    |
+| ---------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- |
+| **`opts`** | <code><a href="#feedadbounds">FeedAdBounds</a> & { id: number; }</code> | - Feed ad id and bounds from `element.getBoundingClientRect()` |
+
+**Since:** 8.3.0
+
+--------------------
+
+
+### feedAdSetAutoRefresh(...)
+
+```typescript
+feedAdSetAutoRefresh(opts: { id: number; autoRefreshMs: number | null; }) => Promise<void>
+```
+
+Enable or disable auto-refresh (minimum 30 seconds).
+
+| Param      | Type                                                        | Description                                           |
+| ---------- | ----------------------------------------------------------- | ----------------------------------------------------- |
+| **`opts`** | <code>{ id: number; autoRefreshMs: number \| null; }</code> | - Feed ad id and interval in ms, or `null` to disable |
+
+**Since:** 8.3.0
+
+--------------------
+
+
 ### trackingAuthorizationStatus()
 
 ```typescript
@@ -236,18 +444,18 @@ Request tracking authorization from the user (iOS only).
 --------------------
 
 
-### addListener(string, ...)
+### addListener(E, ...)
 
 ```typescript
-addListener(eventName: string, listenerFunc: (event: any) => void) => Promise<PluginListenerHandle> & PluginListenerHandle
+addListener<E extends AdMobPlusEventName>(eventName: E, listenerFunc: (event: AdMobPlusEventPayloadMap[E]) => void) => Promise<PluginListenerHandle> & PluginListenerHandle
 ```
 
 Add a listener for ad events.
 
-| Param              | Type                                 | Description                                  |
-| ------------------ | ------------------------------------ | -------------------------------------------- |
-| **`eventName`**    | <code>string</code>                  | - The name of the event to listen for        |
-| **`listenerFunc`** | <code>(event: any) =&gt; void</code> | - The function to call when the event occurs |
+| Param              | Type                                                         | Description                                  |
+| ------------------ | ------------------------------------------------------------ | -------------------------------------------- |
+| **`eventName`**    | <code>E</code>                                               | - The name of the event to listen for        |
+| **`listenerFunc`** | <code>(event: AdMobPlusEventPayloadMap[E]) =&gt; void</code> | - The function to call when the event occurs |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt; & <a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
@@ -298,6 +506,20 @@ Configuration for ad requests.
 <code>{ /** Maximum ad content rating */ maxAdContentRating?: <a href="#maxadcontentrating">MaxAdContentRating</a>; /** Whether to use the same app key */ sameAppKey?: boolean; /** Tag for child-directed treatment (true, false, or null for unspecified) */ tagForChildDirectedTreatment?: boolean | null; /** Tag for under age of consent (true, false, or null for unspecified) */ tagForUnderAgeOfConsent?: boolean | null; /** Array of test device IDs */ testDeviceIds?: string[]; }</code>
 
 
+#### AdmobConsentInfo
+
+Consent information returned by UMP.
+
+<code>{ /** The consent status of the user. */ status: <a href="#admobconsentstatus">AdmobConsentStatus</a>; /** If true, a consent form is available. */ isConsentFormAvailable?: boolean; /** If true, an ad request can be made. */ canRequestAds: boolean; /** Privacy options requirement status of the user. */ privacyOptionsRequirementStatus: <a href="#privacyoptionsrequirementstatus">PrivacyOptionsRequirementStatus</a>; }</code>
+
+
+#### AdmobConsentRequestOptions
+
+Options for requesting UMP consent information.
+
+<code>{ /** Sets the debug geography to test consent locally. */ debugGeography?: <a href="#admobconsentdebuggeography">AdmobConsentDebugGeography</a>; /** * Test device IDs to allow for consent debugging. * On iOS, the ID may change if you uninstall and reinstall the app. */ testDeviceIdentifiers?: string[]; /** * When true, tags the user as under the age of consent for UMP requests. * * @default false */ tagForUnderAgeOfConsent?: boolean; }</code>
+
+
 #### MobileAdOptions
 
 Base options for mobile ads.
@@ -305,6 +527,92 @@ Base options for mobile ads.
 <code>{ /** The ad unit ID from AdMob */ adUnitId: string; }</code>
 
 
+#### FeedAdCreateOptions
+
+Options for creating an in-feed ad instance.
+
+Policy: AdMob counts native impressions and clicks only when assets render inside
+{@link https://developers.google.com/admob/android/native/advanced | NativeAdView} /
+GADNativeAdView with the AdChoices icon and an ad attribution badge. This plugin
+overlays a compliant native view on your placeholder. Optional {@link FeedNativeAdAssets}
+are returned on `feed.load` for layout sizing only, not for manual click forwarding.
+
+<code>{ /** Native advanced or inline banner. */ format: <a href="#feedadformat">FeedAdFormat</a>; /** AdMob ad unit ID. */ adUnitId: string; /** Optional key echoed on feed events for your feed slot. */ positionKey?: string; /** * Auto-refresh interval in milliseconds. AdMob requires at least 30 seconds. * Omit or pass `null` to disable auto-refresh. */ autoRefreshMs?: number | null; /** Template colors when `format` is `native`. */ nativeStyle?: <a href="#feednativeadstyle">FeedNativeAdStyle</a>; }</code>
+
+
+#### FeedAdFormat
+
+In-feed ad format. Both use a native overlay aligned to an HTML placeholder.
+
+<code>'native' | 'banner'</code>
+
+
+#### FeedNativeAdStyle
+
+Optional colors for the built-in native ad template (hex strings, e.g. `#ffffff`).
+
+<code>{ backgroundColor?: string; headlineTextColor?: string; bodyTextColor?: string; ctaBackgroundColor?: string; ctaTextColor?: string; }</code>
+
+
+#### FeedAdBounds
+
+Bounds of the HTML placeholder, in CSS pixels relative to the WebView viewport.
+
+<code>{ x: number; y: number; width: number; height: number; /** When false, the native overlay is hidden (e.g. off-screen while scrolling). */ visible: boolean; /** `window.devicePixelRatio` from the WebView. Defaults to 1 on web. */ density?: number; }</code>
+
+
+#### AdMobPlusEventName
+
+<code>(typeof AdMobPlusEvents)[keyof typeof AdMobPlusEvents]</code>
+
+
+#### AdMobPlusEventPayloadMap
+
+Maps each {@link <a href="#admobpluseventname">AdMobPlusEventName</a>} to the payload shape emitted from native code.
+
+<code>{ [AdMobPlusEvents.AdClick]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.AdDismiss]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.AdImpression]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.AdLoad]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.AdLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.AdReward]: <a href="#admobplusadrewardpayload">AdMobPlusAdRewardPayload</a>; [AdMobPlusEvents.AdShow]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.AdShowFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.BannerClick]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.BannerClose]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.BannerImpression]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.BannerLoad]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.BannerLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.BannerOpen]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.BannerSizeChange]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.InterstitialDismiss]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.InterstitialImpression]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.InterstitialLoad]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.InterstitialLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.InterstitialShow]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.InterstitialShowFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.RewardedDismiss]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedImpression]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedInterstitialDismiss]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedInterstitialImpression]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedInterstitialLoad]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedInterstitialLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.RewardedInterstitialReward]: <a href="#admobplusadrewardpayload">AdMobPlusAdRewardPayload</a>; [AdMobPlusEvents.RewardedInterstitialShow]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedInterstitialShowFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.RewardedLoad]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.RewardedReward]: <a href="#admobplusadrewardpayload">AdMobPlusAdRewardPayload</a>; [AdMobPlusEvents.RewardedShow]: <a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a>; [AdMobPlusEvents.RewardedShowFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a>; [AdMobPlusEvents.FeedClick]: <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; [AdMobPlusEvents.FeedClose]: <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; [AdMobPlusEvents.FeedImpression]: <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; [AdMobPlusEvents.FeedLoad]: <a href="#admobplusfeedloadpayload">AdMobPlusFeedLoadPayload</a>; [AdMobPlusEvents.FeedLoadFail]: <a href="#admobplusadfailurepayload">AdMobPlusAdFailurePayload</a> & <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; [AdMobPlusEvents.FeedOpen]: <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; [AdMobPlusEvents.FeedRefresh]: <a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a>; }</code>
+
+
+#### AdMobPlusAdIdPayload
+
+Event payload always includes the native ad instance id (`adId`). iOS also emits legacy `id`.
+
+<code>{ adId: number; id?: number; }</code>
+
+
+#### AdMobPlusAdFailurePayload
+
+Load and fullscreen show failure payloads from native `LoadAdError` / `FullScreenContentError`.
+
+<code><a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a> & { code: number; message: string; /** Legacy iOS failure field; same string as `message` when present. */ error?: string; }</code>
+
+
+#### AdMobPlusAdRewardPayload
+
+Reward callbacks include the earned reward plus `adId`.
+
+<code><a href="#admobplusadidpayload">AdMobPlusAdIdPayload</a> & { reward: { amount: number; type: string; }; }</code>
+
+
+#### AdMobPlusFeedAdIdPayload
+
+In-feed ad events use `feedAdId` (same numeric id as `feedAdCreate`).
+
+<code>{ feedAdId: number; positionKey?: string; format?: 'native' | 'banner'; }</code>
+
+
+#### AdMobPlusFeedLoadPayload
+
+<code><a href="#admobplusfeedadidpayload">AdMobPlusFeedAdIdPayload</a> & { assets?: <a href="#record">Record</a>&lt;string, unknown&gt;; }</code>
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
 ### Enums
 
 
@@ -319,6 +627,36 @@ Base options for mobile ads.
 | **`UNSPECIFIED`** | <code>''</code>   | Unspecified rating |
 
 
+#### AdmobConsentStatus
+
+| Members            | Value                       | Description                                                     |
+| ------------------ | --------------------------- | --------------------------------------------------------------- |
+| **`NOT_REQUIRED`** | <code>'NOT_REQUIRED'</code> | User consent not required.                                      |
+| **`OBTAINED`**     | <code>'OBTAINED'</code>     | User consent already obtained.                                  |
+| **`REQUIRED`**     | <code>'REQUIRED'</code>     | User consent required but not yet obtained.                     |
+| **`UNKNOWN`**      | <code>'UNKNOWN'</code>      | Unknown consent status. Call requestConsentInfo() to update it. |
+
+
+#### PrivacyOptionsRequirementStatus
+
+| Members            | Value                       | Description                                    |
+| ------------------ | --------------------------- | ---------------------------------------------- |
+| **`NOT_REQUIRED`** | <code>'NOT_REQUIRED'</code> | Privacy options entry point is not required.   |
+| **`REQUIRED`**     | <code>'REQUIRED'</code>     | Privacy options entry point is required.       |
+| **`UNKNOWN`**      | <code>'UNKNOWN'</code>      | Privacy options requirement status is unknown. |
+
+
+#### AdmobConsentDebugGeography
+
+| Members        | Value          | Description                                                     |
+| -------------- | -------------- | --------------------------------------------------------------- |
+| **`DISABLED`** | <code>0</code> | Debug geography disabled.                                       |
+| **`EEA`**      | <code>1</code> | Geography appears as in EEA for debug devices.                  |
+| **`NOT_EEA`**  | <code>2</code> | Geography appears as not in EEA for debug devices.              |
+| **`US`**       | <code>3</code> | Geography appears as in a regulated US state for debug devices. |
+| **`OTHER`**    | <code>4</code> | Geography appears as OTHER for debug devices.                   |
+
+
 #### TrackingAuthorizationStatus
 
 | Members             | Value          | Description                                                |

package/android/build.gradle

@@ -7,6 +7,7 @@ ext {
     androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
     // Next Gen is currently published as a beta artifact; apps can override this property when pinning a newer vetted release.
     googleMobileAdsNextGenVersion = project.hasProperty('googleMobileAdsNextGenVersion') ? rootProject.ext.googleMobileAdsNextGenVersion : '0.25.0-beta01'
+    userMessagingPlatformVersion = project.hasProperty('userMessagingPlatformVersion') ? rootProject.ext.userMessagingPlatformVersion : '4.0.0'
 }
 
 buildscript {
@@ -16,7 +17,7 @@ buildscript {
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:8.13.0'
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.3.21"
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.4.20"
     }
 }
 
@@ -64,9 +65,9 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
-    implementation 'androidx.core:core-ktx:1.9.0'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
     implementation "com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:$googleMobileAdsNextGenVersion"
+    implementation "com.google.android.ump:user-messaging-platform:$userMessagingPlatformVersion"
 }

package/android/src/main/kotlin/admob/plus/capacitor/AdMobPlusPlugin.kt

@@ -1,6 +1,7 @@
 package admob.plus.capacitor
 
 import admob.plus.capacitor.ads.Banner
+import admob.plus.capacitor.feed.FeedAdManager
 import admob.plus.capacitor.ads.Interstitial
 import admob.plus.capacitor.ads.Rewarded
 import admob.plus.capacitor.ads.RewardedInterstitial
@@ -23,6 +24,8 @@ import org.json.JSONObject
 class AdMobPlusPlugin : Plugin(), Helper.Adapter {
     private val pluginVersion = "8.0.15"
     private var helper: Helper? = null
+    private var consentHelper: ConsentHelper? = null
+    private var feedAdManager: FeedAdManager? = null
     @Volatile
     private var mobileAdsInitialized = false
     private var requestConfigurationOverride: RequestConfiguration? = null
@@ -30,6 +33,8 @@ class AdMobPlusPlugin : Plugin(), Helper.Adapter {
     override fun load() {
         super.load()
         helper = Helper(this)
+        consentHelper = ConsentHelper(this)
+        feedAdManager = FeedAdManager(this)
         ExecuteContext.plugin = this
     }
 
@@ -83,6 +88,23 @@ class AdMobPlusPlugin : Plugin(), Helper.Adapter {
         ctx.configure(helper!!)
     }
 
+    @PluginMethod
+    fun requestConsentInfo(call: PluginCall) {
+        bridge.executeOnMainThread {
+            consentHelper?.requestConsentInfo(call)
+        }
+    }
+
+    @PluginMethod
+    fun showConsentForm(call: PluginCall) {
+        consentHelper?.showConsentForm(call)
+    }
+
+    @PluginMethod
+    fun showPrivacyOptionsForm(call: PluginCall) {
+        consentHelper?.showPrivacyOptionsForm(call)
+    }
+
     @PluginMethod
     fun configRequest(call: PluginCall) {
         val ctx = ExecuteContext(call)
@@ -160,6 +182,105 @@ class AdMobPlusPlugin : Plugin(), Helper.Adapter {
         }
     }
 
+    @PluginMethod
+    fun feedAdCreate(call: PluginCall) {
+        val format = call.getString("format")
+        val adUnitId = call.getString("adUnitId")
+        if (format == null || adUnitId == null) {
+            call.reject("format and adUnitId are required")
+            return
+        }
+        val positionKey = call.getString("positionKey")
+        val autoRefreshMs = if (call.data.has("autoRefreshMs")) call.getInt("autoRefreshMs") else null
+        val nativeStyle = mutableMapOf<String, String>()
+        val styleObj = call.getObject("nativeStyle")
+        if (styleObj != null) {
+            val keys = styleObj.keys()
+            while (keys.hasNext()) {
+                val key = keys.next()
+                nativeStyle[key] = styleObj.optString(key)
+            }
+        }
+        bridge.executeOnMainThread {
+            val id = feedAdManager!!.create(format, adUnitId, positionKey, autoRefreshMs, nativeStyle)
+            val ret = JSObject()
+            ret.put("id", id)
+            call.resolve(ret)
+        }
+    }
+
+    @PluginMethod
+    fun feedAdDestroy(call: PluginCall) {
+        val id = call.getInt("id")
+        if (id == null) {
+            call.reject("id is required")
+            return
+        }
+        bridge.executeOnMainThread {
+            feedAdManager!!.destroy(id)
+            call.resolve()
+        }
+    }
+
+    @PluginMethod
+    fun feedAdLoad(call: PluginCall) {
+        val id = call.getInt("id")
+        if (id == null) {
+            call.reject("id is required")
+            return
+        }
+        if (rejectIfNotInitialized { call.reject(it) }) {
+            return
+        }
+        feedAdManager!!.load(id) { error ->
+            if (error != null) {
+                call.reject(error)
+            } else {
+                call.resolve()
+            }
+        }
+    }
+
+    @PluginMethod
+    fun feedAdIsLoaded(call: PluginCall) {
+        val id = call.getInt("id")
+        if (id == null) {
+            call.reject("id is required")
+            return
+        }
+        val ret = JSObject()
+        ret.put("value", feedAdManager!!.isLoaded(id))
+        call.resolve(ret)
+    }
+
+    @PluginMethod
+    fun feedAdUpdateBounds(call: PluginCall) {
+        val id = call.getInt("id")
+        if (id == null) {
+            call.reject("id is required")
+            return
+        }
+        val x = call.getDouble("x") ?: 0.0
+        val y = call.getDouble("y") ?: 0.0
+        val width = call.getDouble("width") ?: 0.0
+        val height = call.getDouble("height") ?: 0.0
+        val visible = call.getBoolean("visible") ?: false
+        feedAdManager!!.updateBounds(id, x, y, width, height, visible)
+        call.resolve()
+    }
+
+    @PluginMethod
+    fun feedAdSetAutoRefresh(call: PluginCall) {
+        val id = call.getInt("id")
+        if (id == null) {
+            call.reject("id is required")
+            return
+        }
+        val autoRefreshMs = if (call.data.has("autoRefreshMs")) call.getInt("autoRefreshMs") else null
+        feedAdManager!!.setAutoRefresh(id, autoRefreshMs)
+        call.resolve()
+    }
+
     @PluginMethod
     fun adHide(call: PluginCall) {
         val ctx = ExecuteContext(call)