@javascriptcommon/react-native-google-mobile-ads 16.3.3

package/plugin/__tests__/fixtures/app.config.js

@@ -0,0 +1,24 @@
+module.exports = {
+  name: 'example',
+  slug: 'example',
+  android: {
+    package: 'com.example',
+  },
+  ios: {
+    bundleIdentifier: 'com.example',
+  },
+  plugins: [
+    [
+      '../../build',
+      {
+        androidAppId: 'TestAppId',
+        iosAppId: 'TestIosId',
+        delayAppMeasurementInit: true,
+        optimizeInitialization: true,
+        optimizeAdLoading: true,
+        skAdNetworkItems: ['TestSkAdNetworkItem1', 'TestSkAdNetworkItem2'],
+        userTrackingUsageDescription: 'TestUserTrackingUsageDescription',
+      },
+    ],
+  ],
+};

package/plugin/__tests__/fixtures/app.config.ts

@@ -0,0 +1,24 @@
+export default {
+  name: 'example',
+  slug: 'example',
+  android: {
+    package: 'com.example',
+  },
+  ios: {
+    bundleIdentifier: 'com.example',
+  },
+  plugins: [
+    [
+      '../../build',
+      {
+        androidAppId: 'TestAppId',
+        iosAppId: 'TestIosId',
+        delayAppMeasurementInit: true,
+        optimizeInitialization: true,
+        optimizeAdLoading: true,
+        skAdNetworkItems: ['TestSkAdNetworkItem1', 'TestSkAdNetworkItem2'],
+        userTrackingUsageDescription: 'TestUserTrackingUsageDescription',
+      },
+    ],
+  ],
+};

package/plugin/__tests__/fixtures/app.json

@@ -0,0 +1,24 @@
+{
+  "name": "example",
+  "slug": "example",
+  "android": {
+    "package": "com.example"
+  },
+  "ios": {
+    "bundleIdentifier": "com.example"
+  },
+  "plugins": [
+    [
+      "../../build",
+      {
+        "androidAppId": "TestAppId",
+        "iosAppId": "TestIosId",
+        "delayAppMeasurementInit": true,
+        "optimizeInitialization": true,
+        "optimizeAdLoading": true,
+        "skAdNetworkItems": ["TestSkAdNetworkItem1", "TestSkAdNetworkItem2"],
+        "userTrackingUsageDescription": "TestUserTrackingUsageDescription"
+      }
+    ]
+  ]
+}

package/plugin/__tests__/fixtures/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "example",
+  "version": "1.0.0",
+  "scripts": {
+    "start": "expo start --dev-client",
+    "android": "expo run:android",
+    "ios": "expo run:ios"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.12.9"
+  },
+  "dependencies": {
+    "expo": "~47.0.14",
+    "expo-splash-screen": "~0.17.5",
+    "expo-status-bar": "~1.4.2",
+    "react": "18.1.0",
+    "react-native": "0.70.8"
+  }
+}

package/plugin/__tests__/fixtures/without-params/app.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+  name: 'example',
+  slug: 'example',
+  android: {
+    package: 'com.example',
+  },
+  ios: {
+    bundleIdentifier: 'com.example',
+  },
+  plugins: [['../../build']],
+};

package/plugin/__tests__/fixtures/without-params/app.config.ts

@@ -0,0 +1,11 @@
+export default {
+  name: 'example',
+  slug: 'example',
+  android: {
+    package: 'com.example',
+  },
+  ios: {
+    bundleIdentifier: 'com.example',
+  },
+  plugins: [['../../build']],
+};

package/plugin/__tests__/fixtures/without-params/app.json

@@ -0,0 +1,11 @@
+{
+  "name": "example",
+  "slug": "example",
+  "android": {
+    "package": "com.example"
+  },
+  "ios": {
+    "bundleIdentifier": "com.example"
+  },
+  "plugins": [["../../build"]]
+}

package/plugin/__tests__/plugin.test.ts

