react-native-google-mobile-ads 5.0.0 → 5.1.1

package/RNGoogleMobileAds.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.social_media_url    = 'http://twitter.com/invertaseio'
   s.ios.deployment_target = "10.0"
   s.source_files        = 'ios/**/*.{h,m}'
-  s.frameworks          = "AppTrackingTransparency"
+  s.weak_frameworks     = "AppTrackingTransparency"
 
   # React Native dependencies
   s.dependency          'React-Core'

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

@@ -16,11 +16,13 @@ package io.invertase.googlemobileads;
  * limitations under the License.
  *
  */
-
+import android.content.SharedPreferences;
+import android.preference.PreferenceManager;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.google.android.ump.ConsentDebugSettings;
@@ -28,7 +30,6 @@ import com.google.android.ump.ConsentInformation;
 import com.google.android.ump.ConsentRequestParameters;
 import com.google.android.ump.UserMessagingPlatform;
 import io.invertase.googlemobileads.common.ReactNativeModule;
-import java.util.List;
 import javax.annotation.Nonnull;
 
 public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
@@ -63,10 +64,10 @@ public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
           new ConsentDebugSettings.Builder(getApplicationContext());
 
       if (options.hasKey("testDeviceIdentifiers")) {
-        List<Object> devices = options.getArray("testDeviceIdentifiers").toArrayList();
+        ReadableArray devices = options.getArray("testDeviceIdentifiers");
 
-        for (Object device : devices) {
-          debugSettingsBuilder.addTestDeviceHashedId((String) device);
+        for (int i = 0; i < devices.size(); i++) {
+          debugSettingsBuilder.addTestDeviceHashedId(devices.getString(i));
         }
       }
 
@@ -152,4 +153,17 @@ public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
   public void reset() {
     consentInformation.reset();
   }
+
+  @ReactMethod
+  public void getTCString(Promise promise) {
+    try {
+      SharedPreferences prefs =
+          PreferenceManager.getDefaultSharedPreferences(getReactApplicationContext());
+      // https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details
+      String tcString = prefs.getString("IABTCF_TCString", null);
+      promise.resolve(tcString);
+    } catch (Exception e) {
+      rejectPromiseWithCodeAndMessage(promise, "consent-string-error", e.toString());
+    }
+  }
 }

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

