Send feedback
Integrate Pangle with bidding
Stay organized with collections
Save and categorize content based on your preferences.
This guide shows you how to use the Google Mobile Ads SDK to load and display
ads from Pangle using mediation ,
covering both waterfall and bidding integrations. It covers how to add Pangle to
an ad unit's mediation configuration, and how to integrate the Pangle SDK and
adapter into an Android app.
The Ad Manager mediation adapter for Pangle has the
following capabilities:
Integration
Bidding
Waterfall
Formats
App open
Banner
Interstitial
Rewarded
Rewarded Interstitial
Native
Waterfall integration is
in closed beta.
Bidding integration for
this format is in closed beta.
Requirements
Android API level 21 or higher
Step 1: Set up configurations in Pangle UI
Sign up or
Log in to your Pangle account.
Add a new application
Navigate to the Applications tab and click the Add App button.
Select the Operating System you wish to create an application for and fill
out the rest of the form. Then, click Submit .
Take note of your application's App ID .
Create an ad placement
Once your application has been created, click the Add button as shown
below to create your ad placement.
Select your Ad Format and Ad Placement Name , and select
In-App Bidding as the Pricing Type . Fill out the rest of the form and
click Submit .
Once your ad placement is created, take note of the Ad Placement ID .
Turn on test mode
Follow the instructions in Pangle's
How to add a Test Ad guide on how
to enable Pangle test ads.
Step 2: Set up Pangle demand in Ad Manager UI
Sign in to your Ad Manager account .
Add Pangle in Companies
Bidding This step isn't required for bidding integrations.
Waterfall Navigate to Admin > Companies , then click the New company button
in the All companies tab. Select Ad network .
Select Pangle as the Ad network ,
enter a unique Name and enable Mediation .
You don't need to enter a Username or Password . Click Save when
done.
Enable secure signal sharing
Bidding Navigate to Admin > Global settings . Go to the
Ad Exchange account settings tab and review and toggle on
Secure signal sharing . Click Save .
Waterfall This step isn't required for waterfall integrations.
Bidding Navigate to Delivery > Bidders , and click New bidder under the
SDK Bidding tab.
Select Pangle as the bidder.
Toggle on Add this bidder's signal library to the list of allowed
signals and Allow signals to be shared with this bidder . Then, click
Continue .
Click Continue .
Click Done .
Waterfall This step isn't required for waterfall integrations.
Bidding Navigate to Delivery > Bidders , and select the company for
Pangle under the SDK Bidding tab.
Go to the Ad unit mapping tab and click New ad unit mapping .
Choose Specific ad unit . Select an ad unit and format, Mobile app as
the Inventory type , and your Mobile application . Then, enter
App ID and Ad Placement ID obtained in the
previous section. Finally, click Save .
Important: Target the selected ad unit by at least one yield group, and the
App ID must be associated
with the targeted app as in the
Pangle UI.
Waterfall Navigate to Delivery > Yield groups and click the New yield
group button. Select your Mobile application .
Scroll down and click Add yield partner .
Select the company you created for Pangle
in the previous section. Choose Mobile SDK mediation as the
Integration type , Android as the
Platform , and Active as the Status .
Enter the App ID and Ad Placement ID
obtained in the previous section, and the Default CPM value. Click
Save .
Important: The App ID must
be associated with the targeted app as in the
Pangle UI.
Step 3: Import the Pangle SDK and adapter
Note: Failure to integrate the compatible Pangle and Google Mobile Ads SDK
versions might lead to build issues.
Android Studio integration (recommended)
In your project-level settings.gradle.kts
file, add the following
repositories:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
}
Then, in your app-level build.gradle.kts
file, add the following
implementation dependencies and configurations. Use the latest versions of the
Pangle SDK and adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:pangle:5.8.0.9.0")
}
Manual integration
Download the latest version of the
Pangle SDK for Android
and extract the open_ad_sdk.aar
under from the downloaded archive folder
and add it to your project.
Navigate to the
Pangle adapter artifacts
on Google's Maven Repository. Select the latest version, download the Pangle
adapter's .aar
file, and add it to your project.
Step 4: Add required code
ProGuard obfuscation
If you use ProGuard to obfuscate Android code, follow the instructions in
Pangle's documentation
to ensure Pangle SDK code isn't obfuscated.
Step 5: Test your implementation
Enable test ads
Make sure you
register your test device
for
Ad Manager and enable test mode in
Pangle UI.
Important: Disable test mode for Ad Manager and
Pangle before releasing your app.
Verify test ads
To verify that you are receiving test ads from
Pangle,
enable
single ad source testing
in ad inspector using the Pangle (Bidding) and Pangle (Waterfall) ad
source(s).
Optional Steps
Native ads
Ad rendering
The Pangle adapter returns its native ads as
NativeAd
objects. It populates the following
fields
for a
NativeAd
.
Field
Assets always included by Pangle adapter
Headline
Image
Body
Icon
Call to action
Star rating
Store
Price
Advertiser
The Pangle adapter does not
provide direct access to the main image asset for its native ads. Instead, the
adapter populates the
MediaView
with a video or an image.
Error codes
If the adapter fails to receive an ad from Pangle, you can check the
underlying error from the ad response using
ResponseInfo.getAdapterResponse()
under the following classes:
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
Here are the codes and accompanying messages thrown by the Pangle adapter when
an ad fails to load:
Error code
Domain
Reason
101
com.google.ads.mediation.pangle
Invalid server parameters (e.g. Missing app ID or placement ID).
102
com.google.ads.mediation.pangle
The requested ad size does not match a Pangle supported banner size.
103
com.google.ads.mediation.pangle
Missing or invalid bid response.
-1-60000
com.pangle.ads
Pangle SDK returned an error. See Pangle's documentation for more details.
Version 5.8.0.9.0
Verified compatibility with Pangle SDK version 5.8.0.9.
Updated the minimum required Google Mobile Ads SDK version to 23.0.0.
Built and tested with:
Google Mobile Ads SDK version 23.0.0.
Pangle SDK version 5.8.0.9.
Version 5.8.0.7.0
Verified compatibility with Pangle SDK version 5.8.0.7.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.8.0.7.
Version 5.8.0.6.0
Verified compatibility with Pangle SDK version 5.8.0.6.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.8.0.6.
Version 5.7.0.3.0
Verified compatibility with Pangle SDK version 5.7.0.3.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.7.0.3.
Version 5.7.0.2.0
Verified compatibility with Pangle SDK version 5.7.0.2.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.7.0.2.
Version 5.7.0.1.0
Verified compatibility with Pangle SDK version 5.7.0.1.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.7.0.1.
Version 5.6.0.3.0
Verified compatibility with Pangle SDK version 5.6.0.3.
Updated the minimum required Google Mobile Ads SDK version to 22.6.0.
Built and tested with:
Google Mobile Ads SDK version 22.6.0.
Pangle SDK version 5.6.0.3.
Version 5.5.0.9.0
Updated the minimum required Google Mobile Ads SDK version to 22.5.0.
Verified compatibility with Pangle SDK version 5.5.0.9.
Built and tested with:
Google Mobile Ads SDK version 22.5.0.
Pangle SDK version 5.5.0.9.
Version 5.5.0.8.0
Verified compatibility with Pangle SDK version 5.5.0.8.
Built and tested with:
Google Mobile Ads SDK version 22.3.0.
Pangle SDK version 5.5.0.8.
Version 5.5.0.7.0
Verified compatibility with Pangle SDK version 5.5.0.7.
Built and tested with:
Google Mobile Ads SDK version 22.3.0.
Pangle SDK version 5.5.0.7.
Version 5.5.0.6.0
Bidding app open ad format isn't supported in this version as this adapter version was reverted to depend on Google Mobile Ads SDK version 22.3.0.
Verified compatibility with Pangle SDK version 5.5.0.6.
Built and tested with:
Google Mobile Ads SDK version 22.3.0.
Pangle SDK version 5.5.0.6.
Version 5.5.0.4.0
Added bidding support for app open ad format.
Added watermark support for bidding ads.
Updated the minimum required Google Mobile Ads SDK version to 22.4.0.
Verified compatibility with Pangle SDK version 5.5.0.4.
Built and tested with:
Google Mobile Ads SDK version 22.4.0.
Pangle SDK version 5.5.0.4.
Version 5.4.1.1.0
Fixed an issue where the adapter fails to initialize.
Verified compatibility with Pangle SDK version 5.4.1.1.
Built and tested with:
Google Mobile Ads SDK version 22.3.0.
Pangle SDK version 5.4.1.1.
Version 5.4.0.9.0
Verified compatibility with Pangle SDK version 5.4.0.9.
Updated the minimum required Google Mobile Ads SDK version to 22.3.0.
Built and tested with:
Google Mobile Ads SDK version 22.3.0.
Pangle SDK version 5.4.0.9.
Version 5.4.0.8.0
Verified compatibility with Pangle SDK version 5.4.0.8.
Built and tested with:
Google Mobile Ads SDK version 22.2.0.
Pangle SDK version 5.4.0.8.
Version 5.3.0.6.0
Verified compatibility with Pangle SDK version 5.3.0.6.
Built and tested with:
Google Mobile Ads SDK version 22.2.0.
Pangle SDK version 5.3.0.6.
Version 5.3.0.5.0
Verified compatibility with Pangle SDK version 5.3.0.5.
Built and tested with:
Google Mobile Ads SDK version 22.2.0.
Pangle SDK version 5.3.0.5.
Version 5.3.0.4.0
Verified compatibility with Pangle SDK version 5.3.0.4.
Built and tested with:
Google Mobile Ads SDK version 22.2.0.
Pangle SDK version 5.3.0.4.
Version 5.2.0.7.0
Verified compatibility with Pangle SDK version 5.2.0.7.
Built and tested with:
Google Mobile Ads SDK version 22.1.0.
Pangle SDK version 5.2.0.7.
Version 5.2.0.6.0
Verified compatibility with Pangle SDK version 5.2.0.6.
Built and tested with:
Google Mobile Ads SDK version 22.1.0.
Pangle SDK version 5.2.0.6.
Version 5.2.0.5.0
Verified compatibility with Pangle SDK version 5.2.0.5.
Built and tested with:
Google Mobile Ads SDK version 22.1.0.
Pangle SDK version 5.2.0.5.
Version 5.2.0.3.0
Added waterfall support for app open, banner (includes MREC), interstitial,
rewarded and native ad formats.
Verified compatibility with Pangle SDK version 5.2.0.3.
Built and tested with:
Google Mobile Ads SDK version 22.0.0.
Pangle SDK version 5.2.0.3.
Version 5.1.0.9.0
Verified compatibility with Pangle SDK version 5.1.0.9.
Built and tested with:
Google Mobile Ads SDK version 22.0.0.
Pangle SDK version 5.1.0.9.
Version 5.1.0.8.0
Verified compatibility with Pangle SDK version 5.1.0.8.
Built and tested with:
Google Mobile Ads SDK version 22.0.0.
Pangle SDK version 5.1.0.8.
Version 5.1.0.6.0
Updated adapter to use new VersionInfo
class.
Updated the minimum required Google Mobile Ads SDK version to 22.0.0.
Built and tested with:
Google Mobile Ads SDK version 22.0.0.
Pangle SDK version 5.1.0.6.
Version 5.0.1.1.0
Verified compatibility with Pangle SDK version 5.0.1.1.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.1.1.
Version 5.0.1.0.0
Verified compatibility with Pangle SDK version 5.0.1.0.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.1.0.
Version 5.0.0.9.0
Verified compatibility with Pangle SDK version 5.0.0.9.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.0.9.
Version 5.0.0.8.0
Verified compatibility with Pangle SDK version 5.0.0.8.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.0.8.
Version 5.0.0.7.0
Verified compatibility with Pangle SDK version 5.0.0.7.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.0.7.
Version 5.0.0.6.0
Verified compatibility with Pangle SDK version 5.0.0.6.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 5.0.0.6.
Version 4.9.0.9.0
Verified compatibility with Pangle SDK version 4.9.0.9.
Updated the minimum required Google Mobile Ads SDK version to 21.5.0.
Built and tested with:
Google Mobile Ads SDK version 21.5.0.
Pangle SDK version 4.9.0.9.
Version 4.9.0.8.0
Verified compatibility with Pangle SDK version 4.9.0.8.
Built and tested with:
Google Mobile Ads SDK version 21.4.0.
Pangle SDK version 4.9.0.8.
Version 4.9.0.7.0
Verified compatibility with Pangle SDK version 4.9.0.7.
Built and tested with:
Google Mobile Ads SDK version 21.4.0.
Pangle SDK version 4.9.0.7.
Version 4.9.0.6.0
Verified compatibility with Pangle SDK version 4.9.0.6.
Built and tested with:
Google Mobile Ads SDK version 21.4.0.
Pangle SDK version 4.9.0.6.
Version 4.8.1.0.0
Verified compatibility with Pangle SDK version 4.8.1.0.
Updated the minimum required Google Mobile Ads SDK version to 21.4.0.
Built and tested with:
Google Mobile Ads SDK version 21.4.0.
Pangle SDK version 4.8.1.0.
Version 4.8.0.9.0
Verified compatibility with Pangle SDK version 4.8.0.9.
Built and tested with:
Google Mobile Ads SDK version 21.3.0.
Pangle SDK version 4.8.0.9.
Version 4.8.0.8.0
Verified compatibility with Pangle SDK version 4.8.0.8.
Built and tested with:
Google Mobile Ads SDK version 21.3.0.
Pangle SDK version 4.8.0.8.
Version 4.8.0.7.0
Verified compatibility with Pangle SDK version 4.8.0.7.
Built and tested with:
Google Mobile Ads SDK version 21.3.0.
Pangle SDK version 4.8.0.7.
Version 4.8.0.6.0
Verified compatibility with Pangle SDK version 4.8.0.6.
Built and tested with:
Google Mobile Ads SDK version 21.3.0.
Pangle SDK version 4.8.0.6.
Version 4.7.0.7.0
Verified compatibility with Pangle SDK version 4.7.0.7.
Updated the minimum required Google Mobile Ads SDK version to 21.3.0.
Built and tested with:
Google Mobile Ads SDK version 21.3.0.
Pangle SDK version 4.7.0.7.
Version 4.7.0.6.0
Verified compatibility with Pangle SDK version 4.7.0.6.
Built and tested with:
Google Mobile Ads SDK version 21.2.0.
Pangle SDK version 4.7.0.6.
Version 4.7.0.5.0
Verified compatibility with Pangle SDK version 4.7.0.5.
Built and tested with:
Google Mobile Ads SDK version 21.2.0.
Pangle SDK version 4.7.0.5.
Version 4.7.0.3.0
Verified compatibility with Pangle SDK version 4.7.0.3.
The adapter now attempts to initialize the Pangle SDK before loading ads.
Built and tested with:
Google Mobile Ads SDK version 21.2.0.
Pangle SDK version 4.7.0.3.
Version 4.6.0.9.0
Verified compatibility with Pangle SDK version 4.6.0.9.
Updated the minimum required Google Mobile Ads SDK version to 21.2.0.
Built and tested with:
Google Mobile Ads SDK version 21.2.0.
Pangle SDK version 4.6.0.9.
Version 4.5.0.6.1
Added bidding support for native ad format.
Updated the minimum required Google Mobile Ads SDK version to 21.1.0.
Built and tested with:
Google Mobile Ads SDK version 21.1.0.
Pangle SDK version 4.5.0.6.
Version 4.5.0.6.0
Verified compatibility with Pangle SDK version 4.5.0.6.
Built and tested with:
Google Mobile Ads SDK version 21.0.0.
Pangle SDK version 4.5.0.6.
Version 4.5.0.5.0
Verified compatibility with Pangle SDK version 4.5.0.5.
Built and tested with:
Google Mobile Ads SDK version 21.0.0.
Pangle SDK version 4.5.0.5.
Version 4.5.0.4.0
Verified compatibility with Pangle SDK version 4.5.0.4.
Built and tested with:
Google Mobile Ads SDK version 21.0.0.
Pangle SDK version 4.5.0.4.
Version 4.5.0.3.0
Verified compatibility with Pangle SDK version 4.5.0.3.
Updated compileSdkVersion
and targetSdkVersion
to API 31.
Updated the minimum required Google Mobile Ads SDK version to 21.0.0.
Updated the minimum required Android API level to 19.
Built and tested with:
Google Mobile Ads SDK version 21.0.0.
Pangle SDK version 4.5.0.3.
Version 4.3.0.9.0
Verified compatibility with Pangle SDK version 4.3.0.9.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.3.0.9.
Version 4.3.0.8.0
Verified compatibility with Pangle SDK version 4.3.0.8.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.3.0.8.
Version 4.3.0.7.0
Verified compatibility with Pangle SDK version 4.3.0.7.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.3.0.7.
Version 4.3.0.6.0
Verified compatibility with Pangle SDK version 4.3.0.6.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.3.0.6.
Version 4.3.0.4.0
Verified compatibility with Pangle SDK version 4.3.0.4.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.3.0.4.
Version 4.2.5.3.0
Initial release!
Added bidding support for banner (includes MREC), interstitial and rewarded ad formats.
Built and tested with:
Google Mobile Ads SDK version 20.6.0.
Pangle SDK version 4.2.5.3.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-03-27 UTC.