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

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

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

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

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

Требования

  • Последняя версия 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 в Ad Manager пользовательский интерфейс

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

Андроид

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