@@ -117,7 +117,7 @@ public class ReactNativeGoogleMobileAdsModule extends ReactNativeModule {
   @ReactMethod
   public void initialize(Promise promise) {
     MobileAds.initialize(
-        getContext(),
+        getApplicationContext(),
         new OnInitializationCompleteListener() {
           @Override
           public void onInitializationComplete(InitializationStatus initializationStatus) {

package/docs/common-reasons-for-ads-not-showing.mdx

@@ -13,6 +13,7 @@ You'll be notified of approval or rejection via email after review.
 
 New apps and ad units take some time to activate.
 Here are common reasons you may not see live impressions immediately:
+
 - It usually takes at least an hour after you create an app or ad unit
 - Sometimes it can take a few days for ads to appear in new apps or ad units
 - New iOS apps will not show Google ads until they’re listed in the Apple App Store
@@ -35,6 +36,7 @@ Test devices can either be added in the AdMob UI or programmatically using the G
 Follow the steps below to add your device as a test device.
 
 #### Add your test device in the AdMob UI
+
 For a simple, non-programmatic way to add a test device and test new or existing app builds, use the AdMob UI.
 [Learn how](https://support.google.com/admob/answer/9691433).
 
@@ -48,39 +50,39 @@ If you want to test ads in your app as you're developing, follow the steps below
 
 3. Check the console for a message that looks like this:
 
-    ```
-    GADMobileAds.sharedInstance.requestConfiguration.testDeviceIdentifiers = 
-      @[ @"2077ef9a63d2b398840261c8221a0c9b"  ]; // Sample device ID
-    ```
+   ```
+   GADMobileAds.sharedInstance.requestConfiguration.testDeviceIdentifiers =
+     @[ @"2077ef9a63d2b398840261c8221a0c9b"  ]; // Sample device ID
+   ```
 
-    Copy your test device ID to your clipboard.
+   Copy your test device ID to your clipboard.
 
 4. Check the logcat output for a message that looks like the one below, which shows you your device ID and how to add it as a test device:
 
-    ```
-    I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
-    to get test ads on this device."
-    ```
+   ```
+   I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
+   to get test ads on this device."
+   ```
 
-    Copy your test device ID to your clipboard.
+   Copy your test device ID to your clipboard.
 
 5. Modify your code to set the test device ID through testDeviceIdentifiers
 
-    ```js
-    import mobileAds from 'react-native-google-mobile-ads';
+   ```js
+   import mobileAds from 'react-native-google-mobile-ads';
 
-    mobileAds()
-      .setRequestConfiguration({
-        // An array of test device IDs to add to the allow list.
-        testDeviceIdentifiers: ["2077ef9a63d2b398840261c8221a0c9b", "EMULATOR"]
-      })
-      .then(() => {
-        // Request config successfully set!
-      });
-    ```
+   mobileAds()
+     .setRequestConfiguration({
+       // An array of test device IDs to add to the allow list.
+       testDeviceIdentifiers: ['2077ef9a63d2b398840261c8221a0c9b', 'EMULATOR'],
+     })
+     .then(() => {
+       // Request config successfully set!
+     });
+   ```
 
-5. Re-run your app. If the ad is a Google ad, you'll see a Test Ad label centered at the top of the ad.
-Ads with this Test Ad label are safe to click. Requests, impressions, and clicks on test ads will not show up in your account's reports.
+6. Re-run your app. If the ad is a Google ad, you'll see a Test Ad label centered at the top of the ad.
+   Ads with this Test Ad label are safe to click. Requests, impressions, and clicks on test ads will not show up in your account's reports.
 
 ## Emulator vs real device
 
@@ -89,4 +91,4 @@ In some cases ads won't show up on an emulator but will show up while testing on
 ## Extra links
 
 - Mobile Ads SDK [iOS](https://developers.google.com/admob/ios/quick-start), [Android](https://developers.google.com/admob/android/quick-start)
-- [Common reasons for ads not showing](https://support.google.com/admob/answer/9469204)
+- [Common reasons for ads not showing](https://support.google.com/admob/answer/9469204)

package/docs/displaying-ads-hook.mdx

@@ -0,0 +1,99 @@
+# Hooks
+
+The AdMob package provides hooks to help you to display ads in a functional component with tiny code. The supported ad formats are full-screen ads: App open, Interstitial & Rewarded.
+
+## Load an ad
+
+You can create a new ad by adding a corresponding ad type's hook to your component.
+
+The first argument of the hook is the "Ad Unit ID".
+For testing, we can use a Test ID, however for production the ID from the
+Google AdMob dashboard under "Ad units" should be used:
+
+```tsx {4-8}
+import { useInterstitialAd, TestIds } from 'react-native-google-mobile-ads';
+
+export default function App() {
+  const interstitialAd = useInterstitialAd(TestIds.Interstitial, {
+    requestNonPersonalizedAdsOnly: true,
+  });
+
+  return <View>{/* ... */}</View>;
+}
+```
+
+> The `adUnitid` parameter can also be used to manage creation and destruction of an ad instance.
+> If `adUnitid` is set or changed, new ad instance will be created and previous ad instance will be destroyed if exists.
+> If `adUnitid` is set to `null`, no ad instance will be created and previous ad instance will be destroyed if exists.
+
+The second argument is an additional optional request options object to be sent whilst loading an advert, such as keywords & location.
+Setting additional request options helps AdMob choose better tailored ads from the network. View the [`RequestOptions`](/reference/admob/requestoptions)
+documentation to view the full range of options available.
+
+## Show the ad
+
+The hook returns several states and functions to control ad.
+
+```tsx
+import { useInterstitialAd, TestIds } from 'react-native-google-mobile-ads';
+
+export default function App({ navigation }) {
+  const { isLoaded, isClosed, load, show } = useInterstitialAd(TestIds.Interstitial, {
+    requestNonPersonalizedAdsOnly: true,
+  });
+
+  useEffect(() => {
+    // Start loading the interstitial straight away
+    load();
+  }, [load]);
+
+  useEffect(() => {
+    if (isClosed) {
+      // Action after the ad is closed
+      navigation.navigate('NextScreen');
+    }
+  }, [isClosed, navigation]);
+
+  return (
+    <View>
+      <Button
+        title="Navigate to next screen"
+        onPress={() => {
+          if (isLoaded) {
+            show();
+          } else {
+            // No advert ready to show yet
+            navigation.navigate('NextScreen');
+          }
+        }}
+      />
+    </View>
+  );
+}
+```
+
+The code above immediately starts to load a new advert from the network (via `load()`).
+When user presses button, it checks if the ad is loaded via `isLoaded` value,
+then the `show` function is called and the advert is shown over-the-top of your application.
+Otherwise, if the ad is not loaded, the `navigation.navigate` method is called to navigate to the next screen without showing the ad.
+After the ad is closed, the `isClosed` value is set to `true` and the `navigation.navigate` method is called to navigate to the next screen.
+
+If needed, you can reuse the existing hook to load more adverts and show them when required. The states are initialized when the `load` function is called.
+
+Return values of the hook are:
+
+| Name           | Type                               | Description                                                                                                        |
+| :------------- | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
+| isLoaded       | boolean                            | Whether the ad is loaded and ready to to be shown to the user.                                                     |
+| isOpened       | boolean                            | Whether the ad is opened. The value is remained `true` even after the ad is closed unless **new ad is requested**. |
+| isClosed       | boolean                            | Whether your ad is dismissed.                                                                                      |
+| isShowing      | boolean                            | Whether your ad is showing. The value is equal with `isOpened && !isClosed`.                                       |
+| error          | Error \| undefined                 | `Error` object throwed during ad load.                                                                             |
+| reward         | [RewardedAdReward](#) \| undefined | Loaded reward item of the Rewarded Ad. Available only in RewardedAd.                                               |
+| isEarnedReward | boolean                            | Whether the user earned the reward by Rewarded Ad.                                                                 |
+| load           | Function                           | Start loading the advert with the provided RequestOptions.                                                         |
+| show           | Function                           | Show the loaded advert to the user.                                                                                |
+
+> Note that `isOpened` value remains `true` even after the ad is closed.
+> The value changes to `false` when ad is initialized via calling `load()`.
+> To determine whether the ad is currently showing, use `isShowing` value.

package/docs/displaying-ads.mdx

@@ -27,11 +27,10 @@ const appOpenAd = AppOpenAd.createForAdRequest(adUnitId, {
 });
 
 // Preload an app open ad
-appOpenAd.load()
+appOpenAd.load();
 
 // Show the app open ad when user brings the app to the foreground.
-appOpenAd.show()
-
+appOpenAd.show();
 ```
 
 ### Consider ad expiration
@@ -159,7 +158,7 @@ The purpose of a rewarded ad is to reward users with _something_ after completin
 as watching a video or submitting an option via an interactive form. If the user completes the action, you can reward them
 with something (e.g. in-game currency).
 
-To create a new interstitial, call the `createForAdRequest` method from the `RewardedAd` class. The first argument
+To create a new rewarded ad, call the `createForAdRequest` method from the `RewardedAd` class. The first argument
 of the method is the "Ad Unit ID". For testing, we can use a Test ID, however for production the ID from the
 Google AdMob dashboard under "Ad units" should be used:
 

package/docs/european-user-consent.mdx

@@ -93,16 +93,45 @@ import { AdsConsent, AdsConsentStatus } from 'react-native-google-mobile-ads';
 
 const consentInfo = await AdsConsent.requestInfoUpdate();
 
-if (
-  consentInfo.isConsentFormAvailable &&
-  consentInfo.status === AdsConsentStatus.REQUIRED
-) {
+if (consentInfo.isConsentFormAvailable && consentInfo.status === AdsConsentStatus.REQUIRED) {
   const { status } = await AdsConsent.showForm();
 }
 ```
 
 > Do not persist the status. You could however store this locally in application state (e.g. React Context) and update the status on every app launch as it may change.
 
+### 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.
+
+```js
+import { AdsConsent } from 'react-native-google-mobile-ads';
+
+const {
+  activelyScanDeviceCharacteristicsForIdentification,
+  applyMarketResearchToGenerateAudienceInsights,
+  createAPersonalisedAdsProfile,
+  createAPersonalisedContentProfile,
+  developAndImproveProducts,
+  measureAdPerformance,
+  measureContentPerformance,
+  selectBasicAds,
+  selectPersonalisedAds,
+  selectPersonalisedContent,
+  storeAndAccessInformationOnDevice,
+  usePreciseGeolocationData,
+} = await AdsConsent.getUserChoices();
+
+if (storeAndAccessInformationOnDevice === false) {
+  /**
+   * The user declined consent for purpose 1,
+   * the Google Mobile Ads SDK won't serve ads.
+   */
+}
+```
+
 ### Testing
 
 When developing the consent flow, the behavior of the `AdsConsent` responses may not be reliable due to the environment
@@ -136,5 +165,5 @@ It is possible to reset the UMP state for test devices. To reset the ATT state y
 ```js
 import { AdsConsent } from 'react-native-google-mobile-ads';
 
-AdsConsent.reset()
+AdsConsent.reset();
 ```

package/docs/index.mdx

@@ -7,21 +7,21 @@ yarn add react-native-google-mobile-ads
 
 > On Android, before releasing your app, you must select _Yes, my app contains ads_ in the Google Play Store, Policy, App content, Manage under Ads.
 
-# What does it do
+## What does it do
 
 The AdMob module allows you to display adverts to your users. All adverts are served over the Google AdMob network, meaning
 a [Google AdMob account](https://apps.admob.com) is required.
 
 <YouTube id="9qCxo0D-Sak" />
 
-The module supports three types of Ads:
+The module supports four types of Ads:
 
 1. Full screen [App Open Ads](/displaying-ads#app-open-ads).
 2. Full screen [Interstitial Ads](/displaying-ads#interstitial-ads).
 3. Full screen [Rewarded Ads](/displaying-ads#rewarded-ads).
 4. Component based [Banner Ads](/displaying-ads#banner-ads).
 
-# Getting Started
+## Getting Started
 
 A number of steps must be taken and considered before you start serving adverts to your users:
 
@@ -33,7 +33,7 @@ A number of steps must be taken and considered before you start serving adverts
   - [Test ads](#test-ads)
 - [Next Steps](#next-steps)
 
-## Setting up Google AdMob
+### Setting up Google AdMob
 
 Before you are able to display ads to your users, you must have a [Google AdMob account](https://apps.admob.com). Under the
 "Apps" menu item, create or choose an existing Android/iOS app. Each app platform exposes a unique account ID which needs to
@@ -62,14 +62,14 @@ For the changes to take effect, rebuild your project:
 
 ```bash
 # For iOS
-cd ios/ && pod install
+npx pod-install
 npx react-native run-ios
 
 # For Android
 npx react-native run-android
 ```
 
-## Configure outbound requests
+### Configure outbound requests
 
 If the default ad settings are not correct for your app, you can provide settings that will apply to all ad requests.
 
@@ -94,7 +94,7 @@ mobileAds()
     tagForUnderAgeOfConsent: true,
 
     // An array of test device IDs to allow.
-    testDeviceIdentifiers: ["EMULATOR"]
+    testDeviceIdentifiers: ['EMULATOR'],
   })
   .then(() => {
     // Request config successfully set!
@@ -103,27 +103,27 @@ mobileAds()
 
 To learn more about the request configuration settings, view the [`RequestConfiguration`](/reference/admob/requestconfiguration) documentation.
 
-## Initialize the Google Mobile Ads SDK
+### Initialize the Google Mobile Ads SDK
 
 Before loading ads, have your app initialize the Google Mobile Ads SDK by calling `initialize` which initializes the SDK and returns a promise once initialization is complete (or after a 30-second timeout).
 This needs to be done only once, ideally at app launch.
 
 > ⚠️ **Warning:** Ads may be preloaded by the Mobile Ads SDK or mediation partner SDKs upon calling `initialize`.
-If you need to obtain consent from users in the European Economic Area (EEA), set any request-specific flags (such as tagForChildDirectedTreatment), or otherwise take action before loading ads, ensure you do so before initializing the Mobile Ads SDK.
+> If you need to obtain consent from users in the European Economic Area (EEA), set any request-specific flags (such as tagForChildDirectedTreatment), or otherwise take action before loading ads, ensure you do so before initializing the Mobile Ads SDK.
 
 ```js
 import mobileAds from 'react-native-google-mobile-ads';
 
 mobileAds()
   .initialize()
-  .then((adapterStatuses) => {
+  .then(adapterStatuses => {
     // Initialization complete!
   });
 ```
 
 If you are using mediation, you may wish to wait until the promise is settled before loading ads, as this will ensure that all mediation adapters are initialized.
 
-## European User Consent
+### European User Consent
 
 Out of the box, AdMob does not handle any related regulations which you may need to enforce on your application.
 It is up to the developer to implement and handle this on a user-by-user basis. You must consent to EEA users
@@ -133,7 +133,7 @@ being served both personalized and non-personalized adverts before showing them.
 The AdMob module provides a `AdsConsent` helper to help developers quickly implement consent flows within their application.
 See the [European User Consent page](/european-user-consent) for full examples of how to integrate the helper into your application.
 
-## Test ads
+### Test ads
 
 Whilst developing your app with AdMob, you'll want to make sure you use test ads rather than production ads from your
 Google AdMob account - otherwise your account may be disabled!
@@ -157,7 +157,7 @@ RewardedAd.createForAdRequest(TestIds.REWARDED);
 <BannerAd unitId={TestIds.BANNER} />
 ```
 
-# Next Steps
+## Next Steps
 
 Now the basics of setting up and configuring AdMob have been explained, we can go ahead and start to display different
 adverts to our users. The AdMob module provides integration with three different types:

package/docs/migrating-to-v5.mdx

@@ -13,13 +13,13 @@ Please refer to the following links for more information:
 
 Previously it was possible to request the ad providers and to update the consent status. This is no longer the case.
 Also, while the old Consent SDK provided information about user preferences, the new `AdsConsentStatus` only tells you if you should show the modal to a user or not.
-You can read the `IABTCF_TCString` key from standardUserDefaults / SharedPreferences and decode it with a library like [@iabtcf/core](https://github.com/InteractiveAdvertisingBureau/iabtcf-es/tree/master/modules/core#iabtcfcore) though.
 
-* `requestInfoUpdate` does now accept an optional `AdsConsentInfoOptions` object instead of expecting `publisherIds` and returns a changed `AdsConsentInfo` interface
-* `showForm` does not expect any parameters any longer and now only returns the changed `AdsConsentStatus` as part of it's `AdsConsentFormResult` interface
-* `getAdProviders`, `getStatus` and `setStatus` methods were removed without replacements
-* `addTestDevices`, `setDebugGeography` and `setTagForUnderAgeOfConsent` methods were removed, but their functionality is available via `AdsConsentInfoOptions`
-* the `user_tracking_usage_description` key is needed in your project's `app.json` if you want to handle Apple's App Tracking Transparency
+- `requestInfoUpdate` does now accept an optional `AdsConsentInfoOptions` object instead of expecting `publisherIds` and returns a changed `AdsConsentInfo` interface
+- `showForm` does not expect any parameters any longer and now only returns the changed `AdsConsentStatus` as part of it's `AdsConsentFormResult` interface
+- `getAdProviders`, `getStatus` and `setStatus` methods were removed without replacements
+- `addTestDevices`, `setDebugGeography` and `setTagForUnderAgeOfConsent` methods were removed, but their functionality is available via `AdsConsentInfoOptions`
+- the `user_tracking_usage_description` key is needed in your project's `app.json` if you want to handle Apple's App Tracking Transparency
+- newly added `getUserChoices` can be used to inspect some of the consent choices
 
 ```diff
  {
@@ -33,10 +33,10 @@ You can read the `IABTCF_TCString` key from standardUserDefaults / SharedPrefere
 
 ```diff
  import { AdsConsent, AdsConsentStatus } from 'react-native-google-mobile-ads';
- 
+
 -const consentInfo = await AdsConsent.requestInfoUpdate(['pub-6189033257628123']);
 +const consentInfo = await AdsConsent.requestInfoUpdate();
- 
+
  if (
 -  consentInfo.isRequestLocationInEeaOrUnknown &&
 +  consentInfo.isConsentFormAvailable &&
@@ -50,5 +50,14 @@ You can read the `IABTCF_TCString` key from standardUserDefaults / SharedPrefere
 -    withAdFree: true,
 -  });
 +  const formResult = await AdsConsent.showForm()
++
++  const { storeAndAccessInformationOnDevice } = await AdsConsent.getUserChoices();
++
++  if (storeAndAccessInformationOnDevice === false) {
++    /**
++     * The user declined consent for purpose 1,
++     * the Google Mobile Ads SDK won't serve ads.
++     */
++  }
  }
 ```

package/docs.json

@@ -4,8 +4,9 @@
   "sidebar": [
     ["Installation", "/"],
     ["Displaying Ads", "/displaying-ads"],
+    ["Displaying Ads via Hook", "/displaying-ads-hook"],
     ["European User Consent", "/european-user-consent"],
     ["Common Reasons For Ads Not Showing", "/common-reasons-for-ads-not-showing"],
     ["Migrating to v5", "/migrating-to-v5"]
   ]
-} 
+}

package/ios/RNGoogleMobileAds/RNGoogleMobileAdsConsentModule.m

@@ -121,4 +121,18 @@ RCT_EXPORT_METHOD(showForm : (RCTPromiseResolveBlock)resolve : (RCTPromiseReject
 
 RCT_EXPORT_METHOD(reset) { [UMPConsentInformation.sharedInstance reset]; }
 
+RCT_EXPORT_METHOD(getTCString : (RCTPromiseResolveBlock)resolve : (RCTPromiseRejectBlock)reject) {
+  @try {
+    // https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details
+    NSString *tcString = [[NSUserDefaults standardUserDefaults] objectForKey:@"IABTCF_TCString"];
+    resolve(tcString);
+  } @catch (NSError *error) {
+    [RNSharedUtils rejectPromiseWithUserInfo:reject
+                                    userInfo:[@{
+                                      @"code" : @"consent-string-error",
+                                      @"message" : error.localizedDescription,
+                                    } mutableCopy]];
+  }
+}
+
 @end

package/lib/commonjs/AdsConsent.js

@@ -5,12 +5,18 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.AdsConsent = void 0;
 
-var _common = require("./common");
+var _core = require("@iabtcf/core");
 
 var _reactNative = require("react-native");
 
 var _AdsConsentDebugGeography = require("./AdsConsentDebugGeography");
 
+var _AdsConsentPurposes = require("./AdsConsentPurposes");
+
+var _AdsConsentSpecialFeatures = require("./AdsConsentSpecialFeatures");
+
+var _common = require("./common");
+
 /*
  * Copyright (c) 2016-present Invertase Limited & Contributors
  *
@@ -29,14 +35,6 @@ var _AdsConsentDebugGeography = require("./AdsConsentDebugGeography");
  */
 const native = _reactNative.NativeModules.RNGoogleMobileAdsConsentModule;
 const AdsConsent = {
-  /**
-   *
-   * @param {Object} [options]
-   * @param {AdsConsentDebugGeography} [options.debugGeography]
-   * @param {Boolean} [options.tagForUnderAgeOfConsent]
-   * @param {Array<String>} [options.testDeviceIdentifiers]
-   * @returns {{ status: Number, isConsentFormAvailable: Boolean }}
-   */
   requestInfoUpdate() {
     let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
 
@@ -69,19 +67,52 @@ const AdsConsent = {
     return native.requestInfoUpdate(options);
   },
 
-  /**
-   *
-   * @returns {{ status: Number }}
-   */
   showForm() {
     return native.showForm();
   },
 
-  /**
-   *
-   */
   reset() {
     return native.reset();
+  },
+
+  getTCString() {
+    return native.getTCString();
+  },
+
+  async getTCModel() {
+    const tcString = await native.getTCString();
+    return _core.TCString.decode(tcString);
+  },
+
+  async getUserChoices() {
+    const tcString = await native.getTCString();
+    let tcModel;
+
+    try {
+      tcModel = _core.TCString.decode(tcString);
+    } catch (e) {
+      tcModel = new _core.TCModel();
+
+      if (__DEV__) {
+        // eslint-disable-next-line no-console
+        console.warn(`Failed to decode tcString ${tcString}:`, e);
+      }
+    }
+
+    return {
+      activelyScanDeviceCharacteristicsForIdentification: tcModel.specialFeatureOptins.has(_AdsConsentSpecialFeatures.AdsConsentSpecialFeatures.ACTIVELY_SCAN_DEVICE_CHARACTERISTICS_FOR_IDENTIFICATION),
+      applyMarketResearchToGenerateAudienceInsights: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS),
+      createAPersonalisedAdsProfile: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.CREATE_A_PERSONALISED_ADS_PROFILE),
+      createAPersonalisedContentProfile: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.CREATE_A_PERSONALISED_ADS_PROFILE),
+      developAndImproveProducts: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.DEVELOP_AND_IMPROVE_PRODUCTS),
+      measureAdPerformance: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.MEASURE_AD_PERFORMANCE),
+      measureContentPerformance: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.MEASURE_CONTENT_PERFORMANCE),
+      selectBasicAds: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.SELECT_BASIC_ADS),
+      selectPersonalisedAds: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.SELECT_PERSONALISED_ADS),
+      selectPersonalisedContent: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.SELECT_PERSONALISED_CONTENT),
+      storeAndAccessInformationOnDevice: tcModel.purposeConsents.has(_AdsConsentPurposes.AdsConsentPurposes.STORE_AND_ACCESS_INFORMATION_ON_DEVICE),
+      usePreciseGeolocationData: tcModel.specialFeatureOptins.has(_AdsConsentSpecialFeatures.AdsConsentSpecialFeatures.USE_PRECISE_GEOLOCATION_DATA)
+    };
   }
 
 };