Интегрируйте Pangle с медиацией

Примечание. См. документацию Pangle для регионов, которые поддерживает Pangle.

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Pangle с помощью медиации . торги интеграции. В нем рассказывается, как добавить Pangle в конфигурацию медиации рекламного блока и как интегрировать Pangle SDK и адаптер в Unity приложение.

Поддерживаемые интеграции и форматы объявлений

Ad Manager Адаптер-посредник для Pangle имеет следующие возможности:

Интеграция
Торги
Водопад	^1
Форматы
Баннер
Межстраничный
Награжден
Межстраничное объявление с вознаграждением

¹ Интеграция Waterfall находится на стадии закрытого бета-тестирования.

Требования

• Последняя версия Google Mobile Ads SDK
• Unity 5.6 или выше
• Развертывание на 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 в Ad Manager пользовательский интерфейс

Настройте параметры медиации для своего рекламного блока

Андроид

Инструкции см. в шаге 2 руководства поАндроид .

iOS

Инструкции см. в шаге 2 руководства поiOS .

Шаг 3. Импортируйте Pangle SDK и адаптер.

Примечание. Невозможность интеграции совместимых версий Pangle и Google Mobile Ads SDK может привести к проблемам при сборке.

OpenUPM-CLI

Важно! Если вы переходите с использования пакета .unitypackage на использование OpenUPM-CLI, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/Mediation/Pangle .

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Pangle Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.pangle

ОпенУПМ

Важно! Если вы переходите с использования пакета .unitypackage на использование OpenUPM, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/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.

Важно: отключите тестовый режим для 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.