This guide shows you how to use the Google Mobile Ads SDK to load and display ads from Pangle using AdMob 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.
Supported integrations and ad formats
The mediation adapter for Pangle has the following capabilities:
Integration | |
---|---|
Bidding | |
Waterfall | |
Formats | |
App open | 1 |
Banner | |
Interstitial | |
Rewarded | |
Rewarded Interstitial | |
Native |
Requirements
- Android API level 21 or higher
Latest Google Mobile Ads SDK
Complete the mediation Get started guide
Step 1: Set up configurations in Pangle UI
新しいアプリケーションの追加
[Applications] タブに移動し、[Add App] ボタンをクリックします。
アプリケーションを作成するオペレーティング システムを選択し、フォームの残りの部分を入力します。[送信] をクリックします。
アプリケーションのアプリ ID をメモします。
広告プレースメントを作成する
アプリが作成されたら、[追加] ボタンをクリックして広告のプレースメントを作成します。
入札
広告フォーマットと広告プレースメント名を選択し、[価格設定タイプ] として [アプリ内入札] を選択します。フォームの残りの部分に記入して、[送信] をクリックします。
広告のプレースメントを作成したら、広告プレースメント ID をメモします。
ウォーターフォール
[広告フォーマット] と [広告プレースメント名] を選択し、[課金タイプ] で [グローバル CPM] を選択します。フォームの残りの部分に記入して、[送信] をクリックします。
広告のプレースメントを作成したら、広告プレースメント ID をメモします。
Pangle Reporting API キーを見つける
入札
入札の統合では、この手順は必要ありません。
ウォーターフォール
ページの左下にあるユーザー ID をメモします。
[統合] > [SDK と API] > [Pangle Reporting API 2.0] をクリックします。[Role ID] と [Security Key] をメモします。
テストモードをオンにする
Pangle のテスト広告を有効にする方法については、Pangle のテスト広告を追加する方法ガイドをご覧ください。
Step 2: Set up Pangle demand in AdMob UI
広告ユニットのメディエーション設定を行う
広告ユニットのメディエーション設定に Pangle を追加する必要があります。
AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Pangle を追加するに進んでください。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力して、[続行] をクリックします。
メディエーション グループに名前を付けて、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、既存の 1 つ以上の広告ユニット(AdMob )に関連付けます。[完了] をクリックします。
選択した広告ユニットが入力された広告ユニットカードが表示されます。
広告ソースとして Pangle を追加
入札
[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。Pangle を選択します。
[パートナー契約の署名方法] をクリックし、Pangleとの入札パートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
Pangleのマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得した App ID and Ad Placement IDを入力します。[完了] をクリックします。
重要:Pangle UI と同様に、 App ID は対象のアプリに関連付ける必要があります。ウォーターフォール
[広告ソース] セクションの [ウォーターフォール] カードで、[広告のソースを追加] を選択します。Pangle を選択します。
[Pangle] を選択します。 次に、Pangle の eCPM の値を入力し、[続行] をクリックします。Pangleのマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得した App ID and Ad Placement IDを入力します。[完了] をクリックします。
Step 3: Import the Pangle SDK and adapter
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.3.0")
implementation("com.google.ads.mediation:pangle:6.1.0.7.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
テスト広告を有効にする
AdMob にテストデバイスを登録し、 Pangle UI でテストモードを有効にします。
テスト広告を確認する
Pangleからテスト広告を受信していることを確認するには、広告インスペクタで Pangle (Bidding) and Pangle (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
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 | 1 |
Body | |
Icon | |
Call to action | |
Star rating | |
Store | |
Price | |
Advertiser |
1 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.getAdapterResponses()
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. |
Pangle Android Mediation Adapter Changelog
Version 6.1.0.7.0
- Verified compatibility with Pangle SDK version 6.1.0.7.
Built and tested with:
- Google Mobile Ads SDK version 23.2.0.
- Pangle SDK version 6.1.0.7.
Version 6.1.0.6.0
- Verified compatibility with Pangle SDK version 6.1.0.6.
Built and tested with:
- Google Mobile Ads SDK version 23.2.0.
- Pangle SDK version 6.1.0.6.
Version 6.0.0.8.0
- Verified compatibility with Pangle SDK version 6.0.0.8.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 6.0.0.8.
Version 6.0.0.7.0
- Verified compatibility with Pangle SDK version 6.0.0.7.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 6.0.0.7.
Version 6.0.0.5.0
- Verified compatibility with Pangle SDK version 6.0.0.5.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 6.0.0.5.
Version 6.0.0.4.0
- Verified compatibility with Pangle SDK version 6.0.0.4.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 6.0.0.4.
Version 6.0.0.3.0
- Verified compatibility with Pangle SDK version 6.0.0.3.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 6.0.0.3.
Version 5.9.0.6.0
- Verified compatibility with Pangle SDK version 5.9.0.6.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 5.9.0.6.
Version 5.9.0.5.0
- Verified compatibility with Pangle SDK version 5.9.0.5.
Built and tested with:
- Google Mobile Ads SDK version 23.1.0.
- Pangle SDK version 5.9.0.5.
Version 5.9.0.4.0
- Verified compatibility with Pangle SDK version 5.9.0.4.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Pangle SDK version 5.9.0.4.
Version 5.9.0.2.0
- Verified compatibility with Pangle SDK version 5.9.0.2.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Pangle SDK version 5.9.0.2.
Version 5.8.1.0.0
- Verified compatibility with Pangle SDK version 5.8.1.0.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Pangle SDK version 5.8.1.0.
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
andtargetSdkVersion
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.