@@ -0,0 +1,115 @@
+import { exec } from 'child_process';
+import path from 'path';
+import fs from 'fs/promises';
+import util from 'util';
+
+const execAsync = util.promisify(exec);
+
+describe.each(['app.json', 'app.config.js', 'app.config.ts'])('Expo Config Plugin Tests', expoConfigFileName => {
+  const fixturesPath = path.join(__dirname, 'fixtures');
+  const testAppPath = path.join(__dirname, 'build');
+  const infoPlistPath = path.join(testAppPath, 'ios', 'example', 'Info.plist');
+  const androidManifestPath = path.join(
+    testAppPath,
+    'android',
+    'app',
+    'src',
+    'main',
+    'AndroidManifest.xml',
+  );
+
+  beforeEach(async () => {
+    await fs.rm(testAppPath, { recursive: true, force: true });
+    await fs.mkdir(testAppPath);
+    await fs.copyFile(
+      path.join(fixturesPath, expoConfigFileName),
+      path.join(testAppPath, expoConfigFileName),
+    );
+    await fs.copyFile(
+      path.join(fixturesPath, 'package.json'),
+      path.join(testAppPath, 'package.json'),
+    );
+  });
+
+  it('Technically requires no parameters', async () => {
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+  });
+
+  it('Warns about missing androidAppId', async () => {
+    await fs.copyFile(
+      path.join(fixturesPath, "without-params", expoConfigFileName),
+      path.join(testAppPath, expoConfigFileName),
+    );
+
+    const { stderr } = await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+    expect(stderr).toMatch(/No 'androidAppId' was provided/);
+  });
+
+  it('Warns about missing iosAppId', async () => {
+    await fs.copyFile(
+      path.join(fixturesPath, "without-params", expoConfigFileName),
+      path.join(testAppPath, expoConfigFileName),
+    );
+
+    const { stderr } = await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+    expect(stderr).toMatch(/No 'iosAppId' was provided/);
+  });
+
+  it('Optimizes initialization on Android by default', async () => {
+    await fs.copyFile(
+      path.join(fixturesPath, "without-params", expoConfigFileName),
+      path.join(testAppPath, expoConfigFileName),
+    );
+
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const androidManifest = await fs.readFile(androidManifestPath, 'utf8');
+    expect(androidManifest).toContain(
+      '<meta-data android:name="com.google.android.gms.ads.flag.OPTIMIZE_INITIALIZATION" android:value="true" tools:replace="android:value"/>',
+    );
+  });
+
+  it('Optimizes ad loading on Android by default', async () => {
+    await fs.copyFile(
+      path.join(fixturesPath, "without-params", expoConfigFileName),
+      path.join(testAppPath, expoConfigFileName),
+    );
+
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const androidManifest = await fs.readFile(androidManifestPath, 'utf8');
+    expect(androidManifest).toContain(
+      '<meta-data android:name="com.google.android.gms.ads.flag.OPTIMIZE_AD_LOADING" android:value="true" tools:replace="android:value"/>',
+    );
+  });
+
+  it('Should modify AndroidManifest.xml', async () => {
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const androidManifest = await fs.readFile(androidManifestPath, 'utf8');
+    expect(androidManifest).toMatchSnapshot();
+  });
+
+  it('Should modify AndroidManifest.xml idempotently', async () => {
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const androidManifest = await fs.readFile(androidManifestPath, 'utf8');
+    expect(androidManifest).toMatchSnapshot();
+  });
+
+  it('Should modify Info.plist', async () => {
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const infoPlist = await fs.readFile(infoPlistPath, 'utf8');
+    expect(infoPlist).toMatchSnapshot();
+  });
+
+  it('Should modify Info.plist idempotently', async () => {
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+    await execAsync(`yarn expo prebuild --no-install ${testAppPath}`);
+
+    const infoPlist = await fs.readFile(infoPlistPath, 'utf8');
+    expect(infoPlist).toMatchSnapshot();
+  });
+});

package/plugin/build/index.d.ts

@@ -0,0 +1,12 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+type PluginParameters = {
+    androidAppId?: string;
+    iosAppId?: string;
+    delayAppMeasurementInit?: boolean;
+    optimizeInitialization?: boolean;
+    optimizeAdLoading?: boolean;
+    skAdNetworkItems?: string[];
+    userTrackingUsageDescription?: string;
+};
+declare const withReactNativeGoogleMobileAds: ConfigPlugin<PluginParameters>;
+export default withReactNativeGoogleMobileAds;

