@ququplay/admob 8.0.9 → 8.1.0

package/README.md

@@ -355,6 +355,14 @@ AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
 * [`addListener(InterstitialAdPluginEvents.Dismissed, ...)`](#addlistenerinterstitialadplugineventsdismissed-)
 * [`addListener(InterstitialAdPluginEvents.FailedToShow, ...)`](#addlistenerinterstitialadplugineventsfailedtoshow-)
 * [`addListener(InterstitialAdPluginEvents.Showed, ...)`](#addlistenerinterstitialadplugineventsshowed-)
+* [`showNativeAd(...)`](#shownativead)
+* [`hideNativeAd()`](#hidenativead)
+* [`removeNativeAd()`](#removenativead)
+* [`addListener(NativeAdPluginEvents.SizeChanged, ...)`](#addlistenernativeadplugineventssizechanged-)
+* [`addListener(NativeAdPluginEvents.Loaded, ...)`](#addlistenernativeadplugineventsloaded-)
+* [`addListener(NativeAdPluginEvents.FailedToLoad, ...)`](#addlistenernativeadplugineventsfailedtoload-)
+* [`addListener(NativeAdPluginEvents.Clicked, ...)`](#addlistenernativeadplugineventsclicked-)
+* [`addListener(NativeAdPluginEvents.AdImpression, ...)`](#addlistenernativeadplugineventsadimpression-)
 * [`prepareRewardVideoAd(...)`](#preparerewardvideoad)
 * [`showRewardVideoAd()`](#showrewardvideoad)
 * [`addListener(RewardAdPluginEvents.FailedToLoad, ...)`](#addlistenerrewardadplugineventsfailedtoload-)
@@ -807,6 +815,141 @@ addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => vo
 --------------------
 
 
+### showNativeAd(...)
+
+```typescript
+showNativeAd(options: NativeAdOptions) => Promise<void>
+```
+
+Show a native ad as a strip across the top of the screen.
+Shows the ad loaded before when there is one and it has not expired, otherwise loads a new one.
+Android and iOS; resolves without showing anything on the web.
+
+| Param         | Type                                                        | Description                                    |
+| ------------- | ----------------------------------------------------------- | ---------------------------------------------- |
+| **`options`** | <code><a href="#nativeadoptions">NativeAdOptions</a></code> | <a href="#nativeadoptions">NativeAdOptions</a> |
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### hideNativeAd()
+
+```typescript
+hideNativeAd() => Promise<void>
+```
+
+Hide the native ad but keep it, so showNativeAd brings back the same ad.
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### removeNativeAd()
+
+```typescript
+removeNativeAd() => Promise<void>
+```
+
+Destroy the native ad, remove it from screen.
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### addListener(NativeAdPluginEvents.SizeChanged, ...)
+
+```typescript
+addListener(eventName: NativeAdPluginEvents.SizeChanged, listenerFunc: (info: AdMobBannerSize) => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                              | Description         |
+| ------------------ | --------------------------------------------------------------------------------- | ------------------- |
+| **`eventName`**    | <code><a href="#nativeadpluginevents">NativeAdPluginEvents.SizeChanged</a></code> | nativeAdSizeChanged |
+| **`listenerFunc`** | <code>(info: <a href="#admobbannersize">AdMobBannerSize</a>) =&gt; void</code>    |                     |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### addListener(NativeAdPluginEvents.Loaded, ...)
+
+```typescript
+addListener(eventName: NativeAdPluginEvents.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                         | Description    |
+| ------------------ | ---------------------------------------------------------------------------- | -------------- |
+| **`eventName`**    | <code><a href="#nativeadpluginevents">NativeAdPluginEvents.Loaded</a></code> | nativeAdLoaded |
+| **`listenerFunc`** | <code>() =&gt; void</code>                                                   |                |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### addListener(NativeAdPluginEvents.FailedToLoad, ...)
+
+```typescript
+addListener(eventName: NativeAdPluginEvents.FailedToLoad, listenerFunc: (info: AdMobError) => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                               | Description          |
+| ------------------ | ---------------------------------------------------------------------------------- | -------------------- |
+| **`eventName`**    | <code><a href="#nativeadpluginevents">NativeAdPluginEvents.FailedToLoad</a></code> | nativeAdFailedToLoad |
+| **`listenerFunc`** | <code>(info: <a href="#admoberror">AdMobError</a>) =&gt; void</code>               |                      |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### addListener(NativeAdPluginEvents.Clicked, ...)
+
+```typescript
+addListener(eventName: NativeAdPluginEvents.Clicked, listenerFunc: () => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                          | Description     |
+| ------------------ | ----------------------------------------------------------------------------- | --------------- |
+| **`eventName`**    | <code><a href="#nativeadpluginevents">NativeAdPluginEvents.Clicked</a></code> | nativeAdClicked |
+| **`listenerFunc`** | <code>() =&gt; void</code>                                                    |                 |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### addListener(NativeAdPluginEvents.AdImpression, ...)
+
+```typescript
+addListener(eventName: NativeAdPluginEvents.AdImpression, listenerFunc: () => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                               | Description        |
+| ------------------ | ---------------------------------------------------------------------------------- | ------------------ |
+| **`eventName`**    | <code><a href="#nativeadpluginevents">NativeAdPluginEvents.AdImpression</a></code> | nativeAdImpression |
+| **`listenerFunc`** | <code>() =&gt; void</code>                                                         |                    |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
 ### prepareRewardVideoAd(...)
 
 ```typescript
@@ -1182,6 +1325,30 @@ https://developers.google.com/android/reference/com/google/android/gms/ads/AdErr
 | **`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 |
 
 
+#### NativeAdOptions
+
+| Prop                | Type                                                    | Description                                                                                                                                                                                                                                                                                                          | Default            | Since |
+| ------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`style`**         | <code><a href="#nativeadstyle">NativeAdStyle</a></code> | Colours of the native ad strip, as `#RRGGBB` (or `#AARRGGBB`).                                                                                                                                                                                                                                                       |                    | 8.1.0 |
+| **`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 |
+
+
+#### NativeAdStyle
+
+| Prop                     | Type                | Description                                                   |
+| ------------------------ | ------------------- | ------------------------------------------------------------- |
+| **`backgroundColor`**    | <code>string</code> | Background of the strip. Defaults to white.                   |
+| **`textColor`**          | <code>string</code> | Headline text. Defaults to black.                             |
+| **`secondaryTextColor`** | <code>string</code> | Body text. Defaults to textColor.                             |
+| **`buttonColor`**        | <code>string</code> | Call-to-action button and "Ad" badge background.              |
+| **`buttonTextColor`**    | <code>string</code> | Call-to-action button and "Ad" badge text. Defaults to white. |
+| **`dividerColor`**       | <code>string</code> | Hairline along the bottom of the strip. Defaults to none.     |
+
+
 #### RewardAdOptions
 
 | Prop                | Type                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                          | Default            | Since |
@@ -1331,6 +1498,17 @@ From T, pick a set of properties whose keys are in the union K
 | **`Dismissed`**    | <code>'interstitialAdDismissed'</code>    | Emits when the Interstitial ad is not visible to the user anymore.                     |
 
 
+#### NativeAdPluginEvents
+
+| Members            | Value                               | Description                                             |
+| ------------------ | ----------------------------------- | ------------------------------------------------------- |
+| **`SizeChanged`**  | <code>'nativeAdSizeChanged'</code>  | The strip's size in dp; 0 when it is hidden or removed. |
+| **`Loaded`**       | <code>'nativeAdLoaded'</code>       |                                                         |
+| **`FailedToLoad`** | <code>'nativeAdFailedToLoad'</code> |                                                         |
+| **`Clicked`**      | <code>'nativeAdClicked'</code>      |                                                         |
+| **`AdImpression`** | <code>'nativeAdImpression'</code>   |                                                         |
+
+
 #### RewardAdPluginEvents
 
 | Members            | Value                                        | Description                                                                                                                                                                                                                                                                                                                                            |

package/android/src/main/java/com/getcapacitor/community/admob/AdMob.java

@@ -13,6 +13,7 @@ import com.getcapacitor.community.admob.consent.AdConsentExecutor;
 import com.getcapacitor.community.admob.helpers.AuthorizationStatusEnum;
 import com.getcapacitor.community.admob.interstitial.AdInterstitialExecutor;
 import com.getcapacitor.community.admob.interstitial.InterstitialAdCallbackAndListeners;
+import com.getcapacitor.community.admob.nativead.NativeAdExecutor;
 import com.getcapacitor.community.admob.rewarded.AdRewardExecutor;
 import com.getcapacitor.community.admob.rewardedinterstitial.AdRewardInterstitialExecutor;
 import com.google.android.gms.ads.MobileAds;
@@ -34,6 +35,12 @@ public class AdMob extends Plugin {
         this::notifyListeners,
         getLogTag()
     );
+    private final NativeAdExecutor nativeAdExecutor = new NativeAdExecutor(
+        this::getContext,
+        this::getActivity,
+        this::notifyListeners,
+        getLogTag()
+    );
     private final AdRewardExecutor adRewardExecutor = new AdRewardExecutor(
         this::getContext,
         this::getActivity,
@@ -75,6 +82,7 @@ public class AdMob extends Plugin {
                 }
             );
             bannerExecutor.initialize();
+            nativeAdExecutor.initialize();
             call.resolve();
         } catch (Exception ex) {
             call.reject(ex.getLocalizedMessage(), ex);
@@ -160,6 +168,24 @@ public class AdMob extends Plugin {
         bannerExecutor.removeBanner(call);
     }
 
+    // Show a native ad across the top of the screen, loading one when there is none or it expired
+    @PluginMethod
+    public void showNativeAd(final PluginCall call) {
+        nativeAdExecutor.showNativeAd(call);
+    }
+
+    // Hide the native ad but keep it, so showing it again brings back the same ad
+    @PluginMethod
+    public void hideNativeAd(final PluginCall call) {
+        nativeAdExecutor.hideNativeAd(call);
+    }
+
+    // Destroy the native ad, remove it from screen.
+    @PluginMethod
+    public void removeNativeAd(final PluginCall call) {
+        nativeAdExecutor.removeNativeAd(call);
+    }
+
     @PluginMethod
     public void prepareInterstitial(final PluginCall call) {
         adInterstitialExecutor.prepareInterstitial(call, this::notifyListeners);

package/android/src/main/java/com/getcapacitor/community/admob/nativead/NativeAdExecutor.java

@@ -0,0 +1,336 @@
+package com.getcapacitor.community.admob.nativead;
+
+import android.app.Activity;
+import android.content.Context;
+import android.graphics.Color;
+import android.graphics.drawable.GradientDrawable;
+import android.os.Build;
+import android.os.SystemClock;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.ViewTreeObserver;
+import android.widget.Button;
+import android.widget.ImageView;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.coordinatorlayout.widget.CoordinatorLayout;
+import androidx.core.util.Supplier;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.community.admob.admob.R;
+import com.getcapacitor.community.admob.helpers.AdViewIdHelper;
+import com.getcapacitor.community.admob.helpers.RequestHelper;
+import com.getcapacitor.community.admob.models.AdMobPluginError;
+import com.getcapacitor.community.admob.models.AdOptions;
+import com.getcapacitor.community.admob.models.Executor;
+import com.google.android.gms.ads.AdListener;
+import com.google.android.gms.ads.AdLoader;
+import com.google.android.gms.ads.AdRequest;
+import com.google.android.gms.ads.LoadAdError;
+import com.google.android.gms.ads.nativead.NativeAd;
+import com.google.android.gms.ads.nativead.NativeAdView;
+import com.google.android.gms.common.util.BiConsumer;
+
+/**
+ * A native ad drawn as a strip across the top of the screen, over the WebView, like a top banner.
+ * Hiding keeps the loaded ad, so showing it again brings back the same ad without a new request.
+ */
+public class NativeAdExecutor extends Executor {
+
+    public static final String NATIVE_TESTER_ID = "ca-app-pub-3940256099942544/2247696110";
+
+    // A loaded native ad may be shown for an hour; a new one is loaded a little before that.
+    private static final long MAX_AD_AGE_MS = 55 * 60 * 1000;
+
+    private final JSObject emptyObject = new JSObject();
+    private ViewGroup mViewGroup;
+    private NativeAdView mAdView;
+    private NativeAd mNativeAd;
+    private String mLoadedAdId;
+    private long mLoadedAt;
+    private boolean mLoading;
+    private boolean mWantsVisible;
+    // The status bar can change height while the ad is up (rotation, display size), so its margin follows it.
+    private final ViewTreeObserver.OnGlobalLayoutListener insetListener = () -> {
+        if (mAdView != null) applyTopInset();
+    };
+
+    public NativeAdExecutor(
+        Supplier<Context> contextSupplier,
+        Supplier<Activity> activitySupplier,
+        BiConsumer<String, JSObject> notifyListenersFunction,
+        String pluginLogTag
+    ) {
+        super(contextSupplier, activitySupplier, notifyListenersFunction, pluginLogTag, "NativeAdExecutor");
+    }
+
+    public void initialize() {
+        mViewGroup = (ViewGroup) ((ViewGroup) activitySupplier.get().findViewById(android.R.id.content)).getChildAt(0);
+    }
+
+    public void showNativeAd(final PluginCall call) {
+        final AdOptions adOptions = AdOptions.getFactory().createGenericOptions(call, NATIVE_TESTER_ID);
+        final JSObject style = call.getObject("style", new JSObject());
+
+        activitySupplier
+            .get()
+            .runOnUiThread(() -> {
+                try {
+                    ensureAdView();
+                    applyStyle(style);
+                    applyTopInset();
+                    mWantsVisible = true;
+
+                    final AdRequest adRequest = RequestHelper.createRequest(adOptions);
+                    final String adId = AdViewIdHelper.getFinalAdId(adOptions, adRequest, logTag, contextSupplier.get());
+
+                    if (mNativeAd != null && adId.equals(mLoadedAdId) && !isExpired()) {
+                        setVisible(true);
+                    } else {
+                        load(adId, adRequest);
+                    }
+
+                    call.resolve();
+                } catch (Exception ex) {
+                    call.reject(ex.getLocalizedMessage(), ex);
+                }
+            });
+    }
+
+    public void hideNativeAd(final PluginCall call) {
+        activitySupplier
+            .get()
+            .runOnUiThread(() -> {
+                mWantsVisible = false;
+                if (mAdView != null) {
+                    setVisible(false);
+                }
+                call.resolve();
+            });
+    }
+
+    public void removeNativeAd(final PluginCall call) {
+        activitySupplier
+            .get()
+            .runOnUiThread(() -> {
+                mWantsVisible = false;
+                destroyNativeAd();
+
+                if (mAdView != null) {
+                    activitySupplier.get().getWindow().getDecorView().getViewTreeObserver().removeOnGlobalLayoutListener(insetListener);
+                    mAdView.destroy();
+                    mViewGroup.removeView(mAdView);
+                    mAdView = null;
+                    notifySize(0, 0);
+                    Log.d(logTag, "Native AD Removed");
+                }
+
+                call.resolve();
+            });
+    }
+
+    private void load(String adId, AdRequest adRequest) {
+        if (mLoading) return;
+
+        mLoading = true;
+        Log.d(logTag, "Native Ad ID: " + adId);
+
+        final AdLoader adLoader = new AdLoader.Builder(contextSupplier.get(), adId)
+            .forNativeAd((nativeAd) -> {
+                mLoading = false;
+                final Activity activity = activitySupplier.get();
+
+                // Removed, or the app went away, while it loaded.
+                if (mAdView == null || activity == null || activity.isDestroyed()) {
+                    nativeAd.destroy();
+                    return;
+                }
+
+                destroyNativeAd();
+                mNativeAd = nativeAd;
+                mLoadedAdId = adId;
+                mLoadedAt = SystemClock.elapsedRealtime();
+                populate(nativeAd);
+                notifyListeners(NativeAdPluginEvents.Loaded.getWebEventName(), emptyObject);
+
+                if (mWantsVisible) {
+                    setVisible(true);
+                }
+            })
+            .withAdListener(
+                new AdListener() {
+                    @Override
+                    public void onAdFailedToLoad(@NonNull LoadAdError adError) {
+                        mLoading = false;
+
+                        // An expired ad may not be shown again; a fresh one keeps showing.
+                        if (mNativeAd != null && isExpired()) {
+                            destroyNativeAd();
+                        }
+                        if (mNativeAd == null && mAdView != null) {
+                            setVisible(false);
+                        }
+
+                        notifyListeners(NativeAdPluginEvents.FailedToLoad.getWebEventName(), new AdMobPluginError(adError));
+                    }
+
+                    @Override
+                    public void onAdClicked() {
+                        notifyListeners(NativeAdPluginEvents.Clicked.getWebEventName(), emptyObject);
+                    }
+
+                    @Override
+                    public void onAdImpression() {
+                        notifyListeners(NativeAdPluginEvents.AdImpression.getWebEventName(), emptyObject);
+                    }
+                }
+            )
+            .build();
+
+        adLoader.loadAd(adRequest);
+    }
+
+    private void ensureAdView() {
+        if (mAdView != null) return;
+
+        if (mViewGroup == null) {
+            initialize();
+        }
+
+        mAdView = (NativeAdView) LayoutInflater.from(activitySupplier.get()).inflate(R.layout.admob_native_ad_strip, mViewGroup, false);
+
+        final CoordinatorLayout.LayoutParams params = new CoordinatorLayout.LayoutParams(
+            ViewGroup.LayoutParams.MATCH_PARENT,
+            ViewGroup.LayoutParams.WRAP_CONTENT
+        );
+        params.gravity = Gravity.TOP;
+        mAdView.setLayoutParams(params);
+        mAdView.setVisibility(View.GONE);
+
+        mAdView.setHeadlineView(mAdView.findViewById(R.id.admob_native_ad_headline));
+        mAdView.setBodyView(mAdView.findViewById(R.id.admob_native_ad_body));
+        mAdView.setIconView(mAdView.findViewById(R.id.admob_native_ad_icon));
+        mAdView.setCallToActionView(mAdView.findViewById(R.id.admob_native_ad_call_to_action));
+        mAdView.setAdChoicesView(mAdView.findViewById(R.id.admob_native_ad_choices));
+
+        mViewGroup.addView(mAdView);
+        activitySupplier.get().getWindow().getDecorView().getViewTreeObserver().addOnGlobalLayoutListener(insetListener);
+    }
+
+    private void populate(NativeAd nativeAd) {
+        ((TextView) mAdView.getHeadlineView()).setText(nativeAd.getHeadline());
+
+        final TextView body = (TextView) mAdView.getBodyView();
+        body.setText(nativeAd.getBody());
+        body.setVisibility(nativeAd.getBody() == null ? View.GONE : View.VISIBLE);
+
+        final ImageView icon = (ImageView) mAdView.getIconView();
+        if (nativeAd.getIcon() == null) {
+            icon.setVisibility(View.GONE);
+        } else {
+            icon.setImageDrawable(nativeAd.getIcon().getDrawable());
+            icon.setVisibility(View.VISIBLE);
+        }
+
+        final Button callToAction = (Button) mAdView.getCallToActionView();
+        callToAction.setText(nativeAd.getCallToAction());
+        callToAction.setVisibility(nativeAd.getCallToAction() == null ? View.GONE : View.VISIBLE);
+
+        mAdView.setNativeAd(nativeAd);
+    }
+
+    private void applyStyle(JSObject style) {
+        final int backgroundColor = parseColor(style.getString("backgroundColor"), Color.WHITE);
+        final int textColor = parseColor(style.getString("textColor"), Color.BLACK);
+        final int secondaryTextColor = parseColor(style.getString("secondaryTextColor"), textColor);
+        final int buttonColor = parseColor(style.getString("buttonColor"), Color.rgb(26, 115, 232));
+        final int buttonTextColor = parseColor(style.getString("buttonTextColor"), Color.WHITE);
+        final int dividerColor = parseColor(style.getString("dividerColor"), Color.TRANSPARENT);
+        final float density = contextSupplier.get().getResources().getDisplayMetrics().density;
+
+        mAdView.setBackgroundColor(backgroundColor);
+        mAdView.findViewById(R.id.admob_native_ad_divider).setBackgroundColor(dividerColor);
+        ((TextView) mAdView.getHeadlineView()).setTextColor(textColor);
+        ((TextView) mAdView.getBodyView()).setTextColor(secondaryTextColor);
+
+        final TextView badge = mAdView.findViewById(R.id.admob_native_ad_badge);
+        badge.setBackground(rounded(buttonColor, 3 * density));
+        badge.setTextColor(buttonTextColor);
+
+        final Button callToAction = (Button) mAdView.getCallToActionView();
+        callToAction.setBackground(rounded(buttonColor, 18 * density));
+        callToAction.setTextColor(buttonTextColor);
+    }
+
+    // Below the status bar where the app draws under it (Android 15+), like a banner at the top.
+    private void applyTopInset() {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.VANILLA_ICE_CREAM) return;
+
+        final WindowInsetsCompat insets = ViewCompat.getRootWindowInsets(activitySupplier.get().getWindow().getDecorView());
+        final int topInset = insets == null ? 0 : insets.getInsets(WindowInsetsCompat.Type.systemBars()).top;
+        final CoordinatorLayout.LayoutParams params = (CoordinatorLayout.LayoutParams) mAdView.getLayoutParams();
+
+        if (params.topMargin != topInset) {
+            params.topMargin = topInset;
+            mAdView.setLayoutParams(params);
+        }
+    }
+
+    private void setVisible(boolean visible) {
+        mAdView.setVisibility(visible ? View.VISIBLE : View.GONE);
+
+        if (!visible) {
+            notifySize(0, 0);
+            return;
+        }
+
+        // The height is known once it is laid out.
+        mAdView.post(() -> {
+            if (mAdView == null || mAdView.getVisibility() != View.VISIBLE) return;
+
+            final float density = contextSupplier.get().getResources().getDisplayMetrics().density;
+            notifySize(Math.round(mAdView.getWidth() / density), Math.round(mAdView.getHeight() / density));
+        });
+    }
+
+    private void notifySize(int width, int height) {
+        final JSObject size = new JSObject();
+        size.put("width", width);
+        size.put("height", height);
+        notifyListeners(NativeAdPluginEvents.SizeChanged.getWebEventName(), size);
+    }
+
+    private void destroyNativeAd() {
+        if (mNativeAd == null) return;
+
+        mNativeAd.destroy();
+        mNativeAd = null;
+        mLoadedAdId = null;
+    }
+
+    private boolean isExpired() {
+        return SystemClock.elapsedRealtime() - mLoadedAt > MAX_AD_AGE_MS;
+    }
+
+    private static GradientDrawable rounded(int color, float radius) {
+        final GradientDrawable drawable = new GradientDrawable();
+        drawable.setColor(color);
+        drawable.setCornerRadius(radius);
+        return drawable;
+    }
+
+    private static int parseColor(String color, int fallback) {
+        if (color == null) return fallback;
+
+        try {
+            return Color.parseColor(color);
+        } catch (IllegalArgumentException ex) {
+            return fallback;
+        }
+    }
+}

package/android/src/main/java/com/getcapacitor/community/admob/nativead/NativeAdPluginEvents.kt

@@ -0,0 +1,9 @@
+package com.getcapacitor.community.admob.nativead
+
+enum class NativeAdPluginEvents(val webEventName: String) {
+    SizeChanged("nativeAdSizeChanged"),
+    Loaded("nativeAdLoaded"),
+    FailedToLoad("nativeAdFailedToLoad"),
+    Clicked("nativeAdClicked"),
+    AdImpression("nativeAdImpression"),
+}