AdMob Custom Events

Summary

GraviteRTBAdMobMediationAdapter is a Gravite framework that implements AdMob custom events. It supports the following ad formats:

• Banners

• Fullscreen

• Native Ads

How GraviteRTBAdMobMediationAdapter Works

• Publishers must prepare their AdMob dashboard by adding custom events to their mediation (See Google instructions Add a custom event).

• GraviteRTBAdMobMediationAdapter Implements AdMob custom events delegates.

• The publisher requests an ad (Banner, Fullscreen or NativeAd) from GoogleMobileAds (To learn how to request an ad from GoogleMobileAds, please visit Google’s documentation).

• GoogleMobileAds internally calls GraviteRTBAdMobMediationAdapter asking for an ad.

• GraviteRTBAdMobMediationAdapter internally calls RTBSDK asking for an ad.

• When RTBSDK responds, GraviteRTBAdMobMediationAdapter will notify GoogleMobileAds with the response using the AdMob custom events delegate methods. And in return, GoogleMobileAds will notify you of the response using the normal GoogleMobileAds callback.

Integration steps

Step 1: Set Up Mediation in the AdMob Dashboard

• Log in to your AdMob dashboard and navigate to "Mediation" in the left menu.

• Create a new mediation group for each ad format you plan to use.

  • Ensure you select the correct ad unit used in your application during the GoogleMobileAds integration.

• Open the newly created mediation group and add a Custom Event.

• Edit the custom event and specify the appropriate class name for your ad format:

  • Banner ads: GraviteRTBAdMobMediationAdapterBanner.

  • Interstitial ads: GraviteRTBAdMobMediationAdapterInterstitial.

  • Native ads: GraviteRTBAdMobMediationAdapterNativeAds.

• In the "Mediation" section under the "Waterfall Sources" tab, click on "Manage Mapping" and add the following data to the "Parameter" field:

  • {"appId": "<iTunes_app_id>", "placementId": <integer_placement_id>, "sellerId": "<seller_id>"}.

  • Replace <iTunes_app_id>, <integer_placement_id>, and <seller_id> with the appropriate values for your app.

  • This data is used by the Gravite RTBSDK to load ads:

    • appId and placementId are required.

    • sellerId is optional.

Step 2: Add Gravite AdMob Mediation Adapter

• Integrate GraviteRTBAdMobMediationAdapter

  • Cocoapods:

    • Open your Podfile and include the following line:

      • pod 'RTBSDK/GraviteRTBAdMobMediationAdapter'

      • This will automatically add the necessary dependencies: RTBSDK and GoogleMobileAds.

  • Swift Package Manager:

    • Follow the same SPM steps here.
    • In the last step, select RTBSPM and GraviteRTBAdMobMediationAdapter

    
  • Pass GDPR preferences as early as possible, preferably in the AppDelegate's didFinishLaunchingWithOptions method:

    • RTBAdMobMediationAdapterManager.shared.setIsGDPRApplies(true)

  • If your app is directed to children call this method as early as possible:

    • RTBAdMobMediationAdapterManager.shared.setIsChildDirected(true)

Step 3: Integrate Google Ad Formats

• Follow the Google Mobile Ads SDK documentation to integrate the ad formats you wish to use.
• Ensure you add your App ID to your app's Info.plist file under the key:

<key>GADApplicationIdentifier</key>
<string>Your_App_ID</string>

If your integration is successfully done, you should see logs with this pattern GraviteRTBAdMobMediationAdapter [LOG_LEVEL]: while testing your integration. If not, please revisit your dashboard and the above steps again.