react-native-google-mobile-ads 15.6.0 → 15.8.0

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsBannerAdViewManager.java

@@ -57,6 +57,8 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
     extends SimpleViewManager<ReactNativeAdView> {
   private static final String REACT_CLASS = "RNGoogleMobileAdsBannerView";
   private final String EVENT_AD_LOADED = "onAdLoaded";
+  private final String EVENT_AD_IMPRESSION = "onAdImpression";
+  private final String EVENT_AD_CLICKED = "onAdClicked";
   private final String EVENT_AD_FAILED_TO_LOAD = "onAdFailedToLoad";
   private final String EVENT_AD_OPENED = "onAdOpened";
   private final String EVENT_AD_CLOSED = "onAdClosed";
@@ -283,6 +285,16 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
           public void onAdClosed() {
             sendEvent(reactViewGroup, EVENT_AD_CLOSED, null);
           }
+
+          @Override
+          public void onAdImpression() {
+            sendEvent(reactViewGroup, EVENT_AD_IMPRESSION, null);
+          }
+
+          @Override
+          public void onAdClicked() {
+            sendEvent(reactViewGroup, EVENT_AD_CLICKED, null);
+          }
         });
     if (adView instanceof AdManagerAdView) {
       ((AdManagerAdView) adView)

package/docs/displaying-ads.mdx

@@ -456,6 +456,8 @@ or network triggers an event:
 - `onAdFailedToLoad`
 - `onAdLeftApplication`
 - `onAdOpened`
+- `onAdImpression`
+- `onAdClicked`
 - `onPaid` — On [impression-level ad revenue](https://support.google.com/admob/answer/11322405?hl=en) events.
 
 Each render of the component loads a single advert, allowing you to display multiple adverts at once. If you need to reload/change

package/docs/european-user-consent.mdx

@@ -11,8 +11,8 @@ Android & iOS, and provides a single JavaScript interface for both platforms.
 
 ## Understanding AdMob Ads
 
-Ads served by Google can be categorized as personalized or non-personalized, both requiring consent from users in the EEA. By default,
-ad requests to Google serve personalized ads, with ad selection based on the user's previously collected data. Users outside of the EEA do not require consent.
+Ads served by Google can be categorized as personalized, non-personalized, Limited ads and technical ads. To understand more about what ads can be served based on a
+user's consent choices, see Ad serving modes ([Android](https://developers.google.com/admob/android/privacy/ad-serving-modes) / [iOS](https://developers.google.com/admob/ios/privacy/ad-serving-modes)). 
 
 <Info>
 The `AdsConsent` helper only provides you with the tools for requesting consent, it is up to the developer to ensure the consent status is reflected throughout the app.
@@ -191,10 +191,13 @@ The completion handler is called after the form is dismissed. If consent is not
 
 To make it easier we added a helper method `gatherConsent` that combines requesting consent information and loading/presenting a consent form if necessary.
 
-Before requesting ads in your app, check if you have obtained consent from the user using `canRequestAds`.
+Before requesting ads in your app, check if you have gathered consent aligned with your app's configured messages using `canRequestAds`.
 If an error occurs during the consent gathering process, you should still attempt to request ads.
 The UMP SDK uses the consent status from the previous session.
 
+**Note:** For more information on when `canRequestAds` is `true` or `false`, see the reference documentation for [Android](https://developers.google.com/admob/android/reference/privacy/com/google/android/ump/ConsentInformation#canRequestAds()) /
+[iOS](https://developers.google.com/admob/ios/privacy/api/reference/Classes/UMPConsentInformation#canrequestads).
+
 ```js
 import mobileAds, { AdsConsent, AdsConsentStatus } from 'react-native-google-mobile-ads';
 
@@ -237,9 +240,8 @@ async function startGoogleMobileAdsSDK() {
 
 ### Inspecting consent choices
 
-The AdsConsentStatus tells you if you should show the modal to a user or not. Often times you want to run logic based on the user's choices though.
-Especially since the Google Mobile Ads SDK won't show any ads if the user didn't give consent to store and/or access information on the device.
-This library exports a method that returns some of the most relevant consent flags to handle common use cases.
+The AdsConsentStatus tells you if you should show the modal to a user or not. Often times you want to run logic based on the user's choices. This library exports a
+method that returns some of the most relevant consent flags to handle common use cases.
 
 ```js
 import { AdsConsent } from 'react-native-google-mobile-ads';
@@ -260,10 +262,7 @@ const {
 } = await AdsConsent.getUserChoices();
 
 if (storeAndAccessInformationOnDevice === false) {
-  /**
-   * The user declined consent for purpose 1,
-   * the Google Mobile Ads SDK won't serve ads.
-   */
+  // The user declined consent for purpose 1.
 }
 ```
 
@@ -310,6 +309,7 @@ AdsConsent.reset();
 
 ### Troubleshooting
 
-In case of troubles, double-check the original documentation for underlying
-UMP SDK for [Android](https://developers.google.com/admob/ump/android/quick-start) /
+In case of troubles, double-check the following artifacts:
+* Original documentation for underlying UMP SDK for [Android](https://developers.google.com/admob/ump/android/quick-start) /
 [iOS](https://developers.google.com/admob/ump/ios/quick-start).
+* Google Help Center [European regulations](https://support.google.com/admob/topic/10115026) articles.

package/ios/RNGoogleMobileAds/RNGoogleMobileAdsBannerComponent.m

@@ -184,6 +184,14 @@
   [self sendEvent:@"onAdOpened" payload:nil];
 }
 
+- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
+  [self sendEvent:@"onAdImpression" payload:nil];
+}
+
+- (void)bannerViewDidRecordClick:(GADBannerView *)bannerView {
+  [self sendEvent:@"onAdClicked" payload:nil];
+}
+
 - (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
   // not in use
 }

package/ios/RNGoogleMobileAds/RNGoogleMobileAdsBannerView.mm

@@ -225,6 +225,24 @@ using namespace facebook::react;
   }
 }
 
+- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
+  if (_eventEmitter != nullptr) {
+    std::dynamic_pointer_cast<const facebook::react::RNGoogleMobileAdsBannerViewEventEmitter>(
+        _eventEmitter)
+        ->onNativeEvent(facebook::react::RNGoogleMobileAdsBannerViewEventEmitter::OnNativeEvent{
+            .type = "onAdImpression"});
+  }
+}
+
+- (void)bannerViewDidRecordClick:(GADBannerView *)bannerView {
+  if (_eventEmitter != nullptr) {
+    std::dynamic_pointer_cast<const facebook::react::RNGoogleMobileAdsBannerViewEventEmitter>(
+        _eventEmitter)
+        ->onNativeEvent(facebook::react::RNGoogleMobileAdsBannerViewEventEmitter::OnNativeEvent{
+            .type = "onAdClicked"});
+  }
+}
+
 - (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
   // not in use
 }

package/lib/commonjs/version.js

@@ -5,5 +5,5 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.version = void 0;
 // Generated by genversion.
-const version = exports.version = '15.6.0';
+const version = exports.version = '15.8.0';
 //# sourceMappingURL=version.js.map

package/lib/module/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '15.6.0';
+export const version = '15.8.0';
 //# sourceMappingURL=version.js.map

package/lib/typescript/index.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "15.6.0";
+export declare const SDK_VERSION = "15.8.0";
 export { default, MobileAds } from './MobileAds';
 export { AdsConsentDebugGeography, AdsConsentInfo, AdsConsentInfoOptions, AdsConsentInterface, AdsConsentPrivacyOptionsRequirementStatus, AdsConsentStatus, AdsConsentUserChoices, } from './specs/modules/NativeConsentModule';
 export { AdsConsentPurposes } from './AdsConsentPurposes';

package/lib/typescript/types/BannerAdProps.d.ts

@@ -74,6 +74,14 @@ export interface BannerAdProps {
      * The ad is now visible to the user.
      */
     onAdOpened?: () => void;
+    /**
+     * Called when an impression is recorded for an ad.
+     */
+    onAdImpression?: () => void;
+    /**
+     * Called when a click is recorded for an ad
+     */
+    onAdClicked?: () => void;
     /**
      * Called when the user is about to return to the app after tapping on an ad.
      */

package/lib/typescript/types/BannerAdProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BannerAdProps.d.ts","sourceRoot":"","sources":["../../../src/types/BannerAdProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAErE;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;IACnE;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C"}
+{"version":3,"file":"BannerAdProps.d.ts","sourceRoot":"","sources":["../../../src/types/BannerAdProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAErE;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;IACnE;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C"}

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "15.6.0";
+export declare const version = "15.8.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-google-mobile-ads",
-  "version": "15.6.0",
+  "version": "15.8.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Google Mobile Ads is an easy way to monetize mobile apps with targeted, in-app advertising.",
   "main": "lib/commonjs/index.js",
@@ -43,7 +43,7 @@
   ],
   "sdkVersions": {
     "ios": {
-      "googleMobileAds": "12.9.0",
+      "googleMobileAds": "12.11.0",
       "googleUmp": "3.0.0"
     },
     "android": {
@@ -51,7 +51,7 @@
       "targetSdk": 34,
       "compileSdk": 34,
       "buildTools": "34.0.0",
-      "googleMobileAds": "24.5.0",
+      "googleMobileAds": "24.6.0",
       "googleUmp": "3.2.0"
     }
   },

package/src/ads/BaseAd.tsx

@@ -79,7 +79,7 @@ export const BaseAd = React.forwardRef<
             width: number;
             height: number;
           }
-        | { type: 'onAdOpened' | 'onAdClosed' }
+        | { type: 'onAdOpened' | 'onAdClosed' | 'onAdImpression' | 'onAdClicked' }
         | {
             type: 'onAdFailedToLoad';
             code: string;

package/src/types/BannerAdProps.ts

@@ -80,6 +80,16 @@ export interface BannerAdProps {
    */
   onAdOpened?: () => void;
 
+  /**
+   * Called when an impression is recorded for an ad.
+   */
+  onAdImpression?: () => void;
+
+  /**
+   * Called when a click is recorded for an ad
+   */
+  onAdClicked?: () => void;
+
   /**
    * Called when the user is about to return to the app after tapping on an ad.
    */

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '15.6.0';
+export const version = '15.8.0';