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 iOS 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
- iOS deployment target of 10.0 or higher
Latest Google Mobile Ads SDK
Complete the mediation Get started guide
Step 1: Set up configurations in Pangle UI
Зарегистрируйтесь или войдите в свою учетную запись Pangle.
Добавить новое приложение
Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .
Выберите операционную систему, для которой вы хотите создать приложение, и заполните остальную часть формы. Затем нажмите «Отправить» .
Запишите идентификатор приложения вашего приложения.
Создать место размещения рекламы
После создания приложения нажмите кнопку «Добавить» , чтобы создать место размещения рекламы.
Торги
Выберите формат объявления и название места размещения , а также выберите «Назначение ставок в приложении» в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Водопад
Выберите формат объявления и название места размещения , а также глобальную цену за тысячу показов в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Найдите ключ API отчетов Pangle
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Обратите внимание на идентификатор пользователя в левом нижнем углу страницы.
Нажмите «Интеграции» > «SDK и API» > «Pangle Reporting API 2.0» . Запишите идентификатор роли и ключ безопасности .
Включите тестовый режим
Следуйте инструкциям в руководстве Pangle « Как добавить тестовое объявление» о том, как включить тестовые объявления Pangle.
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 . ,В карточке «Ставки» в разделе «Источники объявлений» выберите «Добавить источник объявлений» . Затем выберите Pangle .
Нажмите «Как подписать партнерское соглашение и настроить торговое партнерство сPangle.
Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .
Если у вас уже есть сопоставление для Pangle, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .
Затем введите App ID and Ad Placement IDполученный в предыдущем разделе. Затем нажмите Готово .
Важно: App ID должен быть связан с целевым приложением, как в пользовательском интерфейсеPangle .Водопад
Под карточкой «Водопад» в разделе «Источники объявлений» выберите «Добавить источник объявлений» . Затем выберите Pangle .
Выберите Pangle .Затем введите значение эффективной цены за тысячу показов дляPangle и нажмите «Продолжить» .Если у вас уже есть сопоставление для Pangle, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .
Затем введите App ID and Ad Placement IDполученный в предыдущем разделе. Затем нажмите Готово .
Step 3: Import the Pangle SDK and adapter
Using CocoaPods (recommended)
Add the following line to your project's Podfile:
pod 'GoogleMobileAdsMediationPangle'
From the command line run:
pod install --repo-update
Manual integration
- Download the latest version of the
Pangle SDK for iOS
and link all the
.framework
files and bundles in your project. - Download the latest version of the Pangle adapter from the download link in
the Changelog and link
PangleAdapter.xcframework
in your project.
Step 4: Add required code
SKAdNetwork integration
Follow Pangle's documentation
to add the SKAdNetwork identifiers to your project's Info.plist
file.
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
GADNativeAd
objects. It populates the following
fields
for a
GADNativeAd
.
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
GADMediaView
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
GADResponseInfo.adNetworkInfoArray
under the following classes:
GADMediationAdapterPangle
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. |
-1-60000 | Sent by Pangle SDK | Pangle SDK returned an error. See Pangle's documentation for more details. |
Pangle iOS Mediation Adapter Changelog
Version 6.1.0.5.0
- Verified compatibility with Pangle SDK version 6.1.0.5.
Built and tested with:
- Google Mobile Ads SDK version 11.6.0.
- Pangle SDK version 6.1.0.5.
Version 6.1.0.4.0
- Verified compatibility with Pangle SDK version 6.1.0.4.
Built and tested with:
- Google Mobile Ads SDK version 11.6.0.
- Pangle SDK version 6.1.0.4.
Version 6.0.0.6.0
- Verified compatibility with Pangle SDK version 6.0.0.6.
Built and tested with:
- Google Mobile Ads SDK version 11.6.0.
- Pangle SDK version 6.0.0.6.
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 11.5.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 11.5.0.
- Pangle SDK version 6.0.0.4.
Version 5.9.0.9.0
- Verified compatibility with Pangle SDK version 5.9.0.9.
Built and tested with:
- Google Mobile Ads SDK version 11.5.0.
- Pangle SDK version 5.9.0.9.
Version 5.9.0.8.0
- Verified compatibility with Pangle SDK version 5.9.0.8.
Built and tested with:
- Google Mobile Ads SDK version 11.4.0.
- Pangle SDK version 5.9.0.8.
Version 5.9.0.7.0
- Verified compatibility with Pangle SDK version 5.9.0.7.
Built and tested with:
- Google Mobile Ads SDK version 11.3.0.
- Pangle SDK version 5.9.0.7.
Version 5.8.0.8.0
- Verified compatibility with Pangle SDK version 5.8.0.8.
- Updated adapter to use new Pangle SDK signal collection API.
Built and tested with:
- Google Mobile Ads SDK version 11.2.0.
- Pangle SDK version 5.8.0.8.
Version 5.8.0.7.0
- Verified compatibility with Pangle SDK version 5.8.0.7.
- Now requires minimum iOS version 12.0.
- Now requires Google Mobile Ads SDK version 11.0 or higher.
- Included
Info.plist
in the frameworks withinPangleAdapter.xcframework
.
Built and tested with:
- Google Mobile Ads SDK version 11.0.1.
- Pangle SDK version 5.8.0.7.
Version 5.7.0.7.0
- Verified compatibility with Pangle SDK version 5.7.0.7.
Built and tested with:
- Google Mobile Ads SDK version 10.14.0.
- Pangle SDK version 5.7.0.7.
Version 5.7.0.6.0
- Verified compatibility with Pangle SDK version 5.7.0.6.
Built and tested with:
- Google Mobile Ads SDK version 10.14.0.
- Pangle SDK version 5.7.0.6.
Version 5.6.0.8.0
- Verified compatibility with Pangle SDK version 5.6.0.8.
- Refactored the
+setCOPPA
method by replacing the deprecatedadConfiguration.childDirectedTreatment
property with the newGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
property.
Built and tested with:
- Google Mobile Ads SDK version 10.14.0.
- Pangle SDK version 5.6.0.8.
Version 5.5.0.9.0
- Verified compatibility with Pangle SDK version 5.5.0.9.
Built and tested with:
- Google Mobile Ads SDK version 10.13.0.
- Pangle SDK version 5.5.0.9.
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 10.12.0.
- Pangle SDK version 5.5.0.7.
Version 5.5.0.5.0
- Verified compatibility with Pangle SDK version 5.5.0.5.
Built and tested with:
- Google Mobile Ads SDK version 10.11.0.
- Pangle SDK version 5.5.0.5.
Version 5.4.1.1.0
- Added bidding support for app open ad format.
- Verified compatibility with Pangle SDK version 5.4.1.1.
Built and tested with:
- Google Mobile Ads SDK version 10.10.0.
- Pangle SDK version 5.4.1.1.
Version 5.4.0.9.0
- Verified compatibility with Pangle SDK version 5.4.0.9.
Built and tested with:
- Google Mobile Ads SDK version 10.9.0.
- Pangle SDK version 5.4.0.9.
Version 5.4.0.8.0
- Fixed an issue where
GADPangleNetworkExtras
did not conform toGADAdNetworkExtras
protocol. - Implemented
adDidShowFail
protocol method in interstitial, rewarded, and app open ads. - Verified compatibility with Pangle SDK version 5.4.0.8.
Built and tested with:
- Google Mobile Ads SDK version 10.9.0.
- Pangle SDK version 5.4.0.8.
Version 5.3.1.2.0
- Verified compatibility with Pangle SDK version 5.3.1.2.
Built and tested with:
- Google Mobile Ads SDK version 10.8.0.
- Pangle SDK version 5.3.1.2.
Version 5.3.1.0.0
- Verified compatibility with Pangle SDK version 5.3.1.0.
Built and tested with:
- Google Mobile Ads SDK version 10.8.0.
- Pangle SDK version 5.3.1.0.
Version 5.2.1.1.0
- Verified compatibility with Pangle SDK version 5.2.1.1.
Built and tested with:
- Google Mobile Ads SDK version 10.7.0.
- Pangle SDK version 5.2.1.1.
Version 5.2.0.9.0
- Verified compatibility with Pangle SDK version 5.2.0.9.
Built and tested with:
- Google Mobile Ads SDK version 10.5.0.
- Pangle SDK version 5.2.0.9.
Version 5.2.0.8.0
- Verified compatibility with Pangle SDK version 5.2.0.8.
Built and tested with:
- Google Mobile Ads SDK version 10.5.0.
- Pangle SDK version 5.2.0.8.
Version 5.2.0.7.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.7.
Built and tested with:
- Google Mobile Ads SDK version 10.5.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 10.5.0.
- Pangle SDK version 5.2.0.6.
Version 5.1.1.0.0
- Verified compatibility with Pangle SDK version 5.1.1.0.
- Added support for the
arm64
simulator architecture. - Now requires Google Mobile Ads SDK version 10.4.0 or higher.
Built and tested with:
- Google Mobile Ads SDK version 10.4.0.
- Pangle SDK version 5.1.1.0.
Version 5.1.0.6.0
- Verified compatibility with Pangle SDK version 5.1.0.6.
Built and tested with:
- Google Mobile Ads SDK version 10.3.0.
- Pangle SDK version 5.1.0.6.
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 10.2.0.
- Pangle SDK version 5.0.1.0.
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 10.2.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 10.1.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 10.1.0.
- Pangle SDK version 5.0.0.6.
Version 4.9.1.0.0
- Removed support for the
armv7
architecture. - Verified compatibility with Pangle SDK version 4.9.1.0.
- Now requires minimum iOS version of 12.0.
- Now requires Google Mobile Ads SDK version 10.0.0 or higher.
Built and tested with:
- Google Mobile Ads SDK version 10.0.0.
- Pangle SDK version 4.9.1.0.
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 9.14.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 9.14.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 9.14.0.
- Pangle SDK version 4.9.0.6.
Version 4.8.1.0.0
- Verified compatibility with Pangle SDK version 4.8.1.0.
Built and tested with:
- Google Mobile Ads SDK version 9.14.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 9.13.0.
- Pangle SDK version 4.8.0.9.
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 9.13.0.
- Pangle SDK version 4.8.0.7.
Version 4.8.0.6.0
- Verified compatibility with Pangle SDK version 4.8.0.6.
- Fixed an issue where the main thread was blocked when loading native ad icon image.
Built and tested with:
- Google Mobile Ads SDK version 9.13.0.
- Pangle SDK version 4.8.0.6.
Version 4.7.0.7.0
- Verified compatibility with Pangle SDK version 4.7.0.7.
Built and tested with:
- Google Mobile Ads SDK version 9.11.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 9.11.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 9.11.0.
- Pangle SDK version 4.7.0.5.
Version 4.7.0.4.0
- Verified compatibility with Pangle SDK version 4.7.0.4.
Built and tested with:
- Google Mobile Ads SDK version 9.10.0.
- Pangle SDK version 4.7.0.4.
Version 4.6.2.2.0
- Renamed the
setGDPR()
andsetCCPA()
methods from theGADMediationAdapterPangle
class tosetGDPRConsent()
andsetDoNotSell
respectively. - Verified compatibility with Pangle SDK version 4.6.2.2.
Built and tested with:
- Google Mobile Ads SDK version 9.10.0.
- Pangle SDK version 4.6.2.2.
Version 4.6.1.8.0
- Verified compatibility with Pangle SDK version 4.6.1.8.
- Added bidding support for native ad format.
- Updated the adapter to use the
didRewardUser
API. - Now requires Google Mobile Ads SDK version 9.8.0 or higher.
Built and tested with:
- Google Mobile Ads SDK version 9.9.0.
- Pangle SDK version 4.6.1.8.
Version 4.5.2.8.0
- Verified compatibility with Pangle SDK version 4.5.2.8.
Built and tested with:
- Google Mobile Ads SDK version 9.7.0.
- Pangle SDK version 4.5.2.8.
Version 4.5.2.7.0
- Verified compatibility with Pangle SDK version 4.5.2.7.
Built and tested with:
- Google Mobile Ads SDK version 9.7.0.
- Pangle SDK version 4.5.2.7.
Version 4.5.2.5.0
- Verified compatibility with Pangle SDK version 4.5.2.5.
Built and tested with:
- Google Mobile Ads SDK version 9.6.0.
- Pangle SDK version 4.5.2.5.
Version 4.5.2.4.0
- Verified compatibility with Pangle SDK version 4.5.2.4.
Built and tested with:
- Google Mobile Ads SDK version 9.6.0.
- Pangle SDK version 4.5.2.4.
Version 4.5.2.3.0
- Verified compatibility with Pangle SDK version 4.5.2.3.
Built and tested with:
- Google Mobile Ads SDK version 9.6.0.
- Pangle SDK version 4.5.2.3.
Version 4.5.1.3.0
- Verified compatibility with Pangle SDK version 4.5.1.3.
Built and tested with:
- Google Mobile Ads SDK version 9.5.0.
- Pangle SDK version 4.5.1.3.
Version 4.3.1.9.0
- Verified compatibility with Pangle SDK version 4.3.1.9.
Built and tested with:
- Google Mobile Ads SDK version 9.3.0.
- Pangle SDK version 4.3.1.9.
Version 4.3.0.5.0
- Verified compatibility with Pangle SDK version 4.3.0.5.
Built and tested with:
- Google Mobile Ads SDK version 9.2.0.
- Pangle SDK version 4.3.0.5.
Version 4.3.0.4.0
- Initial release!
- Added bidding support for banner (includes MREC), interstitial and rewarded ad formats.
Built and tested with:
- Google Mobile Ads SDK version 9.1.0.
- Pangle SDK version 4.3.0.4.