本頁面由 Cloud Translation API 翻譯而成。

將 Pangle 與中介服務整合

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.

Supported integrations and ad formats

The AdMob mediation adapter for Pangle has the following capabilities:

Integration
Bidding
Waterfall
Formats
App open	¹
Banner
Interstitial
Rewarded
Rewarded Interstitial
Native

¹ Bidding integration for this format is in closed beta.

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

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 to create your ad placement.

Bidding

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.

Waterfall

Select your Ad Format and Ad Placement Name, and Global CPM 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.

Locate Pangle Reporting API key

Bidding

This step isn't required for bidding integrations.

Waterfall

Take note of the User ID at the bottom left corner of the page.

Click Integrations > SDK & API > Pangle Reporting API 2.0. Take note of Role ID and Security Key.

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 AdMob UI

調整廣告單元中介服務設定

您需要將 Pangle 新增至廣告單元的中介服務設定。

首先，請登入 AdMob 帳戶。接著，前往「中介服務」分頁。如果您想修改現有的中介服務群組，請按一下中介服務群組的名稱加以編輯，然後跳到「新增為廣告來源」一節。 Pangle

如要建立新的中介服務群組，請選取「建立中介服務群組」。

輸入廣告格式和平台，然後按一下「繼續」。

為中介服務群組命名，然後選取要指定的地區。接著，將中介服務群組狀態設為「已啟用」，然後按一下「新增廣告單元」。

將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」。

您現在應該會看到已填入所選廣告單元的廣告單元資訊卡：

新增 Pangle 做為廣告來源

出價

在「廣告來源」區段的「出價」資訊卡下方，選取「新增廣告來源」。然後選取 Pangle。

按一下「如何簽署合作夥伴協議」，並與Pangle建立出價合作夥伴關係。

按一下「確認並同意」，然後點選「繼續」。

如果 Pangle已有對應關係，可以選取該對應關係。否則請按一下「新增對應」。

接著，輸入上一節取得的 App ID and Ad Placement ID。接著點選「完成」。

重要事項： App ID 必須與Pangle UI 中的指定應用程式建立關聯。

瀑布

在「Ad Source」部分的「Waterfall」資訊卡下方，選取「Add Ad Source」。然後選取 Pangle。

選取「Pangle」。接著為Pangle 輸入有效千次曝光出價值，然後按一下「繼續」。

如果 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.0.0")
    implementation("com.google.ads.mediation:pangle:5.9.0.2.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 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您正在接收來自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

¹ 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.

Pangle Android Mediation Adapter Changelog

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 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.