@react-native-google-mobile-ads/pangle
v17.4.0
Published
Pangle (ByteDance) Google Mobile Ads (GAM) mediation adapter for react-native-google-mobile-ads. Links the official Google mediation adapter on Android and iOS; does not add JS ad APIs.
Readme
@react-native-google-mobile-ads/pangle
Pangle (ByteDance) Google Ad Manager / AdMob mediation adapter package for react-native-google-mobile-ads.
This package links Google’s official Pangle mediation adapter on Android and iOS. It does not ship AppLovin MAX, CloudX, or any JS ad APIs — use core initialize() / adapter status for discovery.
Install
yarn add @react-native-google-mobile-ads/pangle
# peer: react-native-google-mobile-adsAutolinking pulls in the native mediation artifacts. Rebuild the app after install.
Android Maven repository (required)
Google’s Pangle GAM adapter depends on com.pangle.global:pag-sdk, which is hosted on ByteDance Maven (not Maven Central). This package adds that repository in its Android module. If your app uses dependencyResolutionManagement / FAIL_ON_PROJECT_REPOS, also add the repo in your project settings.gradle(.kts) as shown in Google’s guide:
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}Native adapter class names (GAM / AdMob UI)
| Platform | Class name |
| -------- | -------------------------------------------------------- |
| Android | com.google.ads.mediation.pangle.PangleMediationAdapter |
| iOS | GADMediationAdapterPangle |
Also exported from JS:
import { nativeAdapterClassName, networkSlug } from '@react-native-google-mobile-ads/pangle';Mediation dependencies (pinned in this package)
| Platform | Coordinate | Version pin |
| -------- | ------------------------------------------ | ----------- |
| Android | com.google.ads.mediation:pangle | 8.3.0.4.0 |
| iOS | CocoaPods GoogleMobileAdsMediationPangle | 8.3.0.8.0 |
Citations (verify at upgrade time):
- Android (GAM): https://developers.google.com/ad-manager/mobile-ads-sdk/android/mediation/pangle
- iOS (GAM): https://developers.google.com/ad-manager/mobile-ads-sdk/ios/mediation/pangle
- CocoaPods: https://cocoapods.org/pods/GoogleMobileAdsMediationPangle
Core continues to own play-services-ads / Google-Mobile-Ads-SDK. This package does not re-pin the GMA SDK.
Platform floors align with core: iOS 15.1 and Android minSdk 24.
Google’s mediation guide permits Android minSdk 23 upstream; this product advertises 24 to match core.
Expo (optional)
// app.json / app.config.js plugins
[
'@react-native-google-mobile-ads/pangle',
{
// Pass Pangle SKAdNetwork IDs from Pangle’s current docs
skAdNetworkItems: [
/* ... */
],
},
];App IDs stay in the core Expo plugin.
Lifecycle
This package does not add JS ad APIs. Use core fullscreen / native / multi-format / pool destroy() (and hook ownership rules) when you finish with inventory — see the core Migrating to v17 lifecycle section and Mediation — Pangle.
Do not dual-host Pangle by linking Ads-Global (or another direct Pangle React Native module) and this mediation adapter / Google Mobile Ads in the same app unless you intentionally own that stack. iOS Auto Layout conflicts inside video creatives (UIButton trailing vs UIImageView) are upstream creative / SDK layout, not a missing destroy method on this adapter.
Out of scope
- AppLovin MAX host SDK
- CloudX / other non-GAM hosts
- Fyber/DT Exchange (no Google GAM adapter — do not invent)
- Direct Pangle (ByteDance) SDK hosting or a second JS destroy API beyond core
