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

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

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

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

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

Требования

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

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

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

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

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

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

Андроид

iOS

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

Андроид

iOS

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

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

Андроид

iOS

Торги

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

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

Андроид

iOS

Водопад

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

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

Андроид

iOS

Обновите файл app-ads.txt

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

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

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

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

Шаг 2: Настройте спрос Pangle в пользовательском интерфейсе Менеджера объявлений

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

Андроид

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

Выберите пакет Google Mobile Ads Pangle Mediation и нажмите «Установить» .

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для Pangle по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsPangleMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsPangleMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Сила Решения

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

Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (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: Проверьте свою реализацию

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в Pangle UI.

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

Чтобы убедиться, что вы получаете тестовые объявления от 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

Версия 5.3.0

Версия 5.2.2

Версия 5.2.1

Версия 5.2.0

Версия 5.1.1

Версия 5.1.0

Версия 5.0.0

Версия 4.6.2

Версия 4.6.1

Версия 4.6.0

Версия 4.5.4

Версия 4.5.3

Версия 4.5.2

Версия 4.5.1

Версия 4.5.0

Версия 4.4.2

Версия 4.4.1

Версия 4.4.0

Версия 4.3.3

Версия 4.3.2

Версия 4.3.1

Версия 4.3.0

Версия 4.2.1

Версия 4.2.0

Версия 4.1.0

Версия 4.0.1

Версия 4.0.0

Версия 3.0.0

Версия 2.8.1

Версия 2.8.0

Версия 2.7.0

Версия 2.6.0

Версия 2.5.0

Версия 2.4.0

Версия 2.3.0

Версия 2.2.0

Версия 2.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

Версия 1.5.0

Версия 1.4.0

Версия 1.3.1

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0