package/plugin/build/index.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+function addReplacingMainApplicationMetaDataItem(manifest, itemName, itemValue) {
+    config_plugins_1.AndroidConfig.Manifest.ensureToolsAvailable(manifest);
+    const newItem = {
+        $: {
+            'android:name': itemName,
+            'android:value': itemValue,
+            'tools:replace': 'android:value',
+        },
+    };
+    const mainApplication = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(manifest);
+    mainApplication['meta-data'] = mainApplication['meta-data'] ?? [];
+    const existingItem = mainApplication['meta-data'].find(item => item.$['android:name'] === itemName);
+    if (existingItem) {
+        existingItem.$['android:value'] = itemValue;
+        existingItem.$['tools:replace'] =
+            'android:value';
+    }
+    else {
+        mainApplication['meta-data'].push(newItem);
+    }
+    return manifest;
+}
+const withAndroidAppId = (config, androidAppId) => {
+    if (androidAppId === undefined)
+        return config;
+    return (0, config_plugins_1.withAndroidManifest)(config, config => {
+        addReplacingMainApplicationMetaDataItem(config.modResults, 'com.google.android.gms.ads.APPLICATION_ID', androidAppId);
+        return config;
+    });
+};
+const withAndroidAppMeasurementInitDelayed = (config, delayAppMeasurementInit) => {
+    if (delayAppMeasurementInit === undefined)
+        return config;
+    return (0, config_plugins_1.withAndroidManifest)(config, config => {
+        addReplacingMainApplicationMetaDataItem(config.modResults, 'com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT', delayAppMeasurementInit.toString());
+        return config;
+    });
+};
+const withAndroidInitializationOptimized = (config, optimizeInitialization = true) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, config => {
+        addReplacingMainApplicationMetaDataItem(config.modResults, 'com.google.android.gms.ads.flag.OPTIMIZE_INITIALIZATION', optimizeInitialization.toString());
+        return config;
+    });
+};
+const withAndroidAdLoadingOptimized = (config, optimizeAdLoading = true) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, config => {
+        addReplacingMainApplicationMetaDataItem(config.modResults, 'com.google.android.gms.ads.flag.OPTIMIZE_AD_LOADING', optimizeAdLoading.toString());
+        return config;
+    });
+};
+const withIosAppId = (config, iosAppId) => {
+    if (iosAppId === undefined)
+        return config;
+    return (0, config_plugins_1.withInfoPlist)(config, config => {
+        config.modResults.GADApplicationIdentifier = iosAppId;
+        return config;
+    });
+};
+const withIosAppMeasurementInitDelayed = (config, delayAppMeasurementInit = false) => {
+    return (0, config_plugins_1.withInfoPlist)(config, config => {
+        config.modResults.GADDelayAppMeasurementInit = delayAppMeasurementInit;
+        return config;
+    });
+};
+const withIosSkAdNetworkItems = (config, skAdNetworkItems) => {
+    if (skAdNetworkItems === undefined)
+        return config;
+    return (0, config_plugins_1.withInfoPlist)(config, config => {
+        config.modResults.SKAdNetworkItems = config.modResults.SKAdNetworkItems ?? [];
+        const existingIdentifiers = config.modResults.SKAdNetworkItems.map((item) => item.SKAdNetworkIdentifier);
+        const missingIdentifiers = skAdNetworkItems.filter(skAdNetworkItem => !existingIdentifiers.includes(skAdNetworkItem));
+        config.modResults.SKAdNetworkItems.push(...missingIdentifiers.map(identifier => ({
+            SKAdNetworkIdentifier: identifier,
+        })));
+        return config;
+    });
+};
+const withIosUserTrackingUsageDescription = (config, userTrackingUsageDescription) => {
+    if (userTrackingUsageDescription === undefined)
+        return config;
+    return (0, config_plugins_1.withInfoPlist)(config, config => {
+        config.modResults.NSUserTrackingUsageDescription = userTrackingUsageDescription;
+        return config;
+    });
+};
+const withReactNativeGoogleMobileAds = (config, { androidAppId, delayAppMeasurementInit, optimizeInitialization, optimizeAdLoading, iosAppId, skAdNetworkItems, userTrackingUsageDescription, } = {}) => {
+    if (androidAppId === undefined) {
+        console.warn("No 'androidAppId' was provided. The native Google Mobile Ads SDK will crash on Android without it.");
+    }
+    if (iosAppId === undefined) {
+        console.warn("No 'iosAppId' was provided. The native Google Mobile Ads SDK will crash on iOS without it.");
+    }
+    return (0, config_plugins_1.withPlugins)(config, [
+        // Android
+        [withAndroidAppId, androidAppId],
+        [withAndroidAppMeasurementInitDelayed, delayAppMeasurementInit],
+        [withAndroidInitializationOptimized, optimizeInitialization],
+        [withAndroidAdLoadingOptimized, optimizeAdLoading],
+        // iOS
+        [withIosAppId, iosAppId],
+        [withIosAppMeasurementInitDelayed, delayAppMeasurementInit],
+        [withIosSkAdNetworkItems, skAdNetworkItems],
+        [withIosUserTrackingUsageDescription, userTrackingUsageDescription],
+    ]);
+};
+exports.default = withReactNativeGoogleMobileAds;

package/plugin/jest.config.js

@@ -0,0 +1 @@
+module.exports = require("expo-module-scripts/jest-preset-plugin");

package/plugin/src/index.ts

