react-native-google-mobile-ads 5.0.1 → 5.1.0

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/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

@@ -14,7 +14,7 @@ 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).
@@ -94,7 +94,7 @@ mobileAds()
     tagForUnderAgeOfConsent: true,
 
     // An array of test device IDs to allow.
-    testDeviceIdentifiers: ["EMULATOR"]
+    testDeviceIdentifiers: ['EMULATOR'],
   })
   .then(() => {
     // Request config successfully set!
@@ -109,14 +109,14 @@ Before loading ads, have your app initialize the Google Mobile Ads SDK by callin
 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!
   });
 ```

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)
+    };
   }
 
 };

package/lib/commonjs/AdsConsent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["AdsConsent.ts"],"names":["native","NativeModules","RNGoogleMobileAdsConsentModule","AdsConsent","requestInfoUpdate","options","Error","debugGeography","AdsConsentDebugGeography","DISABLED","EEA","NOT_EEA","tagForUnderAgeOfConsent","testDeviceIdentifiers","deviceId","showForm","reset"],"mappings":";;;;;;;AAiBA;;AACA;;AACA;;AAnBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAOA,MAAMA,MAAM,GAAGC,2BAAcC,8BAA7B;AAEO,MAAMC,UAA+B,GAAG;AAC7C;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,iBAAiB,GAAe;AAAA,QAAdC,OAAc,uEAAJ,EAAI;;AAC9B,QAAI,CAAC,sBAASA,OAAT,CAAL,EAAwB;AACtB,YAAM,IAAIC,KAAJ,CAAU,qEAAV,CAAN;AACD;;AAED,QACE,4BAAeD,OAAf,EAAwB,gBAAxB,KACAA,OAAO,CAACE,cAAR,KAA2BC,mDAAyBC,QADpD,IAEAJ,OAAO,CAACE,cAAR,KAA2BC,mDAAyBE,GAFpD,IAGAL,OAAO,CAACE,cAAR,KAA2BC,mDAAyBG,OAJtD,EAKE;AACA,YAAM,IAAIL,KAAJ,CACJ,+KADI,CAAN;AAGD;;AAED,QACE,4BAAeD,OAAf,EAAwB,yBAAxB,KACA,CAAC,uBAAUA,OAAO,CAACO,uBAAlB,CAFH,EAGE;AACA,YAAM,IAAIN,KAAJ,CACJ,6FADI,CAAN;AAGD;;AAED,QAAI,4BAAeD,OAAf,EAAwB,uBAAxB,CAAJ,EAAsD;AACpD,UAAI,CAAC,qBAAQA,OAAO,CAACQ,qBAAhB,CAAL,EAA6C;AAC3C,cAAM,IAAIP,KAAJ,CACJ,qGADI,CAAN;AAGD;;AAED,WAAK,MAAMQ,QAAX,6BAAuBT,OAAO,CAACQ,qBAA/B,yEAAwD,EAAxD,EAA4D;AAAA;;AAC1D,YAAI,CAAC,sBAASC,QAAT,CAAL,EAAyB;AACvB,gBAAM,IAAIR,KAAJ,CACJ,qGADI,CAAN;AAGD;AACF;AACF;;AAED,WAAON,MAAM,CAACI,iBAAP,CAAyBC,OAAzB,CAAP;AACD,GAnD4C;;AAqD7C;AACF;AACA;AACA;AACEU,EAAAA,QAAQ,GAAG;AACT,WAAOf,MAAM,CAACe,QAAP,EAAP;AACD,GA3D4C;;AA6D7C;AACF;AACA;AACEC,EAAAA,KAAK,GAAG;AACN,WAAOhB,MAAM,CAACgB,KAAP,EAAP;AACD;;AAlE4C,CAAxC","sourcesContent":["/*\n * Copyright (c) 2016-present Invertase Limited & Contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this library except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n */\n\nimport { hasOwnProperty, isArray, isBoolean, isObject, isString } from './common';\nimport { NativeModules } from 'react-native';\nimport { AdsConsentDebugGeography } from './AdsConsentDebugGeography';\nimport { AdsConsentInterface } from './types/AdsConsent.interface';\n\nconst native = NativeModules.RNGoogleMobileAdsConsentModule;\n\nexport const AdsConsent: AdsConsentInterface = {\n  /**\n   *\n   * @param {Object} [options]\n   * @param {AdsConsentDebugGeography} [options.debugGeography]\n   * @param {Boolean} [options.tagForUnderAgeOfConsent]\n   * @param {Array<String>} [options.testDeviceIdentifiers]\n   * @returns {{ status: Number, isConsentFormAvailable: Boolean }}\n   */\n  requestInfoUpdate(options = {}) {\n    if (!isObject(options)) {\n      throw new Error(\"AdsConsent.requestInfoUpdate(*) 'options' expected an object value.\");\n    }\n\n    if (\n      hasOwnProperty(options, 'debugGeography') &&\n      options.debugGeography !== AdsConsentDebugGeography.DISABLED &&\n      options.debugGeography !== AdsConsentDebugGeography.EEA &&\n      options.debugGeography !== AdsConsentDebugGeography.NOT_EEA\n    ) {\n      throw new Error(\n        \"AdsConsent.requestInfoUpdate(*) 'options.debugGeography' expected one of AdsConsentDebugGeography.DISABLED, AdsConsentDebugGeography.EEA or AdsConsentDebugGeography.NOT_EEA.\",\n      );\n    }\n\n    if (\n      hasOwnProperty(options, 'tagForUnderAgeOfConsent') &&\n      !isBoolean(options.tagForUnderAgeOfConsent)\n    ) {\n      throw new Error(\n        \"AdsConsent.requestInfoUpdate(*) 'options.tagForUnderAgeOfConsent' expected a boolean value.\",\n      );\n    }\n\n    if (hasOwnProperty(options, 'testDeviceIdentifiers')) {\n      if (!isArray(options.testDeviceIdentifiers)) {\n        throw new Error(\n          \"AdsConsent.requestInfoUpdate(*) 'options.testDeviceIdentifiers' expected an array of string values.\",\n        );\n      }\n\n      for (const deviceId of options.testDeviceIdentifiers ?? []) {\n        if (!isString(deviceId)) {\n          throw new Error(\n            \"AdsConsent.requestInfoUpdate(*) 'options.testDeviceIdentifiers' expected an array of string values.\",\n          );\n        }\n      }\n    }\n\n    return native.requestInfoUpdate(options);\n  },\n\n  /**\n   *\n   * @returns {{ status: Number }}\n   */\n  showForm() {\n    return native.showForm();\n  },\n\n  /**\n   *\n   */\n  reset() {\n    return native.reset();\n  },\n};\n"]}
+{"version":3,"sources":["AdsConsent.ts"],"names":["native","NativeModules","RNGoogleMobileAdsConsentModule","AdsConsent","requestInfoUpdate","options","Error","debugGeography","AdsConsentDebugGeography","DISABLED","EEA","NOT_EEA","tagForUnderAgeOfConsent","testDeviceIdentifiers","deviceId","showForm","reset","getTCString","getTCModel","tcString","TCString","decode","getUserChoices","tcModel","e","TCModel","__DEV__","console","warn","activelyScanDeviceCharacteristicsForIdentification","specialFeatureOptins","has","AdsConsentSpecialFeatures","ACTIVELY_SCAN_DEVICE_CHARACTERISTICS_FOR_IDENTIFICATION","applyMarketResearchToGenerateAudienceInsights","purposeConsents","AdsConsentPurposes","APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS","createAPersonalisedAdsProfile","CREATE_A_PERSONALISED_ADS_PROFILE","createAPersonalisedContentProfile","developAndImproveProducts","DEVELOP_AND_IMPROVE_PRODUCTS","measureAdPerformance","MEASURE_AD_PERFORMANCE","measureContentPerformance","MEASURE_CONTENT_PERFORMANCE","selectBasicAds","SELECT_BASIC_ADS","selectPersonalisedAds","SELECT_PERSONALISED_ADS","selectPersonalisedContent","SELECT_PERSONALISED_CONTENT","storeAndAccessInformationOnDevice","STORE_AND_ACCESS_INFORMATION_ON_DEVICE","usePreciseGeolocationData","USE_PRECISE_GEOLOCATION_DATA"],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2016-present Invertase Limited & Contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this library except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n */\n\nimport { TCModel, TCString } from '@iabtcf/core';\nimport { NativeModules } from 'react-native';\nimport { AdsConsentDebugGeography } from './AdsConsentDebugGeography';\nimport { AdsConsentPurposes } from './AdsConsentPurposes';\nimport { AdsConsentSpecialFeatures } from './AdsConsentSpecialFeatures';\nimport { hasOwnProperty, isArray, isBoolean, isObject, isString } from './common';\nimport {\n  AdsConsentFormResult,\n  AdsConsentInfo,\n  AdsConsentInfoOptions,\n  AdsConsentInterface,\n  AdsConsentUserChoices,\n} from './types/AdsConsent.interface';\n\nconst native = NativeModules.RNGoogleMobileAdsConsentModule;\n\nexport const AdsConsent: AdsConsentInterface = {\n  requestInfoUpdate(options: AdsConsentInfoOptions = {}): Promise<AdsConsentInfo> {\n    if (!isObject(options)) {\n      throw new Error(\"AdsConsent.requestInfoUpdate(*) 'options' expected an object value.\");\n    }\n\n    if (\n      hasOwnProperty(options, 'debugGeography') &&\n      options.debugGeography !== AdsConsentDebugGeography.DISABLED &&\n      options.debugGeography !== AdsConsentDebugGeography.EEA &&\n      options.debugGeography !== AdsConsentDebugGeography.NOT_EEA\n    ) {\n      throw new Error(\n        \"AdsConsent.requestInfoUpdate(*) 'options.debugGeography' expected one of AdsConsentDebugGeography.DISABLED, AdsConsentDebugGeography.EEA or AdsConsentDebugGeography.NOT_EEA.\",\n      );\n    }\n\n    if (\n      hasOwnProperty(options, 'tagForUnderAgeOfConsent') &&\n      !isBoolean(options.tagForUnderAgeOfConsent)\n    ) {\n      throw new Error(\n        \"AdsConsent.requestInfoUpdate(*) 'options.tagForUnderAgeOfConsent' expected a boolean value.\",\n      );\n    }\n\n    if (hasOwnProperty(options, 'testDeviceIdentifiers')) {\n      if (!isArray(options.testDeviceIdentifiers)) {\n        throw new Error(\n          \"AdsConsent.requestInfoUpdate(*) 'options.testDeviceIdentifiers' expected an array of string values.\",\n        );\n      }\n\n      for (const deviceId of options.testDeviceIdentifiers ?? []) {\n        if (!isString(deviceId)) {\n          throw new Error(\n            \"AdsConsent.requestInfoUpdate(*) 'options.testDeviceIdentifiers' expected an array of string values.\",\n          );\n        }\n      }\n    }\n\n    return native.requestInfoUpdate(options);\n  },\n\n  showForm(): Promise<AdsConsentFormResult> {\n    return native.showForm();\n  },\n\n  reset(): void {\n    return native.reset();\n  },\n\n  getTCString(): Promise<string> {\n    return native.getTCString();\n  },\n\n  async getTCModel(): Promise<TCModel> {\n    const tcString = await native.getTCString();\n    return TCString.decode(tcString);\n  },\n\n  async getUserChoices(): Promise<AdsConsentUserChoices> {\n    const tcString = await native.getTCString();\n\n    let tcModel: TCModel;\n\n    try {\n      tcModel = TCString.decode(tcString);\n    } catch (e) {\n      tcModel = new TCModel();\n\n      if (__DEV__) {\n        // eslint-disable-next-line no-console\n        console.warn(`Failed to decode tcString ${tcString}:`, e);\n      }\n    }\n\n    return {\n      activelyScanDeviceCharacteristicsForIdentification: tcModel.specialFeatureOptins.has(\n        AdsConsentSpecialFeatures.ACTIVELY_SCAN_DEVICE_CHARACTERISTICS_FOR_IDENTIFICATION,\n      ),\n      applyMarketResearchToGenerateAudienceInsights: tcModel.purposeConsents.has(\n        AdsConsentPurposes.APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS,\n      ),\n      createAPersonalisedAdsProfile: tcModel.purposeConsents.has(\n        AdsConsentPurposes.CREATE_A_PERSONALISED_ADS_PROFILE,\n      ),\n      createAPersonalisedContentProfile: tcModel.purposeConsents.has(\n        AdsConsentPurposes.CREATE_A_PERSONALISED_ADS_PROFILE,\n      ),\n      developAndImproveProducts: tcModel.purposeConsents.has(\n        AdsConsentPurposes.DEVELOP_AND_IMPROVE_PRODUCTS,\n      ),\n      measureAdPerformance: tcModel.purposeConsents.has(AdsConsentPurposes.MEASURE_AD_PERFORMANCE),\n      measureContentPerformance: tcModel.purposeConsents.has(\n        AdsConsentPurposes.MEASURE_CONTENT_PERFORMANCE,\n      ),\n      selectBasicAds: tcModel.purposeConsents.has(AdsConsentPurposes.SELECT_BASIC_ADS),\n      selectPersonalisedAds: tcModel.purposeConsents.has(\n        AdsConsentPurposes.SELECT_PERSONALISED_ADS,\n      ),\n      selectPersonalisedContent: tcModel.purposeConsents.has(\n        AdsConsentPurposes.SELECT_PERSONALISED_CONTENT,\n      ),\n      storeAndAccessInformationOnDevice: tcModel.purposeConsents.has(\n        AdsConsentPurposes.STORE_AND_ACCESS_INFORMATION_ON_DEVICE,\n      ),\n      usePreciseGeolocationData: tcModel.specialFeatureOptins.has(\n        AdsConsentSpecialFeatures.USE_PRECISE_GEOLOCATION_DATA,\n      ),\n    };\n  },\n};\n"]}

package/lib/commonjs/AdsConsentPurposes.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AdsConsentPurposes = void 0;
+
+/*
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *
+ *
+ *
+ * The definitions in this document are copied from IAB's global vendor list.
+ *
+ *   https://vendor-list.consensu.org/v2/vendor-list.json
+ *   https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework
+ *
+ */
+let AdsConsentPurposes;
+exports.AdsConsentPurposes = AdsConsentPurposes;
+
+(function (AdsConsentPurposes) {
+  AdsConsentPurposes[AdsConsentPurposes["STORE_AND_ACCESS_INFORMATION_ON_DEVICE"] = 1] = "STORE_AND_ACCESS_INFORMATION_ON_DEVICE";
+  AdsConsentPurposes[AdsConsentPurposes["SELECT_BASIC_ADS"] = 2] = "SELECT_BASIC_ADS";
+  AdsConsentPurposes[AdsConsentPurposes["CREATE_A_PERSONALISED_ADS_PROFILE"] = 3] = "CREATE_A_PERSONALISED_ADS_PROFILE";
+  AdsConsentPurposes[AdsConsentPurposes["SELECT_PERSONALISED_ADS"] = 4] = "SELECT_PERSONALISED_ADS";
+  AdsConsentPurposes[AdsConsentPurposes["CREATE_A_PERSONALISED_CONTENT_PROFILE"] = 5] = "CREATE_A_PERSONALISED_CONTENT_PROFILE";
+  AdsConsentPurposes[AdsConsentPurposes["SELECT_PERSONALISED_CONTENT"] = 6] = "SELECT_PERSONALISED_CONTENT";
+  AdsConsentPurposes[AdsConsentPurposes["MEASURE_AD_PERFORMANCE"] = 7] = "MEASURE_AD_PERFORMANCE";
+  AdsConsentPurposes[AdsConsentPurposes["MEASURE_CONTENT_PERFORMANCE"] = 8] = "MEASURE_CONTENT_PERFORMANCE";
+  AdsConsentPurposes[AdsConsentPurposes["APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS"] = 9] = "APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS";
+  AdsConsentPurposes[AdsConsentPurposes["DEVELOP_AND_IMPROVE_PRODUCTS"] = 10] = "DEVELOP_AND_IMPROVE_PRODUCTS";
+})(AdsConsentPurposes || (exports.AdsConsentPurposes = AdsConsentPurposes = {}));
+//# sourceMappingURL=AdsConsentPurposes.js.map

package/lib/commonjs/AdsConsentPurposes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["AdsConsentPurposes.ts"],"names":["AdsConsentPurposes"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IAEYA,kB;;;WAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;AAAAA,EAAAA,kB,CAAAA,kB;GAAAA,kB,kCAAAA,kB","sourcesContent":["/*\n * Copyright (c) 2016-present Invertase Limited & Contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this library except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n *\n *\n *\n * The definitions in this document are copied from IAB's global vendor list.\n *\n *   https://vendor-list.consensu.org/v2/vendor-list.json\n *   https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework\n *\n */\n\nexport enum AdsConsentPurposes {\n  /**\n   * Cookies, device identifiers, or other information can be stored or\n   * accessed on your device for the purposes presented to you.\n   *\n   * Vendors can:\n   *   - Store and access information on the device such as cookies\n   *     and device identifiers presented to a user.\n   */\n  STORE_AND_ACCESS_INFORMATION_ON_DEVICE = 1,\n\n  /**\n   * Ads can be shown to you based on the content you’re viewing,\n   * the app you’re using, your approximate location, or your device type.\n   *\n   * To do basic ad selection vendors can:\n   *  - Use real-time information about the context in which the ad will be shown,\n   *    to show the ad, including information about the content and the device, such as:\n   *    device type and capabilities, user agent, URL, IP address\n   *  - Use a user’s non-precise geolocation data\n   *  - Control the frequency of ads shown to a user.\n   *  - Sequence the order in which ads are shown to a user.\n   *  - Prevent an ad from serving in an unsuitable editorial (brand-unsafe) context\n   *\n   * Vendors cannot:\n   *  - Create a personalised ads profile using this information for the selection of\n   *    future ads without a separate legal basis to create a personalised ads profile.\n   *  - N.B. Non-precise means only an approximate location involving at least a radius\n   *    of 500 meters is permitted.\n   */\n  SELECT_BASIC_ADS = 2,\n\n  /**\n   * A profile can be built about you and your interests to show you personalised ads\n   * that are relevant to you.\n   *\n   * To create a personalised ads profile vendors can:\n   *   - Collect information about a user, including a user's activity, interests,\n   *     demographic information, or location, to create or edit a user profile for use\n   *     in personalised advertising.\n   *   - Combine this information with other information previously collected,\n   *     including from across websites and apps, to create or edit a user profile\n   *     for use in personalised advertising.\n   */\n  CREATE_A_PERSONALISED_ADS_PROFILE = 3,\n\n  /**\n   * Personalised ads can be shown to you based on a profile about you.\n   *\n   * To select personalised ads vendors can:\n   *   - Select personalised ads based on a user profile or other historical user data,\n   *     including a user’s prior activity, interests, visits to sites or apps, location,\n   *     or demographic information.\n   */\n  SELECT_PERSONALISED_ADS = 4,\n\n  /**\n   * A profile can be built about you and your interests to show you personalised content\n   * that is relevant to you.\n   *\n   * To create a personalised content profile vendors can:\n   *   - Collect information about a user, including a user's activity, interests, visits to\n   *     sites or apps, demographic information, or location, to create or edit a user profile\n   *     for personalising content.\n   *   - Combine this information with other information previously collected,\n   *     including from across websites and apps, to create or edit a user profile for use\n   *     in personalising content.\n   */\n  CREATE_A_PERSONALISED_CONTENT_PROFILE = 5,\n\n  /**\n   * Personalised content can be shown to you based on a profile about you.\n   *\n   * To select personalised content vendors can:\n   *   - Select personalised content based on a user profile or other historical user data,\n   *     including a user’s prior activity, interests, visits to sites or apps, location,\n   *     or demographic information.\n   */\n  SELECT_PERSONALISED_CONTENT = 6,\n\n  /**\n   * The performance and effectiveness of ads that you see or interact with can be measured.\n   *\n   * To measure ad performance vendors can:\n   *   - Measure whether and how ads were delivered to and interacted with by a user\n   *   - Provide reporting about ads including their effectiveness and performance\n   *   - Provide reporting about users who interacted with ads using data observed during\n   *     the course of the user's interaction with that ad\n   *   - Provide reporting to publishers about the ads displayed on their property\n   *   - Measure whether an ad is serving in a suitable editorial environment (brand-safe) context\n   *   - Determine the percentage of the ad that had the opportunity to be seen and\n   *     the duration of that opportunity\n   *   - Combine this information with other information previously collected,\n   *     including from across websites and apps\n   *\n   * Vendors cannot:\n   *   - Apply panel- or similarly-derived audience insights data to ad measurement data\n   *     without a Legal Basis to apply market research to generate audience insights (Purpose 9)\n   */\n  MEASURE_AD_PERFORMANCE = 7,\n\n  /**\n   * The performance and effectiveness of content that you see or interact with can be measured.\n   *\n   * To measure content performance vendors can:\n   *   - Measure and report on how content was delivered to and interacted with by users.\n   *   - Provide reporting, using directly measurable or known information, about users who\n   *     interacted with the content\n   *   - Combine this information with other information previously collected,\n   *     including from across websites and apps.\n   *\n   * Vendors cannot:\n   *   - Measure whether and how ads (including native ads) were delivered to and\n   *     interacted with by a user.\n   *   - Apply panel- or similarly derived audience insights data to ad measurement\n   *     data without a Legal Basis to apply market research to generate audience insights (Purpose 9)\n   */\n  MEASURE_CONTENT_PERFORMANCE = 8,\n\n  /**\n   * Market research can be used to learn more about the audiences who visit sites/apps and view ads.\n   *\n   * To apply market research to generate audience insights vendors can:\n   *   - Provide aggregate reporting to advertisers or their representatives about\n   *     the audiences reached by their ads, through panel-based and similarly derived insights.\n   *   - Provide aggregate reporting to publishers about the audiences that were served or\n   *     interacted with content and/or ads on their property by applying\n   *     panel-based and similarly derived insights.\n   *   - Associate offline data with an online user for the purposes of\n   *     market research to generate audience insights if vendors have declared to match and\n   *     combine offline data sources (Feature 1)\n   *   - Combine this information with other information previously collected including from\n   *     across websites and apps.\n   *\n   * Vendors cannot:\n   *   - Measure the performance and effectiveness of ads that a specific user was served or\n   *     interacted with, without a Legal Basis to measure ad performance.\n   *   - Measure which content a specific user was served and how they interacted with it,\n   *     without a Legal Basis to measure content performance.\n   */\n  APPLY_MARKET_RESEARCH_TO_GENERATE_AUDIENCE_INSIGHTS = 9,\n\n  /**\n   * Your data can be used to improve existing systems and software,\n   * and to develop new products\n   *\n   * To develop new products and improve products vendors can:\n   *   - Use information to improve their existing products with new features and\n   *     to develop new products\n   *   - Create new models and algorithms through machine learning\n   *\n   * Vendors cannot:\n   *   - Conduct any other data processing operation allowed under\n   *     a different purpose under this purpose\n   */\n  DEVELOP_AND_IMPROVE_PRODUCTS = 10,\n}\n"]}