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

[Android]Google Ad Manager Custom Event for Pangle

Attention:

With the deprecation of the custom event interface in AdMob v20.6.0, it is recommended to use AdMob versions below 20.6.0 to avoid issues. For more information, please refer to the provided link.

If you are using AdMob v20.6.0 and above, it is necessary to update the Pangle adapter to version 2.0.0 or above, and the Pangle SDK to version 4.6.0.0 or above.

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.

  • Select the same ad format which created on Pangle side and Mobile App for Inventory type,
截屏2021-09-10 上午1.16.47.png
  • After select 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.35.48.png


Set Class Name and Parameter

Set Label, Class Name and Parameter in the mediation setting.

If you use SDK v46 and above:(recommended)

If you use SDK v45 and below:

截屏2021-09-10 上午1.20.25.png


Class Name

  • If you use SDK v46 and above:(recommended)
    •   Fill com.google.ads.mediation.pangle.customevent.PangleCustomEvent directly in the Admob platform.
  • If you use SDK v45 and below:
    • If you are using gradle to integrate our adapters, please copy the contents below to Class Name .

Ad Type

Class Name

Reward Video Ads

com.google.ads.mediation.sample.customevent.adapter.AdmobRewardVideoAdapter

Interstitial Ads

com.google.ads.mediation.sample.customevent.adapter.AdmobFullScreenVideoAdapter

Banner Ads

com.google.ads.mediation.sample.customevent.adapter.AdmobTemplateBannerAdapter

Native Ads

com.google.ads.mediation.sample.customevent.adapter.AdmobNativeFeedAdAdapter

    • Else if you are integrating our adapters manually, please add the adapter's package + adapter'class name to Class Name.

Ad Type

adapter'class name (need add package of your app )

Reward Video Ads

AdmobRewardVideoAdapter

Interstitial Ads

AdmobFullScreenVideoAdapter

Banner Ads

AdmobTemplateBannerAdapter

Native Ads

AdmobNativeFeedAdAdapter

    • for example,com.bytedance.pangle.admob.adapter.demo.pangle.adapter.AdmobRewardVideoAdapter
class-name.png


Parameter

  • If you use SDK v46 and above:(recommended)
  • If you use SDK v45 and below:
    •   Add {"placementID":"your slot ID"} to Parameter.
    • 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.


Initialize Pangle SDK and Adapter


Import and Init Pangle SDK

Add url 'https://artifact.bytedance.com/repository/pangle' maven in the allprojects section of your project-level build.gradle.

Next, open the app-level build.gradle file for your app, add implementation 'com.pangle.global:ads-sdk:x.x.x.x' in "dependencies" section.In order to use the Android Advertising ID, we also recommend adding com.google.android.gms:play-services-ads-identifier.

Add the following permissions and provider to your app's AndroidManifest.xml.

Please make sure to add provider or ad's loading will not work properly.

  • Warning: TTMultiProvider needs to be removed starting from v4.1.0.0 SDK, otherwise it will cause packaging failure
  • Tips: WAKE_LOCK permission is no longer required in version 4.2.5.2 and above

Initialize Pangle SDK asynchronously is supported since the v3.5.0.0 SDK, please call TTAdSdk.init(final Context var0, final TTAdConfig var1, final TTAdSdk.InitCallback var2) to initialize the SDK before you send any ad requests. init only need to be called once per app’s lifecycle, we strongly recommend doing this on app launch.

TTAdSdk.InitCallback will be informed about the result of the initialization.

If you use TextureView for video ads, please set useTextureView(true) in the Builder and add add WAKE_LOCK permission in the manifest.


If you use SDK v46 and above:(recommended)

If you use SDK v45 and below:

You also could check the initialization status with the method TTAdSdk.isInitSuccess()

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


Embed Pangle Adapters


Gradle (preferred)

From our adapter v2.0.0, we support gradle integration.

Please open the app-level build.gradle file for your app, add implementation 'com.pangle.global:adapter-for-admob:2.0.0' in "dependencies" section.


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 Android folder into your application project. They can be used with no code changes. Also you can customize it for your use case.

adapter-files.png


Demo

  • You can find simple use cases from Demo.