В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Pangle с помощью медиации . и водопад, и торги интеграции. В нем рассказывается, как добавить Pangle в конфигурацию медиации рекламного блока и как интегрировать Pangle SDK и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер-посредник для Pangle имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением |
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 5.6 или выше
- [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для Pangle 2.4.0 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Pangle.
Зарегистрируйтесь или войдите в свою учетную запись Pangle.
Добавить новое приложение
Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .
Выберите операционную систему, для которой вы хотите создать приложение, и заполните остальную часть формы. Затем нажмите «Отправить» .
Андроид
iOS
Запишите идентификатор приложения вашего приложения.
Андроид
iOS
Создать место размещения рекламы
После создания приложения нажмите кнопку «Добавить» , чтобы создать место размещения рекламы.
Андроид
iOS
Торги
Выберите формат объявления и название места размещения , а также выберите «Назначение ставок в приложении» в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Андроид
iOS
Водопад
Выберите формат объявления и название места размещения , а также глобальную цену за тысячу показов в качестве типа ценообразования . Заполните остальную часть формы и нажмите «Отправить» .
После создания места размещения объявления запишите его идентификатор .
Андроид
iOS
Найдите ключ API отчетов Pangle
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Обратите внимание на идентификатор пользователя в левом нижнем углу страницы.
Нажмите «Интеграции» > «SDK и API» > «Pangle Reporting API 2.0» . Запишите идентификатор роли и ключ безопасности .
Включите тестовый режим
Следуйте инструкциям в руководстве Pangle «Как добавить тестовое объявление » о том, как включить тестовые объявления Pangle.
Шаг 2. Настройте спрос Pangle в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3. Импортируйте Pangle SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Pangle Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.pangle
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads Pangle Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для Pangle по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsPangleMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsPangleMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Добавьте необходимый код
Андроид
Для интеграции с Pangle не требуется дополнительный код.
iOS
Интеграция со SKAdNetwork
Следуйте документации Pangle , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в AdMob и включили тестовый режим в пользовательском интерфейсе Pangle.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Pangle, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Pangle (Bidding) и Pangle (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Pangle, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Вот коды и сопутствующие сообщения, выдаваемые адаптером Pangle, когда реклама не загружается:
Андроид
Код ошибки | Домен | Причина |
---|---|---|
101 | com.google.ads.mediation.pangle | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения). |
102 | com.google.ads.mediation.pangle | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Pangle. |
103 | com.google.ads.mediation.pangle | Отсутствует или недействителен ответ на заявку. |
-1-60000 | com.pangle.ads | Pangle SDK вернул ошибку. Дополнительную информацию см. в документации Pangle. |
iOS
Код ошибки | Домен | Причина |
---|---|---|
101 | com.google.ads.mediation.pangle | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения). |
102 | com.google.ads.mediation.pangle | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Pangle. |
-1-60000 | Отправлено Pangle SDK | Pangle SDK вернул ошибку. Дополнительную информацию см. в документации Pangle. |
Журнал изменений плагина Pangle Unity Mediation
Версия 4.4.1
- Поддерживает адаптер Pangle Android версии 6.3.0.4.0 .
- Поддерживает адаптер Pangle iOS версии 6.3.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 4.4.0
- Поддерживает адаптер Pangle Android версии 6.3.0.2.0 .
- Поддерживает адаптер Pangle iOS версии 6.3.0.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 4.3.3
- Поддерживает адаптер Pangle Android версии 6.2.0.7.0 .
- Поддерживает адаптер Pangle iOS версии 6.2.0.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.1.
Версия 4.3.2
- Поддерживает адаптер Pangle Android версии 6.2.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 6.2.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.3.1
- Поддерживает адаптер Pangle Android версии 6.2.0.5.0 .
- Поддерживает адаптер Pangle iOS версии 6.2.0.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.3.0
- Поддерживает адаптер Pangle Android версии 6.2.0.4.0 .
- Поддерживает адаптер Pangle iOS версии 6.2.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.2.1
- Поддерживает адаптер Pangle Android версии 6.1.0.7.0 .
- Поддерживает адаптер Pangle iOS версии 6.1.0.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.2.0
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер Pangle Android версии 6.1.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 6.1.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.1.0
- Поддерживает адаптер Pangle Android версии 6.0.0.8.0 .
- Поддерживает адаптер Pangle iOS версии 6.1.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 4.0.1
- Поддерживает адаптер Pangle Android версии 6.0.0.5.0 .
- Поддерживает адаптер Pangle iOS версии 6.0.0.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 4.0.0
- Поддерживает адаптер Pangle Android версии 6.0.0.5.0 .
- Поддерживает адаптер Pangle iOS версии 6.0.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.0.0
- Поддерживает адаптер Pangle Android версии 6.0.0.3.0 .
- Поддерживает адаптер Pangle iOS версии 5.9.0.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 2.8.1
- Поддерживает адаптер Pangle Android версии 5.9.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 5.9.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 2.8.0
- Поддерживает адаптер Pangle Android версии 5.9.0.4.0 .
- Поддерживает адаптер Pangle iOS версии 5.9.0.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 2.7.0
- Поддерживает адаптер Pangle Android версии 5.9.0.2.0 .
- Поддерживает адаптер Pangle iOS версии 5.8.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 2.6.0
- Поддерживает адаптер Pangle Android версии 5.8.0.9.0 .
- Поддерживает адаптер Pangle iOS версии 5.8.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.5.0
- Поддерживает адаптер Pangle Android версии 5.7.0.1.0 .
- Поддерживает адаптер Pangle iOS версии 5.7.0.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.4.0
- Поддерживает адаптер Pangle Android версии 5.5.0.9.0 .
- Поддерживает адаптер Pangle iOS версии 5.5.0.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.3.0
- Поддерживает адаптер Pangle Android версии 5.3.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 5.3.1.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.4.1.
Версия 2.2.0
- Поддерживает адаптер Pangle Android версии 5.2.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 5.2.0.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 2.1.0
- Поддерживает адаптер Pangle Android версии 5.1.0.9.0 .
- Поддерживает адаптер Pangle iOS версии 5.1.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 2.0.0
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/Pangle/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.Pangle
. - Поддерживает адаптер Pangle Android версии 5.0.0.7.0 .
- Поддерживает адаптер Pangle iOS версии 5.0.0.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.5.1
- Поддерживает адаптер Pangle Android версии 4.9.0.7.0 .
- Поддерживает адаптер Pangle iOS версии 4.9.0.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.0.
Версия 1.5.0
- Поддерживает адаптер Pangle Android версии 4.9.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 4.9.0.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 1.4.0
- Поддерживает адаптер Pangle Android версии 4.8.1.0.0 .
- Поддерживает адаптер Pangle iOS версии 4.8.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 1.3.1
- Поддерживает адаптер Pangle Android версии 4.7.0.6.0 .
- Поддерживает адаптер Pangle iOS версии 4.7.0.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 1.3.0
- Переименованы следующие методы в классе
Pangle
:-
SetGDPR()
->SetGDPRConsent()
-
SetCCPA()
->SetDoNotSell()
-
- Поддерживает адаптер Pangle Android версии 4.7.0.5.0 .
- Поддерживает адаптер Pangle iOS версии 4.7.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 1.2.0
- Поддерживает адаптер Pangle Android версии 4.5.0.6.1 .
- Поддерживает адаптер Pangle iOS версии 4.5.2.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.1.0.
Версия 1.1.0
- Поддерживает адаптер Pangle Android версии 4.5.0.3.0 .
- Поддерживает адаптер Pangle iOS версии 4.5.1.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер Pangle Android версии 4.3.0.8.0 .
- Поддерживает адаптер Pangle iOS версии 4.3.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.