В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Pangle с помощью медиации . и водопад, и торги интеграции. В нем рассказывается, как добавить Pangle в конфигурацию медиации рекламного блока и как интегрировать Pangle SDK и адаптер в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер-посредник для Pangle имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | |
Родной |
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью 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 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Шаг 3. Импортируйте Pangle SDK и адаптер.
Интеграция через pub.dev
(Только для Android) Добавьте следующие репозитории в файл build.gradle
внутри каталога android
вашего проекта:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Добавьте следующую зависимость с последними версиямиPangle SDK и адаптер в файле pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_pangle: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляPangle , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
Интеграция через pub.dev
(Только для Android) Добавьте следующие репозитории в файл build.gradle
внутри каталога android
вашего проекта:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Добавьте следующую зависимость с последними версиямиPangle SDK и адаптер в файле pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_pangle: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляPangle , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
Шаг 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 Flutter Mediation
Следующая версия
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.
2.0.0
- Проверенная совместимость с адаптером Pangle Android версии 6.1.0.9.0.
- Проверенная совместимость с адаптером Pangle iOS версии 6.2.0.5.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.1.0
- Проверенная совместимость с адаптером Pangle Android версии 5.9.0.4.0.
- Проверенная совместимость с адаптером Pangle iOS версии 5.9.0.7.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Pangle Android версии 5.8.0.9.0.
- Проверенная совместимость с адаптером Pangle iOS версии 5.8.0.8.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.