@capacitor-community/admob 3.0.1 → 3.3.0-0

package/CapacitorCommunityAdmob.podspec

@@ -15,5 +15,5 @@ Pod::Spec.new do |s|
   s.swift_version = '5.1'
   s.static_framework = true
   s.dependency 'Capacitor'
-  s.dependency 'Google-Mobile-Ads-SDK', '~> 8.0'
+  s.dependency 'Google-Mobile-Ads-SDK', '~> 8.12'
 end

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) COPYRIGHT_YEAR COPYRIGHT_HOLDER
+Copyright (c) 2021 Capacitor Community
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -6,15 +6,12 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/maintenance/yes/2021?style=flat-square" />
+  <img src="https://img.shields.io/maintenance/yes/2022?style=flat-square" />
   <!-- <a href="https://github.com/capacitor-community/example/actions?query=workflow%3A%22CI%22"><img src="https://img.shields.io/github/workflow/status/capacitor-community/example/CI?style=flat-square" /></a> -->
   <a href="https://www.npmjs.com/package/@capacitor-community/admob"><img src="https://img.shields.io/npm/l/@capacitor-community/admob?style=flat-square" /></a>
 <br>
   <a href="https://www.npmjs.com/package/@capacitor-community/admob"><img src="https://img.shields.io/npm/dw/@capacitor-community/admob?style=flat-square" /></a>
   <a href="https://www.npmjs.com/package/@capacitor-community/admob"><img src="https://img.shields.io/npm/v/@capacitor-community/admob?style=flat-square" /></a>
-<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-4-orange?style=flat-square" /></a>
-<!-- ALL-CONTRIBUTORS-BADGE:END -->
 </p>
 
 ## Maintainers
@@ -26,9 +23,16 @@
 
 Maintenance Status: Actively Maintained
 
