이 페이지는 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 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

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.

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

Ad Manager 계정에 로그인합니다.

회사에 Pangle 추가

입찰

이 단계는 입찰 통합에는 필요하지 않습니다.

폭포

관리 > 회사로 이동한 다음 모든 회사 탭에서 새 회사 버튼을 클릭합니다. 광고 네트워크를 선택합니다.

Pangle을 광고 네트워크로 선택하고 고유한 이름을 입력한 다음 미디에이션을 사용 설정합니다.

사용자 이름 또는 비밀번호는 입력하지 않아도 됩니다. 완료되면 저장을 클릭합니다.

보안 처리된 신호 공유 사용 설정

입찰

관리 > 전체 설정으로 이동합니다. Ad Exchange 계정 설정 탭으로 이동하여 검토하고 보안 처리된 신호 공유를 사용 설정합니다. 저장을 클릭합니다.

폭포

이 단계는 폭포식 구조 통합에는 필요하지 않습니다.

입찰 Pangle 구성

입찰

게재 > 입찰자로 이동하고 SDK 입찰 탭에서 새 입찰자를 클릭합니다.

Pangle를 입찰자로 선택합니다.

이 입찰자의 신호 라이브러리를 허용된 신호 목록에 추가 및 신호가 이 입찰자와 공유되도록 허용을 사용 설정합니다. 그런 다음 계속을 클릭합니다.

계속을 클릭합니다.

완료를 클릭합니다.

폭포

이 단계는 폭포식 구조 통합에는 필요하지 않습니다.

광고 단위 매핑 구성

입찰

게재 > 입찰자로 이동하고 SDK 입찰 탭에서Pangle 의 회사를 선택합니다.

광고 단위 매핑 탭으로 이동하여 새 광고 단위 매핑을 클릭합니다.

특정 광고 단위를 선택합니다. 광고 단위와 형식, 모바일 앱을 인벤토리 유형으로, 모바일 애플리케이션을 선택합니다. 그런 다음 이전 섹션에서 가져온App ID and Ad Placement ID 을 입력합니다. 마지막으로 저장을 클릭합니다.

폭포

게재 > 수익 그룹으로 이동하여 새 수익 그룹 버튼을 클릭합니다. 모바일 애플리케이션을 선택합니다.

아래로 스크롤하여 수익 파트너 추가를 클릭합니다.

이전 섹션에서 만든 Pangle 회사를 선택합니다. 통합 유형으로 모바일 SDK 미디에이션을, 플랫폼으로 Android, 상태로 활성을 선택합니다.

이전 섹션에서 가져온 App ID and Ad Placement ID와 기본 CPM 값을 입력합니다. Save를 클릭합니다.

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.1.0")
    implementation("com.google.ads.mediation:pangle:5.9.0.5.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

테스트 광고 사용 설정

Ad Manager 용 테스트 기기를 등록하고 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

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