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

[iOS]Google Ad Manager Custom Event for Pangle

Attention:

The custom event interface has been deprecated by AdMob v9.0.0. To prevent potential issues, it is recommended to use AdMob versions that are below 9.0.0. For more information, please refer to the documentation.

In the event that AdMob v9.0.0 or above is being used, please ensure that the Pangle adapter is updated to version 2.0.0 or later and that the Pangle SDK is updated to version v4.6.0.0 or later.

Please set Google Ad Manager in your app first.

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 Google Ad Manager

Create mediation

  • Open Delivery section, click Yield Group -> New Yield GROUP to create a mediation group.
截屏2021-09-10 上午1.15.55.png
  • Select the same ad format created on the Pangle side and Mobile App for Inventory type,
截屏2021-09-10 上午1.16.47.png
  • After selecting the ad unit you created on Google Ad Manger which you want to embed mediation, click ADD Yield Partner to set with Pangle.
截屏2021-09-10 上午1.18.15.png
  • Enter the yield partner (create a new yield partner for Pangle if you do not have one), then select Custome Event on integration type and platform based on your OS.
截屏2021-09-10 上午1.49.03.png
  • Parameter.
    • If you use SDK v46 and above:(recommended)
    • If you use SDK v45 and below:
      • Parameter: 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.
  • Add the adapter's class name to 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:
      • Class name for different ad formats: 

Ad Type

Class Name

Reward Video Ads

BUDAdmob_RewardCustomEventAdapter

Interstitial Ads

BUDAdmob_FullScreenVideoCustomEventAdapter

Banner Ads

BUDAdmob_BannerCustomEventAdapter

Native Ads

BUDAdmob_NativeFeedCustomEventAdapter


  • Example
    • If you use SDK v46 and above:(recommended)
  • If you use SDK v45 and below:
截屏2021-09-10 上午1.50.40.png


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 to use 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 4.6.0.0 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 to 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 adapter mapping.

About Swift

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

Demo

  • You can find simple use cases from Demo.