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

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Открыть приложение
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

Требования

  • Последняя версия Google Mobile Ads SDK
  • Flutter 3.7.0 или выше
  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы объявлений в торги, используйте плагин-медиатор Google Mobile Ads для Pangle 2.4.0 или выше ( рекомендуется последняя версия )
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начать» .
  • Завершите посредничество . Руководство по началу работы.

Шаг 1: Настройка конфигураций в Pangle UI

Зарегистрируйтесь или войдите в свою учетную запись Pangle.

Добавить новое приложение

Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .

Выберите операционную систему, для которой вы хотите создать приложение, и заполните оставшуюся часть формы. Затем нажмите «Отправить» .

андроид

iOS

Запишите идентификатор приложения вашего приложения.

андроид

iOS

Создать рекламное место размещения

После создания заявки нажмите кнопку «Добавить» , чтобы создать место размещения рекламы.

андроид

iOS

Торги

Выберите формат рекламы и название размещения рекламы , а также выберите In-App Bidding в качестве типа ценообразования . Заполните оставшуюся часть формы и нажмите «Отправить» .

После создания места размещения рекламы запишите идентификатор места размещения рекламы .

андроид

iOS

Водопад

Выберите ваш Формат рекламы и Имя размещения рекламы , а также Глобальный CPM как Тип ценообразования . Заполните остальную часть формы и нажмите Отправить .

После создания места размещения рекламы запишите идентификатор места размещения рекламы .

андроид

iOS

Найдите ключ API Pangle Reporting

Торги

Этот шаг не требуется для интеграции торгов.

Водопад

Обратите внимание на идентификатор пользователя в левом нижнем углу страницы.

Нажмите Интеграция > SDK и API > Pangle Reporting API 2.0 . Запишите идентификатор роли и ключ безопасности .

Обновите свой app-ads.txt

Авторизованные продавцы приложений app-ads.txt — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам нужно будет внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Чтобы реализовать app-ads.txt для Pangle, см. раздел Как добавить Pangle в файл app-ads.txt .

Включить тестовый режим

Следуйте инструкциям в руководстве Pangle «Как добавить тестовое объявление», чтобы включить тестовые объявления Pangle.

Шаг 2: Настройте спрос Pangle в пользовательском интерфейсе AdMob

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

андроид

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

iOS

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

Добавьте Pangle DSP в список рекламных партнеров GDPR и государственных нормативных актов США

Следуйте инструкциям в настройках европейских и государственных нормативных актов США, чтобы добавить Pangle DSP в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе AdMob.

Шаг 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: ^

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

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

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

Шаг 4: Реализуйте настройки конфиденциальности в Pangle SDK

В соответствии с Политикой согласия пользователей ЕС Google вы должны гарантировать, что определенные раскрытия информации предоставляются и согласия получены от пользователей в Европейской экономической зоне (ЕЭЗ) относительно использования идентификаторов устройств и персональных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента по защите данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, и предоставить информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя таким сетям.

Плагин медиации Google Mobile Ads для Pangle включает метод Pangle.SetGDPRConsent() . Следующий пример кода показывает, как передать информацию о согласии в Pangle SDK. Установите информацию о согласии до инициализации Google Mobile Ads SDK, чтобы гарантировать, что они будут правильно переданы в Pangle SDK.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

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

Законы США о конфиденциальности

Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как закон определяет эти термины), с возможностью отказа через заметную ссылку «Не продавайте мою личную информацию» на домашней странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия.

Плагин медиации Google Mobile Ads для Pangle включает метод Pangle.SetPAConsent() . Следующий пример кода показывает, как передать информацию о согласии в Pangle SDK. Установите информацию о согласии до инициализации Google Mobile Ads SDK, чтобы гарантировать, что они будут правильно перенаправлены в Pangle SDK.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

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

Шаг 5: Добавьте требуемый код

андроид

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

iOS

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в 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

Версия 2.2.0

Версия 2.1.0

Версия 2.0.0

Версия 1.1.0

Версия 1.0.0