Pangle: A global platform dedicated to developer growth.|Integration Docs
Knowledge Center

Please note that with the deprecation of the custom event interface in AdMob v9.0.0, it is important to take certain steps to ensure compatibility with the latest version of AdMob. If you are using adapter v1.4.3 or an earlier version, we recommend using AdMob versions below 9.0.0 to avoid any issues. For further information, please refer to the link provided. If you are using AdMob v9.0.0 or a later version, please update to Pangle adapter version 2.0.0 or above and update Pangle SDK to v4.6.0.0 or above to ensure smooth compatibility.

To begin, kindly ensure that your app has been properly configured with Admob. It's important to note that we now offer a new configuration for version 46 of the SDK. If you plan to use SDK version 46, please make sure to utilize adapter version 2.0.0.

Setup Pangle Platform

Create a Pangle account

Create an application and placements in Pangle

  • Click Apps -> + Add App to create an app for mediation.
  • You will get an app with its app ID.

Create Ad Placement

  • Click Ad Placements -> + Add Ad Placement to create the placement for mediation.
  • Select the ad's type for your app and finish the create.
  • You will get a placement with its placement ID.

Add Pangle to AdMob's mediation

Create mediation

  • Click Mediation -> CREATE MEDIATION GROUP to create a mediation group.
  • Select the same ad format which was created on the Pangle side.
  • After selecting the ad unit you created on AdMob which you want to embed mediation, click ADD CUSTOM EVENT to set with Pangle.

Set Class Name and Parameter

Set Class Name and Parameter in the mediation setting.

  • If you use SDK v46 and above:(recommended)
  • If you use SDK v45 and below:


  • If you use SDK v46 and above:(recommended)
  • If you use SDK v45 and below:
    • Add {"placementID":"your placement ID on Pangle"} to Parameter, for example,{"placementID": "1234567"} .
    • Please make sure to use JSON to set the Parameter. Or you need to customize the adapter yourself.

Class Name:

  • If you use SDK v46 and above:(recommended)
    • Add BUDAdmob_CustomEventAdapter directly in the Class Name blank. If you are using App Open Ad, please add BUDAdmob_CustomEventAdapterForOpenAd directly in the Class Name blank.
  • If you use SDK v45 and below:
    • the adapter class's name, for example,BUDAdmob_RewardCustomEventAdapter
    • Class name for different ad formats Ty
      • Reward Video Ads:  BUDAdmob_RewardCustomEventAdapter
      • Interstitial Ads: BUDAdmob_FullScreenVideoCustomEventAdapter
      • Banner Ads:  BUDAdmob_BannerCustomEventAdapter
      • Native Ads:  BUDAdmob_NativeFeedCustomEventAdapter

Note for updating to SDK v46+ from older SDK versions

Note: If you are updating the Pangle Custom Event adapter from SDK v45 below to SDK v46 above, please note that you are recommended to keep both the old and the new Custom Event settings in the mediation ad units, to avoid revenue loss in the older app version during users' transition.

Initialize Pangle SDK and Adapter

Import and Init Pangle SDK

Add the information as follows in Podfile, and use pod update or pod install to integrate.

Initialize Pangle with the APP ID as the argument. Unless there is a particular reason, stipulate asUIApplicationDelegate application(_:didFinishLaunchingWithOptions:)

We recommend using asynchronize initialization method + (void)startWithAsyncCompletionHandler:(BUCompletionHandler)completionHandler; to init the SDK, and also set allowModifyAudioSessionSetting to true to not interrupt the background's audio playback.

  • If you use SDK v46 and above:(recommended)
  • If you use SDK v45 and below:

Please refer to Integrate Pangle SDK and Initialize Pangle SDK for manual integration and more information.

Embed Pangle Adapters

CocoaPods (preferred)

From our adapter v2.0.0, we support CocoaPods integration, and this is the prerequisite for using it.

  • Pangle SDK or higher
  • Google-Mobile-Ads-SDK 9.0.0 or higher

Add the information as follows in Podfile, and using pod update or pod install to intergrate.

Manual download

  • Click SDK Integration -> SDK download, you can download adapters for different ad formats from your Pangle platform.

Please unzip the file and add adapter files from iOS folder into your application project. They can be used with no code changes. Also you can customize it for your use case.

  • You need to add BUDAdmob_NativeFeedAd.h and BUDAdmob_NativeFeedAd.m into your project to support native ad's adapter mapping.

About Swift

  • If your project is based on Swift, please add the adapter's header file to your bridge-header file.


  • You can find simple use cases from Demo.