@@ -0,0 +1,205 @@
+import {
+  AndroidConfig,
+  ConfigPlugin,
+  withAndroidManifest,
+  withPlugins,
+  withInfoPlist,
+} from '@expo/config-plugins';
+
+type PluginParameters = {
+  androidAppId?: string;
+  iosAppId?: string;
+  delayAppMeasurementInit?: boolean;
+  optimizeInitialization?: boolean;
+  optimizeAdLoading?: boolean;
+  skAdNetworkItems?: string[];
+  userTrackingUsageDescription?: string;
+};
+
+function addReplacingMainApplicationMetaDataItem(
+  manifest: AndroidConfig.Manifest.AndroidManifest,
+  itemName: string,
+  itemValue: string,
+): AndroidConfig.Manifest.AndroidManifest {
+  AndroidConfig.Manifest.ensureToolsAvailable(manifest);
+
+  const newItem = {
+    $: {
+      'android:name': itemName,
+      'android:value': itemValue,
+      'tools:replace': 'android:value',
+    },
+  } as AndroidConfig.Manifest.ManifestMetaData;
+
+  const mainApplication = AndroidConfig.Manifest.getMainApplicationOrThrow(manifest);
+  mainApplication['meta-data'] = mainApplication['meta-data'] ?? [];
+
+  const existingItem = mainApplication['meta-data'].find(
+    item => item.$['android:name'] === itemName,
+  );
+
+  if (existingItem) {
+    existingItem.$['android:value'] = itemValue;
+    existingItem.$['tools:replace' as keyof AndroidConfig.Manifest.ManifestMetaData['$']] =
+      'android:value';
+  } else {
+    mainApplication['meta-data'].push(newItem);
+  }
+
+  return manifest;
+}
+
+const withAndroidAppId: ConfigPlugin<PluginParameters['androidAppId']> = (config, androidAppId) => {
+  if (androidAppId === undefined) return config;
+
+  return withAndroidManifest(config, config => {
+    addReplacingMainApplicationMetaDataItem(
+      config.modResults,
+      'com.google.android.gms.ads.APPLICATION_ID',
+      androidAppId,
+    );
+
+    return config;
+  });
+};
+
+const withAndroidAppMeasurementInitDelayed: ConfigPlugin<
+  PluginParameters['delayAppMeasurementInit']
+> = (config, delayAppMeasurementInit) => {
+  if (delayAppMeasurementInit === undefined) return config;
+
+  return withAndroidManifest(config, config => {
+    addReplacingMainApplicationMetaDataItem(
+      config.modResults,
+      'com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT',
+      delayAppMeasurementInit.toString(),
+    );
+
+    return config;
+  });
+};
+
+const withAndroidInitializationOptimized: ConfigPlugin<
+  PluginParameters['optimizeInitialization']
+> = (config, optimizeInitialization = true) => {
+  return withAndroidManifest(config, config => {
+    addReplacingMainApplicationMetaDataItem(
+      config.modResults,
+      'com.google.android.gms.ads.flag.OPTIMIZE_INITIALIZATION',
+      optimizeInitialization.toString(),
+    );
+
+    return config;
+  });
+};
+
+const withAndroidAdLoadingOptimized: ConfigPlugin<PluginParameters['optimizeAdLoading']> = (
+  config,
+  optimizeAdLoading = true,
+) => {
+  return withAndroidManifest(config, config => {
+    addReplacingMainApplicationMetaDataItem(
+      config.modResults,
+      'com.google.android.gms.ads.flag.OPTIMIZE_AD_LOADING',
+      optimizeAdLoading.toString(),
+    );
+
+    return config;
+  });
+};
+
+const withIosAppId: ConfigPlugin<PluginParameters['iosAppId']> = (config, iosAppId) => {
+  if (iosAppId === undefined) return config;
+
+  return withInfoPlist(config, config => {
+    config.modResults.GADApplicationIdentifier = iosAppId;
+    return config;
+  });
+};
+
+const withIosAppMeasurementInitDelayed: ConfigPlugin<
+  PluginParameters['delayAppMeasurementInit']
+> = (config, delayAppMeasurementInit = false) => {
+  return withInfoPlist(config, config => {
+    config.modResults.GADDelayAppMeasurementInit = delayAppMeasurementInit;
+    return config;
+  });
+};
+
+const withIosSkAdNetworkItems: ConfigPlugin<PluginParameters['skAdNetworkItems']> = (
+  config,
+  skAdNetworkItems,
+) => {
+  if (skAdNetworkItems === undefined) return config;
+
+  return withInfoPlist(config, config => {
+    config.modResults.SKAdNetworkItems = config.modResults.SKAdNetworkItems ?? [];
+
+    const existingIdentifiers = config.modResults.SKAdNetworkItems.map(
+      (item: { SKAdNetworkIdentifier: string }) => item.SKAdNetworkIdentifier,
+    );
+
+    const missingIdentifiers = skAdNetworkItems.filter(
+      skAdNetworkItem => !existingIdentifiers.includes(skAdNetworkItem),
+    );
+
+    config.modResults.SKAdNetworkItems.push(
+      ...missingIdentifiers.map(identifier => ({
+        SKAdNetworkIdentifier: identifier,
+      })),
+    );
+
+    return config;
+  });
+};
+
+const withIosUserTrackingUsageDescription: ConfigPlugin<
+  PluginParameters['userTrackingUsageDescription']
+> = (config, userTrackingUsageDescription) => {
+  if (userTrackingUsageDescription === undefined) return config;
+
+  return withInfoPlist(config, config => {
+    config.modResults.NSUserTrackingUsageDescription = userTrackingUsageDescription;
+    return config;
+  });
+};
+
+const withReactNativeGoogleMobileAds: ConfigPlugin<PluginParameters> = (
+  config,
+  {
+    androidAppId,
+    delayAppMeasurementInit,
+    optimizeInitialization,
+    optimizeAdLoading,
+    iosAppId,
+    skAdNetworkItems,
+    userTrackingUsageDescription,
+  } = {},
+) => {
+  if (androidAppId === undefined) {
+    console.warn(
+      "No 'androidAppId' was provided. The native Google Mobile Ads SDK will crash on Android without it.",
+    );
+  }
+
+  if (iosAppId === undefined) {
+    console.warn(
+      "No 'iosAppId' was provided. The native Google Mobile Ads SDK will crash on iOS without it.",
+    );
+  }
+
+  return withPlugins(config, [
+    // Android
+    [withAndroidAppId, androidAppId],
+    [withAndroidAppMeasurementInitDelayed, delayAppMeasurementInit],
+    [withAndroidInitializationOptimized, optimizeInitialization],
+    [withAndroidAdLoadingOptimized, optimizeAdLoading],
+    // iOS
+    [withIosAppId, iosAppId],
+    [withIosAppMeasurementInitDelayed, delayAppMeasurementInit],
+    [withIosSkAdNetworkItems, skAdNetworkItems],
+    [withIosUserTrackingUsageDescription, userTrackingUsageDescription],
+  ]);
+};
+
+export default withReactNativeGoogleMobileAds;

