expo-ads-admob
    TypeScript icon, indicating that this package has built-in type declarations

    12.0.0 • Public • Published

    expo-ads-admob

    Provides support for the Google AdMob SDK (https://www.google.com/admob/) for mobile advertising. This module is largely based of the react-native-admob (https://github.com/sbugert/react-native-admob) module, as the documentation and questions surrounding that module may prove helpful. A simple example implementing AdMob SDK can be found at https://github.com/deadcoder0904/expo-google-admob.

    API documentation

    Installation in managed Expo projects

    For managed managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release.

    Installation in bare React Native projects

    For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.

    Add the package to your npm dependencies

    expo install expo-ads-admob
    

    Configure for iOS

    Run npx pod-install after installing the npm package.

    In your app's Info.plist file, add a GADApplicationIdentifier key with a string value of your AdMob app ID, as shown in Google's Mobile Ads SDK iOS docs.

    <key>GADApplicationIdentifier</key>
    <string>ca-app-pub-3940256099942544~1458002511</string>

    Add NSUserTrackingUsageDescription key to your Info.plist:

    <key>NSUserTrackingUsageDescription</key>
    <string>This identifier will be used to deliver personalized ads to you.</string>

    Add the required SKAdNetworkIdentifier items to your Info.plist: Google SKAdNetwork.

    Configure for Android

    Ensure that there is a meta-data element inside the application node inside AndroidManifest.xml file (located typically under /android/app/src/main/AndroidManifest.xml) with android:name of "com.google.android.gms.ads.APPLICATION_ID" and a value of your AdMob App ID. Google's Mobile Ads SDK documentation shows precisely how to do this here. In the end your AndroidManifest.xml should look more or less like this:

    <manifest>
      <application>
        ...
        <!-- Ensure that tag with this name and proper value is inside application -->
        <meta-data
          android:name="com.google.android.gms.ads.APPLICATION_ID"
          android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- App ID -->
        <!-- You can find your App ID in the AdMob UI -->
        ...
      </application>
    </manifest>

    This package automatically adds the INTERNET permission. It's required to interact with Google's service.

    <manifest>
      <!-- Added permissions -->
      <uses-permission android:name="android.permission.INTERNET" />
    </manifest>

    Contributing

    Contributions are very welcome! Please refer to guidelines described in the contributing guide.

    Install

    npm i expo-ads-admob

    DownloadsWeekly Downloads

    2,413

    Version

    12.0.0

    License

    MIT

    Unpacked Size

    162 kB

    Total Files

    113

    Last publish

    Collaborators

    • tsapeta
    • dsokal
    • wkozyra
    • bbarthec
    • ide
    • lukmccall
    • kgc00
    • fiber-god
    • brentvatne
    • ccheever
    • evanbacon
    • quinlanj
    • esamelson
    • expoadmin
    • charliecruzan
    • tcdavis
    • exponent
    • wschurman
    • jkhales
    • bycedric
    • jonsamp
    • princefleaswallow
    • andyboythekid
    • kudochien
    • jesseruder
    • terribleben
    • sjchmiela