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

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

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

Адаптер медиации AdMob для Pangle имеет следующие возможности:

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

Требования

  • Последняя версия Google Mobile Ads SDK
  • Флаттер 3.7.0 или выше
  • [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для Pangle 2.4.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.

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

Андроид iOS

Инструкции см. в шаге 2 руководства для Android .

Инструкции см. в шаге 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: ^2.0.0

Ручная интеграция

Загрузите последнюю версию плагина-посредника Google Mobile Ads для Pangle , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

Шаг 4. Добавьте необходимый код

Андроид iOS

Для интеграции с Pangle не требуется дополнительный код.

Интеграция со SKAdNetwork

Следуйте документации Pangle , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Шаг 5. Проверьте свою реализацию

Включить тестовые объявления

Убедитесь, что вы зарегистрировали свое тестовое устройство в AdMob и включили тестовый режим в пользовательском интерфейсе Pangle.

Проверьте тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от Pangle, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Pangle (Bidding) и Pangle (Waterfall) .

Коды ошибок

Если адаптеру не удается получить рекламу от Pangle, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo в следующих классах:

Андроид iOS 
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

GADMediationAdapterPangle

Вот коды и сопутствующие сообщения, выдаваемые адаптером Pangle, когда реклама не загружается:

Андроид iOS
Код ошибки Домен Причина
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.
Код ошибки Домен Причина
101 com.google.ads.mediation.pangle Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения).
102 com.google.ads.mediation.pangle Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Pangle.
-1-60000 Отправлено Pangle SDK Pangle SDK вернул ошибку. Дополнительную информацию см. в документации Pangle.

Список изменений адаптера Pangle Flutter Mediation

2.0.0

  • Проверенная совместимость с адаптером Pangle Android версии 6.4.0.6.0.
  • Подтверждена совместимость с адаптером Pangle iOS версии 6.4.1.1.0.
  • Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.3.1.

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.