package/plugin/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "expo-module-scripts/tsconfig.plugin",
+  "compilerOptions": {
+    "outDir": "build",
+    "rootDir": "src"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"]
+}

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}

package/react-native.config.js

@@ -0,0 +1,19 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        packageImportPath: 'import io.invertase.googlemobileads.ReactNativeGoogleMobileAdsPackage;',
+      },
+      ios: {
+        scriptPhases: [
+          {
+            name: '[RNGoogleMobileAds] Configuration',
+            path: './ios_config.sh',
+            execution_position: 'after_compile',
+            input_files: ['$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)'],
+          },
+        ],
+      },
+    },
+  },
+};

package/src/AdEventType.ts

@@ -0,0 +1,70 @@
+/*
+ * 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.
+ *
+ */
+
+export enum AdEventType {
+  /**
+   * When an ad has loaded. At this point, the ad is ready to be shown to the user.
+   *
+   * #### Example
+   *
+   * ```js
+   * import { AdEventType } from 'react-native-google-mobile-ads';
+   *
+   * advert.addEventListener(AdEventType.LOADED, () => {
+   *   advert.show();
+   * });
+   * ```
+   */
+  LOADED = 'loaded',
+
+  /**
+   * The ad has thrown an error. See the error parameter the listener callback for more information.
+   *
+   * #### Example
+   *
+   * ```js
+   * import { AdEventType } from 'react-native-google-mobile-ads';
+   *
+   * advert.addEventListener(AdEventType.ERROR, (error) => {
+   *   console.log('Ad error:', error);
+   * });
+   * ```
+   */
+  ERROR = 'error',
+
+  /**
+   * The ad opened and is currently visible to the user. This event is fired after the `show()`
+   * method has been called.
+   */
+  OPENED = 'opened',
+
+  /**
+   * Called when ad generates revenue.
+   * See: https://developers.google.com/admob/android/impression-level-ad-revenue
+   */
+  PAID = 'paid',
+
+  /**
+   * The user clicked the advert.
+   */
+  CLICKED = 'clicked',
+
+  /**
+   * The user closed the ad and has returned back to your application.
+   */
+  CLOSED = 'closed',
+}