В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Pangle с помощью Медиация Рекламы в приложении ,охватывающую интеграцию каскада и ставок. В нем рассказывается, как добавить Pangle в конфигурацию медиации рекламного блока и как интегрировать Pangle SDK и адаптер в iOS приложение.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для Pangle имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Приложение открыто | 1 |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | |
Родной |
Требования
- Цель развертывания iOS 10.0 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Pangle.
Зарегистрируйтесь или войдите в свою учетную запись Pangle.
Добавить новое приложение
Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .
Выберите операционную систему, для которой вы хотите создать приложение, и заполните остальную часть формы. Затем нажмите «Отправить» .
Запишите идентификатор приложения вашего приложения.
Создать место размещения рекламы
После создания приложения нажмите кнопку «Добавить» , чтобы создать место размещения рекламы.
Торги
Выберите формат объявления и название места размещения , а также выберите «Назначение ставок в приложении» в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Водопад
Выберите формат объявления и название места размещения , а также глобальную цену за тысячу показов в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Найдите ключ API отчетов Pangle
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Обратите внимание на идентификатор пользователя в левом нижнем углу страницы.
Нажмите «Интеграции» > «SDK и API» > «Pangle Reporting API 2.0» . Запишите идентификатор роли и ключ безопасности .
Включите тестовый режим
Следуйте инструкциям в руководстве Pangle « Как добавить тестовое объявление» о том, как включить тестовые объявления Pangle.
Шаг 2. Настройте спрос Pangle в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Вам необходимо добавить 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полученный в предыдущем разделе. Затем нажмите Готово .
Шаг 3. Импортируйте Pangle SDK и адаптер.
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в подфайл вашего проекта:
pod 'GoogleMobileAdsMediationPangle'
Из командной строки выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию Pangle SDK для iOS и свяжите все файлы
.framework
и пакеты в своем проекте. - Загрузите последнюю версию адаптера Pangle по ссылке в журнале изменений и свяжите
PangleAdapter.xcframework
с вашим проектом.
Шаг 4. Добавьте необходимый код
Интеграция со SKAdNetwork
Следуйте документации Pangle , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе Pangle .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отPangle, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Pangle (Bidding) and Pangle (Waterfall) .
Дополнительные шаги
Нативная реклама
Рендеринг рекламы
Адаптер Pangle возвращает нативную рекламу в видеGADNativeAd
объекты. Он заполняет следующиеполядляGADNativeAd
.
Поле | Ресурсы всегда включены в адаптер Pangle |
---|---|
Заголовок | |
Изображение | 1 |
Тело | |
Икона | |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена | |
Рекламодатель |
1 Адаптер Pangle не обеспечивает прямой доступ к основному изображению для собственных объявлений. Вместо этого адаптер заполняетGADMediaView
с видео или изображением.
Коды ошибок
Если адаптеру не удается получить рекламу от Pangle, вы можете проверить основную ошибку из ответа на рекламу, используяGADResponseInfo.adNetworkInfoArray
в следующих классах:
GADMediationAdapterPangle
Вот коды и сопутствующие сообщения, выдаваемые адаптером Pangle, когда реклама не загружается:
Код ошибки | Домен | Причина |
---|---|---|
101 | com.google.ads.mediation.pangle | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения). |
102 | com.google.ads.mediation.pangle | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Pangle. |
-1-60000 | Отправлено Pangle SDK | Pangle SDK вернул ошибку. Дополнительную информацию см. в документации Pangle. |
Журнал изменений адаптера медиации Pangle iOS
Версия 6.1.0.6.0
- Проверенная совместимость с Pangle SDK версии 6.1.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.7.0.
- Pangle SDK версии 6.1.0.6.
Версия 6.1.0.5.0
- Проверенная совместимость с Pangle SDK версии 6.1.0.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.6.0.
- Pangle SDK версии 6.1.0.5.
Версия 6.1.0.4.0
- Проверенная совместимость с Pangle SDK версии 6.1.0.4.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.6.0.
- Pangle SDK версии 6.1.0.4.
Версия 6.0.0.6.0
- Проверенная совместимость с Pangle SDK версии 6.0.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.6.0.
- Pangle SDK версии 6.0.0.6.
Версия 6.0.0.5.0
- Проверенная совместимость с Pangle SDK версии 6.0.0.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.5.0.
- Pangle SDK версии 6.0.0.5.
Версия 6.0.0.4.0
- Проверенная совместимость с Pangle SDK версии 6.0.0.4.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.5.0.
- Pangle SDK версии 6.0.0.4.
Версия 5.9.0.9.0
- Проверенная совместимость с Pangle SDK версии 5.9.0.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.5.0.
- Pangle SDK версии 5.9.0.9.
Версия 5.9.0.8.0
- Проверенная совместимость с Pangle SDK версии 5.9.0.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.4.0.
- Pangle SDK версии 5.9.0.8.
Версия 5.9.0.7.0
- Проверенная совместимость с Pangle SDK версии 5.9.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.3.0.
- Pangle SDK версии 5.9.0.7.
Версия 5.8.0.8.0
- Проверенная совместимость с Pangle SDK версии 5.8.0.8.
- Обновлен адаптер для использования нового API сбора сигналов Pangle SDK.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.2.0.
- Pangle SDK версии 5.8.0.8.
Версия 5.8.0.7.0
- Проверенная совместимость с Pangle SDK версии 5.8.0.7.
- Теперь требуется минимальная версия iOS 12.0.
- Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
-
Info.plist
включен в рамкиPangleAdapter.xcframework
.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.0.1.
- Pangle SDK версии 5.8.0.7.
Версия 5.7.0.7.0
- Проверенная совместимость с Pangle SDK версии 5.7.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.14.0.
- Pangle SDK версии 5.7.0.7.
Версия 5.7.0.6.0
- Проверенная совместимость с Pangle SDK версии 5.7.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.14.0.
- Pangle SDK версии 5.7.0.6.
Версия 5.6.0.8.0
- Проверенная совместимость с Pangle SDK версии 5.6.0.8.
- Выполнен рефакторинг метода
+setCOPPA
, заменив устаревшее свойствоadConfiguration.childDirectedTreatment
новым свойствомGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.14.0.
- Pangle SDK версии 5.6.0.8.
Версия 5.5.0.9.0
- Проверенная совместимость с Pangle SDK версии 5.5.0.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.13.0.
- Pangle SDK версии 5.5.0.9.
Версия 5.5.0.7.0
- Проверенная совместимость с Pangle SDK версии 5.5.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.12.0.
- Pangle SDK версии 5.5.0.7.
Версия 5.5.0.5.0
- Проверенная совместимость с Pangle SDK версии 5.5.0.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.11.0.
- Pangle SDK версии 5.5.0.5.
Версия 5.4.1.1.0
- Добавлена поддержка ставок для формата объявлений при открытии приложения.
- Проверенная совместимость с Pangle SDK версии 5.4.1.1.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.10.0.
- Pangle SDK версии 5.4.1.1.
Версия 5.4.0.9.0
- Проверенная совместимость с Pangle SDK версии 5.4.0.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.9.0.
- Pangle SDK версии 5.4.0.9.
Версия 5.4.0.8.0
- Исправлена проблема, из-за которой
GADPangleNetworkExtras
не соответствовал протоколуGADAdNetworkExtras
. - Реализован метод протокола
adDidShowFail
в межстраничных объявлениях, объявлениях с вознаграждением и объявлениях при запуске приложения. - Проверена совместимость с Pangle SDK версии 5.4.0.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.9.0.
- Pangle SDK версии 5.4.0.8.
Версия 5.3.1.2.0
- Проверенная совместимость с Pangle SDK версии 5.3.1.2.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.8.0.
- Pangle SDK версии 5.3.1.2.
Версия 5.3.1.0.0
- Проверенная совместимость с Pangle SDK версии 5.3.1.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.8.0.
- Pangle SDK версии 5.3.1.0.
Версия 5.2.1.1.0
- Проверенная совместимость с Pangle SDK версии 5.2.1.1.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.7.0.
- Pangle SDK версии 5.2.1.1.
Версия 5.2.0.9.0
- Проверенная совместимость с Pangle SDK версии 5.2.0.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.5.0.
- Pangle SDK версии 5.2.0.9.
Версия 5.2.0.8.0
- Проверенная совместимость с Pangle SDK версии 5.2.0.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.5.0.
- Pangle SDK версии 5.2.0.8.
Версия 5.2.0.7.0
- Добавлена каскадная поддержка форматов открытой рекламы, баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативных объявлений.
- Проверенная совместимость с Pangle SDK версии 5.2.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.5.0.
- Pangle SDK версии 5.2.0.7.
Версия 5.2.0.6.0
- Проверенная совместимость с Pangle SDK версии 5.2.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.5.0.
- Pangle SDK версии 5.2.0.6.
Версия 5.1.1.0.0
- Проверенная совместимость с Pangle SDK версии 5.1.1.0.
- Добавлена поддержка архитектуры симулятора
arm64
. - Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.4.0.
- Pangle SDK версии 5.1.1.0.
Версия 5.1.0.6.0
- Проверенная совместимость с Pangle SDK версии 5.1.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.3.0.
- Pangle SDK версии 5.1.0.6.
Версия 5.0.1.0.0
- Проверенная совместимость с Pangle SDK версии 5.0.1.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.2.0.
- Pangle SDK версии 5.0.1.0.
Версия 5.0.0.8.0
- Проверенная совместимость с Pangle SDK версии 5.0.0.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.2.0.
- Pangle SDK версии 5.0.0.8.
Версия 5.0.0.7.0
- Проверенная совместимость с Pangle SDK версии 5.0.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.1.0.
- Pangle SDK версии 5.0.0.7.
Версия 5.0.0.6.0
- Проверенная совместимость с Pangle SDK версии 5.0.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.1.0.
- Pangle SDK версии 5.0.0.6.
Версия 4.9.1.0.0
- Удалена поддержка архитектуры
armv7
. - Проверенная совместимость с Pangle SDK версии 4.9.1.0.
- Теперь требуется минимальная версия iOS 12.0.
- Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.0.0.
- Pangle SDK версии 4.9.1.0.
Версия 4.9.0.8.0
- Проверенная совместимость с Pangle SDK версии 4.9.0.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.14.0.
- Pangle SDK версии 4.9.0.8.
Версия 4.9.0.7.0
- Проверенная совместимость с Pangle SDK версии 4.9.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.14.0.
- Pangle SDK версии 4.9.0.7.
Версия 4.9.0.6.0
- Проверенная совместимость с Pangle SDK версии 4.9.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.14.0.
- Pangle SDK версии 4.9.0.6.
Версия 4.8.1.0.0
- Проверенная совместимость с Pangle SDK версии 4.8.1.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.14.0.
- Pangle SDK версии 4.8.1.0.
Версия 4.8.0.9.0
- Проверена совместимость с Pangle SDK версии 4.8.0.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.13.0.
- Pangle SDK версии 4.8.0.9.
Версия 4.8.0.7.0
- Проверенная совместимость с Pangle SDK версии 4.8.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.13.0.
- Pangle SDK версии 4.8.0.7.
Версия 4.8.0.6.0
- Проверенная совместимость с Pangle SDK версии 4.8.0.6.
- Исправлена проблема, из-за которой основной поток блокировался при загрузке изображения значка собственного объявления.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.13.0.
- Pangle SDK версии 4.8.0.6.
Версия 4.7.0.7.0
- Проверенная совместимость с Pangle SDK версии 4.7.0.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.11.0.
- Pangle SDK версии 4.7.0.7.
Версия 4.7.0.6.0
- Проверенная совместимость с Pangle SDK версии 4.7.0.6.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.11.0.
- Pangle SDK версии 4.7.0.6.
Версия 4.7.0.5.0
- Проверенная совместимость с Pangle SDK версии 4.7.0.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.11.0.
- Pangle SDK версии 4.7.0.5.
Версия 4.7.0.4.0
- Проверенная совместимость с Pangle SDK версии 4.7.0.4.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.10.0.
- Pangle SDK версии 4.7.0.4.
Версия 4.6.2.2.0
- Методы
setGDPR()
иsetCCPA()
из классаGADMediationAdapterPangle
переименованы вsetGDPRConsent()
иsetDoNotSell
соответственно. - Проверенная совместимость с Pangle SDK версии 4.6.2.2.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.10.0.
- Pangle SDK версии 4.6.2.2.
Версия 4.6.1.8.0
- Проверенная совместимость с Pangle SDK версии 4.6.1.8.
- Добавлена поддержка ставок для собственного формата объявлений.
- Обновлен адаптер для использования API
didRewardUser
. - Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.9.0.
- Pangle SDK версии 4.6.1.8.
Версия 4.5.2.8.0
- Проверенная совместимость с Pangle SDK версии 4.5.2.8.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.7.0.
- Pangle SDK версии 4.5.2.8.
Версия 4.5.2.7.0
- Проверенная совместимость с Pangle SDK версии 4.5.2.7.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.7.0.
- Pangle SDK версии 4.5.2.7.
Версия 4.5.2.5.0
- Проверенная совместимость с Pangle SDK версии 4.5.2.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.6.0.
- Pangle SDK версии 4.5.2.5.
Версия 4.5.2.4.0
- Проверенная совместимость с Pangle SDK версии 4.5.2.4.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.6.0.
- Pangle SDK версии 4.5.2.4.
Версия 4.5.2.3.0
- Проверенная совместимость с Pangle SDK версии 4.5.2.3.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.6.0.
- Pangle SDK версии 4.5.2.3.
Версия 4.5.1.3.0
- Проверенная совместимость с Pangle SDK версии 4.5.1.3.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.5.0.
- Pangle SDK версии 4.5.1.3.
Версия 4.3.1.9.0
- Проверенная совместимость с Pangle SDK версии 4.3.1.9.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.3.0.
- Pangle SDK версии 4.3.1.9.
Версия 4.3.0.5.0
- Проверенная совместимость с Pangle SDK версии 4.3.0.5.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.2.0.
- Pangle SDK версии 4.3.0.5.
Версия 4.3.0.4.0
- Первый выпуск!
- Добавлена поддержка ставок для форматов баннеров (включая MREC), межстраничных объявлений и объявлений с вознаграждением.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.1.0.
- Pangle SDK версии 4.3.0.4.