+## Contributors ✨
+<a href="https://github.com/capacitor-community/admob/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=capacitor-community/admob" />
+</a>
+
+Made with [contributors-img](https://contrib.rocks).
+
 ## Demo
 
-[Demo code is here.](https://github.com/capacitor-community/admob/tree/feat/demo)
+[Demo code is here.](https://github.com/capacitor-community/admob/tree/master/demo)
 
 ### Screenshots
 
@@ -104,6 +108,21 @@ Don't forget to replace `[APP_ID]` by your AdMob application Id.
 import { AdMob } from '@capacitor-community/admob';
 
 export async function initialize(): Promise<void> {
+  const { status } = await AdMob.trackingAuthorizationStatus();
+
+  if (status === 'notDetermined') {
+    /**
+     * If you want to explain TrackingAuthorization before showing the iOS dialog,
+     * you can show the modal here.
+     * ex)
+     * const modal = await this.modalCtrl.create({
+     *   component: RequestTrackingPage,
+     * });
+     * await modal.present();
+     * await modal.onDidDismiss();  // Wait for close modal
+     **/
+  }
+ 
   AdMob.initialize({
     requestTrackingAuthorization: true,
     testingDevices: ['2077ef9a63d2b398840261c8221a0c9b'],
@@ -169,7 +188,7 @@ export async function interstitial(): Promise<void> {
 ### Show RewardVideo
 
 ```ts
-import { AdMob, AdOptions, AdLoadInfo, RewardAdPluginEvents, AdMobRewardItem } from '@capacitor-community/admob';
+import { AdMob, RewardAdOptions, AdLoadInfo, RewardAdPluginEvents, AdMobRewardItem } from '@capacitor-community/admob';
 
 export async function rewardVideo(): Promise<void> {
   AdMob.addListener(RewardAdPluginEvents.Loaded, (info: AdLoadInfo) => {
@@ -181,20 +200,57 @@ export async function rewardVideo(): Promise<void> {
     console.log(rewardItem);
   });
 
-  const options: AdOptions = {
+  const options: RewardAdOptions = {
     adId: 'YOUR ADID',
     // isTesting: true
     // npa: true
+    // ssv: {
+    //   userId: "A user ID to send to your SSV"
+    //   customData: JSON.stringify({ ...MyCustomData })
+    //}
   };
   await AdMob.prepareRewardVideoAd(options);
   const rewardItem = await AdMob.showRewardVideoAd();
 }
 ```
 
+## Server-side Verification Notice
+SSV callbacks are only fired on Production Adverts, therefore test Ads will not fire off your SSV callback.
+
+For E2E tests or just for validating the data in your `RewardAdOptions` work as expected, you can add a custom GET
+request to your mock endpoint after the `RewardAdPluginEvents.Rewarded` similar to this:
+```ts
+AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
+  // ...
+  if (ENVIRONMENT_IS_DEVELOPMENT) {
+    try {
+      const url = `https://your-staging-ssv-endpoint` + new URLSearchParams({
+        'ad_network': 'TEST',
+        'ad_unit': 'TEST',
+        'custom_data': customData, // <-- passed CustomData
+        'reward_amount': 'TEST',
+        'reward_item': 'TEST',
+        'timestamp': 'TEST',
+        'transaction_id': 'TEST',
+        'user_id': userId, // <-- Passed UserID
+        'signature': 'TEST',
+        'key_id': 'TEST'
+      });
+      await fetch(url);
+    } catch (err) {
+      console.error(err);
+    }
+  }
+  // ...
+});
+```
+
+
 ## Index
 <docgen-index>
 
 * [`initialize(...)`](#initialize)
+* [`trackingAuthorizationStatus()`](#trackingauthorizationstatus)
 * [`showBanner(...)`](#showbanner)
 * [`hideBanner()`](#hidebanner)
 * [`resumeBanner()`](#resumebanner)
@@ -221,6 +277,7 @@ export async function rewardVideo(): Promise<void> {
 * [`addListener(RewardAdPluginEvents.FailedToShow, ...)`](#addlistenerrewardadplugineventsfailedtoshow-)
 * [`addListener(RewardAdPluginEvents.Showed, ...)`](#addlistenerrewardadplugineventsshowed-)
 * [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
 * [Enums](#enums)
 
 </docgen-index>
@@ -241,7 +298,18 @@ Initialize AdMob with <a href="#admobinitializationoptions">AdMobInitializationO
 | ------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
 | **`options`** | <code><a href="#admobinitializationoptions">AdMobInitializationOptions</a></code> | <a href="#admobinitializationoptions">AdMobInitializationOptions</a> |
 
-**Since:** 1.1.2
+--------------------
+
+
+### trackingAuthorizationStatus()
+
+```typescript
+trackingAuthorizationStatus() => Promise<TrackingAuthorizationStatusInterface>
+```
+
+Confirm requestTrackingAuthorization status (iOS &gt;14)
+
+**Returns:** <code>Promise&lt;<a href="#trackingauthorizationstatusinterface">TrackingAuthorizationStatusInterface</a>&gt;</code>
 
 --------------------
 
@@ -258,8 +326,6 @@ Show a banner Ad
 | ------------- | ----------------------------------------------------------- | ---------------------------------- |
 | **`options`** | <code><a href="#banneradoptions">BannerAdOptions</a></code> | <a href="#adoptions">AdOptions</a> |
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -271,8 +337,6 @@ hideBanner() => Promise<void>
 
 Hide the banner, remove it from screen, but can show it later
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -284,8 +348,6 @@ resumeBanner() => Promise<void>
 
 Resume the banner, show it after hide
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -297,8 +359,6 @@ removeBanner() => Promise<void>
 
 Destroy the banner, remove it from screen.
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -315,8 +375,6 @@ addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: Ad
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -335,8 +393,6 @@ Notice: request loaded Banner ad
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -355,8 +411,6 @@ Notice: request failed Banner ad
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -375,8 +429,6 @@ Notice: full-screen banner view will be presented in response to the user clicki
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -395,8 +447,6 @@ Notice: The full-screen banner view will been dismissed.
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -415,8 +465,6 @@ Unimplemented
 
 **Returns:** <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>
 
-**Since:** 3.0.0
-
 --------------------
 
 
@@ -434,8 +482,6 @@ Prepare interstitial banner
 
 **Returns:** <code>Promise&lt;<a href="#adloadinfo">AdLoadInfo</a>&gt;</code>
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -447,8 +493,6 @@ showInterstitial() => Promise<void>
 
 Show interstitial ad when it’s ready
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -535,19 +579,17 @@ addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => vo
 ### prepareRewardVideoAd(...)
 
 ```typescript
-prepareRewardVideoAd(options: AdOptions) => Promise<AdLoadInfo>
+prepareRewardVideoAd(options: RewardAdOptions) => Promise<AdLoadInfo>
 ```
 
 Prepare a reward video ad
 
-| Param         | Type                                            | Description                        |
-| ------------- | ----------------------------------------------- | ---------------------------------- |
-| **`options`** | <code><a href="#adoptions">AdOptions</a></code> | <a href="#adoptions">AdOptions</a> |
+| Param         | Type                                                        | Description                                    |
+| ------------- | ----------------------------------------------------------- | ---------------------------------------------- |
+| **`options`** | <code><a href="#rewardadoptions">RewardAdOptions</a></code> | <a href="#rewardadoptions">RewardAdOptions</a> |
 
 **Returns:** <code>Promise&lt;<a href="#adloadinfo">AdLoadInfo</a>&gt;</code>
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -561,8 +603,6 @@ Show a reward video ad
 
 **Returns:** <code>Promise&lt;<a href="#admobrewarditem">AdMobRewardItem</a>&gt;</code>
 
-**Since:** 1.1.2
-
 --------------------
 
 
@@ -667,21 +707,31 @@ addListener(eventName: RewardAdPluginEvents.Showed, listenerFunc: () => void) =>
 
 #### AdMobInitializationOptions
 
-| Prop                               | Type                  | Description                                                                                                                                                                                                                                                | Default            | Since |
-| ---------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`requestTrackingAuthorization`** | <code>boolean</code>  | Use or not requestTrackingAuthorization in iOS(&gt;14)                                                                                                                                                                                                     |                    | 1.1.2 |
-| **`testingDevices`**               | <code>string[]</code> | An Array of devices IDs that will be marked as tested devices if {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.initializeForTesting</a>} is true (Real Ads will be served to Testing devices but they will not count as 'real'). |                    | 1.2.0 |
-| **`initializeForTesting`**         | <code>boolean</code>  | If set to true, the devices on {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.testingDevices</a>} will be registered to receive test production ads.                                                                              | <code>false</code> | 1.2.0 |
+| Prop                               | Type                                                              | Description                                                                                                                                                                                                                                                |
+| ---------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`requestTrackingAuthorization`** | <code>boolean</code>                                              | Use or not requestTrackingAuthorization in iOS(&gt;14)                                                                                                                                                                                                     |
+| **`testingDevices`**               | <code>string[]</code>                                             | An Array of devices IDs that will be marked as tested devices if {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.initializeForTesting</a>} is true (Real Ads will be served to Testing devices but they will not count as 'real'). |
+| **`initializeForTesting`**         | <code>boolean</code>                                              | If set to true, the devices on {@link <a href="#admobinitializationoptions">AdMobInitializationOptions.testingDevices</a>} will be registered to receive test production ads.                                                                              |
+| **`tagForChildDirectedTreatment`** | <code>boolean</code>                                              | For purposes of the Children's Online Privacy Protection Act (COPPA), there is a setting called tagForChildDirectedTreatment.                                                                                                                              |
+| **`tagForUnderAgeOfConsent`**      | <code>boolean</code>                                              | When using this feature, a Tag For Users under the Age of Consent in Europe (TFUA) parameter will be included in all future ad requests.                                                                                                                   |
+| **`maxAdContentRating`**           | <code><a href="#maxadcontentrating">MaxAdContentRating</a></code> | WAs an app developer, you can indicate whether you want Google to treat your content as child-directed when you make an ad request.                                                                                                                        |
+
+
+#### TrackingAuthorizationStatusInterface
+
+| Prop         | Type                                                                     |
+| ------------ | ------------------------------------------------------------------------ |
+| **`status`** | <code>'authorized' \| 'denied' \| 'notDetermined' \| 'restricted'</code> |
 
 
 #### BannerAdOptions
 
 This interface extends <a href="#adoptions">AdOptions</a>
 
-| Prop           | Type                                                          | Description                                                                                                                               | Default                      | Since |
-| -------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----- |
-| **`adSize`**   | <code><a href="#banneradsize">BannerAdSize</a></code>         | Banner Ad Size, defaults to ADAPTIVE_BANNER. IT can be: ADAPTIVE_BANNER, SMART_BANNER, BANNER, MEDIUM_RECTANGLE, FULL_BANNER, LEADERBOARD | <code>ADAPTIVE_BANNER</code> | 3.0.0 |
-| **`position`** | <code><a href="#banneradposition">BannerAdPosition</a></code> | Set Banner Ad position. TOP_CENTER or CENTER or BOTTOM_CENTER                                                                             | <code>TOP_CENTER</code>      | 1.1.2 |
+| Prop           | Type                                                          | Description                                                                                                                               |
+| -------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| **`adSize`**   | <code><a href="#banneradsize">BannerAdSize</a></code>         | Banner Ad Size, defaults to ADAPTIVE_BANNER. IT can be: ADAPTIVE_BANNER, SMART_BANNER, BANNER, MEDIUM_RECTANGLE, FULL_BANNER, LEADERBOARD |
+| **`position`** | <code><a href="#banneradposition">BannerAdPosition</a></code> | Set Banner Ad position. TOP_CENTER or CENTER or BOTTOM_CENTER                                                                             |
 
 
 #### PluginListenerHandle
@@ -721,12 +771,19 @@ https://developers.google.com/android/reference/com/google/android/gms/ads/AdErr
 
 #### AdOptions
 
-| Prop            | Type                 | Description                                                                                                                                  | Default            | Since |
-| --------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`adId`**      | <code>string</code>  | The ad unit ID that you want to request                                                                                                      |                    | 1.1.2 |
-| **`isTesting`** | <code>boolean</code> | You can use test mode of ad.                                                                                                                 | <code>false</code> | 1.1.2 |
-| **`margin`**    | <code>number</code>  | Margin Banner. Default is 0px; If position is BOTTOM_CENTER, margin is be margin-bottom. If position is TOP_CENTER, margin is be margin-top. | <code>0</code>     | 1.1.2 |
-| **`npa`**       | <code>boolean</code> | The default behavior of the Google Mobile Ads SDK is to serve personalized ads. Set this to true to request Non-Personalized Ads             | <code>false</code> | 1.2.0 |
+| Prop            | Type                 | Description                                                                                                                                  |
+| --------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`adId`**      | <code>string</code>  | The ad unit ID that you want to request                                                                                                      |
+| **`isTesting`** | <code>boolean</code> | You can use test mode of ad.                                                                                                                 |
+| **`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. |
+| **`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             |
+
+
+#### RewardAdOptions
+
+| Prop      | Type                                                                                                                                                                                                                                               | Description                                                                                                                                                                                     |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`ssv`** | <code><a href="#atleastone">AtLeastOne</a>&lt;{ /** * An optional UserId to pass to your SSV callback function. */ userId: string; /** * An optional custom set of data to pass to your SSV callback function. */ customData: string; }&gt;</code> | If you have enabled SSV in your AdMob Application. You can provide customData or a userId be passed to your callback to do further processing on. *Important* You *HAVE* to define one of them. |
 
 
 #### AdMobRewardItem
@@ -740,9 +797,34 @@ https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
 | **`amount`** | <code>number</code> | Rewarded amount user got |
 
 
+### Type Aliases
+
+
+#### AtLeastOne
+
+<code>{[K in keyof T]: <a href="#pick">Pick</a>&lt;T, K&gt;}[keyof T]</code>
+
+
+#### Pick
+
+From T, pick a set of properties whose keys are in the union K
+
+<code>{
 [P in K]: T[P];
 }</code>
+
+
 ### Enums
 
 
+#### MaxAdContentRating
+
+| Members                | Value                           | Description                                                 |
+| ---------------------- | ------------------------------- | ----------------------------------------------------------- |
+| **`General`**          | <code>'General'</code>          | Content suitable for general audiences, including families. |
+| **`ParentalGuidance`** | <code>'ParentalGuidance'</code> | Content suitable for most audiences with parental guidance. |
+| **`Teen`**             | <code>'Teen'</code>             | Content suitable for teen and older audiences.              |
+| **`MatureAudience`**   | <code>'MatureAudience'</code>   | Content suitable only for mature audiences.                 |
+
+
 #### BannerAdSize
 
 | Members                | Value                           | Description                                                                                         |
@@ -813,28 +895,3 @@ You should run `pod repo update` ;
 ## License
 
 Capacitor AdMob is [MIT licensed](./LICENSE).
-
-## Contributors ✨
-
-Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
-
-<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
-<!-- prettier-ignore-start -->
-<!-- markdownlint-disable -->
-<table>
-  <tr>
-    <td align="center"><a href="https://wako.app"><img src="https://avatars1.githubusercontent.com/u/216573?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jean-Baptiste Malatrasi</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=JumBay" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/gant02"><img src="https://avatars1.githubusercontent.com/u/6771123?v=4?s=100" width="100px;" alt=""/><br /><sub><b>gant02</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=gant02" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.saninnsalas.com"><img src="https://avatars1.githubusercontent.com/u/5490201?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Saninn Salas Diaz</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=distante" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.nicolueg.com"><img src="https://avatars.githubusercontent.com/u/48101693?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nico Lueg</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=NLueg" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.linkedin.com/in/ghonche-yqr-21774b114/"><img src="https://avatars.githubusercontent.com/u/25591295?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ghonche Yqr</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=ghonche-yqr" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/vanessag"><img src="https://avatars.githubusercontent.com/u/4007550?v=4?s=100" width="100px;" alt=""/><br /><sub><b>vanessag</b></sub></a><br /><a href="https://github.com/capacitor-community/admob/commits?author=vanessag" title="Code">💻</a></td>
-  </tr>
-</table>
-
-<!-- markdownlint-restore -->
-<!-- prettier-ignore-end -->
-
-<!-- ALL-CONTRIBUTORS-LIST:END -->
-
-This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

package/android/build.gradle

@@ -1,11 +1,12 @@
 ext {
-    junitVersion =  project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.12'
-    androidxJunitVersion =  project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.2'
-    androidxEspressoCoreVersion =  project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.3.0'
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.1'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.2.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.2'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.3.0'
 }
 
 buildscript {
-    ext.kotlin_version = '1.4.32'
+    ext.kotlin_version = '1.5.21'
     repositories {
         google()
         jcenter()
@@ -49,7 +50,7 @@ repositories {
     mavenCentral()
 }
 
-def testRunner = "1.3.0"
+def testRunner = "1.4.0"
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
@@ -70,14 +71,15 @@ dependencies {
     //    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     //    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
 
-    implementation 'com.google.android.gms:play-services-ads:20.1.0'
-    implementation 'com.android.support:appcompat-v7:28.0.0'
+	// after 20.5.0, require minCompileSdk (31)
+    implementation 'com.google.android.gms:play-services-ads:20.4.0'
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "androidx.coordinatorlayout:coordinatorlayout:1.1.0"
-    implementation "androidx.core:core-ktx:1.5.0"
+    implementation "androidx.core:core-ktx:1.6.0"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 }
 
 // Allow to run unit test with  ./gradlew test
 tasks.withType(Test) {
     useJUnitPlatform()
-}
+}

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

@@ -2,12 +2,14 @@ package com.getcapacitor.community.admob;
 
 import android.Manifest;
 import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 import com.getcapacitor.annotation.Permission;
 import com.getcapacitor.community.admob.banner.BannerExecutor;
+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.rewarded.AdRewardExecutor;
@@ -47,14 +49,7 @@ public class AdMob extends Plugin {
     // Initialize AdMob with appId
     @PluginMethod
     public void initialize(final PluginCall call) {
-        final boolean initializeForTesting = call.getBoolean("initializeForTesting", false);
-
-        if (initializeForTesting) {
-            JSArray testingDevices = call.getArray("testingDevices", AdMob.EMPTY_TESTING_DEVICES);
-            this.setTestingDevicesTo(call, testingDevices);
-        } else {
-            this.setTestingDevicesTo(call, EMPTY_TESTING_DEVICES);
-        }
+        this.setRequestConfiguration(call);
 
         try {
             MobileAds.initialize(
@@ -71,6 +66,13 @@ public class AdMob extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void trackingAuthorizationStatus(final PluginCall call) {
+        JSObject response = new JSObject();
+        response.put("status", AuthorizationStatusEnum.AUTHORIZED.getStatus());
+        call.resolve(response);
+    }
+
     // Show a banner Ad
     @PluginMethod
     public void showBanner(final PluginCall call) {
@@ -117,18 +119,69 @@ public class AdMob extends Plugin {
     }
 
     /**
-     * An Array of devices IDs that will be marked as tested devices.
-     *
      * @see <a href="https://developers.google.com/admob/android/test-ads#enable_test_devices">Test Devices</a>
+     * @see <a href="https://developers.google.com/admob/android/targeting">Target Settings</a>
      */
-    private void setTestingDevicesTo(final PluginCall call, JSArray testingDevices) {
-        // TODO: create a function to automatically get the device ID when isTesting is true? https://stackoverflow.com/a/36242494/1255819
+    private void setRequestConfiguration(final PluginCall call) {
+        // Testing Devices
+        final boolean initializeForTesting = call.getBoolean("initializeForTesting", false);
+        final JSArray testingDevices = initializeForTesting
+            ? call.getArray("testingDevices", AdMob.EMPTY_TESTING_DEVICES)
+            : EMPTY_TESTING_DEVICES;
+
+        // tagForChildDirectedTreatment
+        final Boolean tagForChildDirectedTreatment = call.getBoolean("tagForChildDirectedTreatment");
+        int TAG_FOR_CHILD_DIRECTED_TREATMENT;
+
+        if (tagForChildDirectedTreatment == null) {
+            TAG_FOR_CHILD_DIRECTED_TREATMENT = RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED;
+        } else if (tagForChildDirectedTreatment) {
+            TAG_FOR_CHILD_DIRECTED_TREATMENT = RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE;
+        } else {
+            TAG_FOR_CHILD_DIRECTED_TREATMENT = RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE;
+        }
+
+        // tagForUnderAgeOfConsent
+        final Boolean tagForUnderAgeOfConsent = call.getBoolean("tagForUnderAgeOfConsent");
+        int TAG_FOR_UNDER_AGE_OF_CONSENT;
+
+        if (tagForUnderAgeOfConsent == null) {
+            TAG_FOR_UNDER_AGE_OF_CONSENT = RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED;
+        } else if (tagForUnderAgeOfConsent) {
+            TAG_FOR_UNDER_AGE_OF_CONSENT = RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE;
+        } else {
+            TAG_FOR_UNDER_AGE_OF_CONSENT = RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE;
+        }
+
+        // maxAdContentRating
+        final String maxAdContentRating = call.getString("maxAdContentRating");
+        String MAX_AD_CONTENT_RATING = RequestConfiguration.MAX_AD_CONTENT_RATING_UNSPECIFIED;
+
+        if (maxAdContentRating != null) {
+            switch (maxAdContentRating) {
+                case "General":
+                    MAX_AD_CONTENT_RATING = RequestConfiguration.MAX_AD_CONTENT_RATING_G;
+                    break;
+                case "ParentalGuidance":
+                    MAX_AD_CONTENT_RATING = RequestConfiguration.MAX_AD_CONTENT_RATING_PG;
+                    break;
+                case "Teen":
+                    MAX_AD_CONTENT_RATING = RequestConfiguration.MAX_AD_CONTENT_RATING_T;
+                    break;
+                case "MatureAudience":
+                    MAX_AD_CONTENT_RATING = RequestConfiguration.MAX_AD_CONTENT_RATING_MA;
+                    break;
+            }
+        }
+
         try {
-            final RequestConfiguration configuration = new RequestConfiguration.Builder()
+            RequestConfiguration requestConfiguration = new RequestConfiguration.Builder()
                 .setTestDeviceIds(testingDevices.<String>toList())
+                .setTagForChildDirectedTreatment(TAG_FOR_CHILD_DIRECTED_TREATMENT)
+                .setTagForUnderAgeOfConsent(TAG_FOR_UNDER_AGE_OF_CONSENT)
+                .setMaxAdContentRating(MAX_AD_CONTENT_RATING)
                 .build();
-
-            MobileAds.setRequestConfiguration(configuration);
+            MobileAds.setRequestConfiguration(requestConfiguration);
         } catch (JSONException error) {
             call.reject(error.toString());
         }

package/android/src/main/java/com/getcapacitor/community/admob/helpers/AuthorizationStatusEnum.kt

@@ -0,0 +1,5 @@
+package com.getcapacitor.community.admob.helpers
+
+enum class AuthorizationStatusEnum(val status: String) {
+    AUTHORIZED("authorized");
+}