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

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

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

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

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

Требования

  • Цель развертывания iOS 10.0 или выше

Шаг 1. Настройте конфигурации в пользовательском интерфейсе Pangle.

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

Вам необходимо добавить Pangle в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Далее перейдите на вкладку «Медиация» . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к пункту «Добавить Pangle в качестве источника объявлений ».

Чтобы создать новую группу медиации, выберите Создать группу медиации .

Введите формат объявления и платформу, затем нажмите «Продолжить» .

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

Свяжите эту группу медиации с одним или несколькими существующими рекламными блокамиAdMob . Затем нажмите Готово .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Pangle в качестве источника объявления.

Торги

В карточке «Ставки» в разделе «Источники объявлений» выберите «Добавить источник объявлений» . Затем выберите Pangle .

Нажмите «Как подписать партнерское соглашение и настроить торговое партнерство сPangle.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Pangle, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .

Затем введите App ID and Ad Placement IDполученный в предыдущем разделе. Затем нажмите Готово .

Важно: App ID должен быть связан с целевым приложением, как в пользовательском интерфейсеPangle .

,

В карточке «Ставки» в разделе «Источники объявлений» выберите «Добавить источник объявлений» . Затем выберите Pangle .

Нажмите «Как подписать партнерское соглашение и настроить торговое партнерство сPangle.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Pangle, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .

Затем введите App ID and Ad Placement IDполученный в предыдущем разделе. Затем нажмите Готово .

Важно: App ID должен быть связан с целевым приложением, как в пользовательском интерфейсеPangle .

Водопад

Под карточкой «Водопад» в разделе «Источники объявлений» выберите «Добавить источник объявлений» . Затем выберите Pangle .

Выберите Pangle .Затем введите значение эффективной цены за тысячу показов дляPangle и нажмите «Продолжить» .

Если у вас уже есть сопоставление для Pangle, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .

Затем введите App ID and Ad Placement IDполученный в предыдущем разделе. Затем нажмите Готово .

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

  • Добавьте следующую строку в подфайл вашего проекта:

    pod 'GoogleMobileAdsMediationPangle'
    
  • Из командной строки выполните:

    pod install --repo-update

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

  • Загрузите последнюю версию Pangle SDK для iOS и свяжите все файлы .framework и пакеты в своем проекте.
  • Загрузите последнюю версию адаптера Pangle по ссылке в журнале изменений и свяжите PangleAdapter.xcframework с вашим проектом.

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

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

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

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

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

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

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

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

Дополнительные шаги

Нативная реклама

Рендеринг рекламы

Адаптер Pangle возвращает собственные объявления в виде объектовGADNativeAd. Он заполняет следующие поляполядляGADNativeAd .

Поле Ресурсы всегда включены в адаптер Pangle
Заголовок
Изображение 1
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

1 Адаптер Pangle не обеспечивает прямой доступ к основному изображению для собственных объявлений. Вместо этого адаптер заполняетGADMediaViewвидео или изображением.

Коды ошибок

Если адаптеру не удается получить рекламу от Pangle, вы можете проверить основную ошибку из ответа на рекламу, используяGADResponseInfo.adNetworkInfoArray в следующих классах:

GADMediationAdapterPangle

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

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

Журнал изменений адаптера медиации Pangle iOS

Версия 5.9.0.7.0

  • Проверенная совместимость с Pangle SDK версии 5.9.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.3.0.
  • Pangle SDK версии 5.9.0.7.

Версия 5.8.0.8.0

  • Проверенная совместимость с Pangle SDK версии 5.8.0.8.
  • Обновлен адаптер для использования нового API сбора сигналов Pangle SDK.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.2.0.
  • Pangle SDK версии 5.8.0.8.

Версия 5.8.0.7.0

  • Проверенная совместимость с Pangle SDK версии 5.8.0.7.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Info.plist включен в рамки PangleAdapter.xcframework .

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.0.1.
  • Pangle SDK версии 5.8.0.7.

Версия 5.7.0.7.0

  • Проверенная совместимость с Pangle SDK версии 5.7.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • Pangle SDK версии 5.7.0.7.

Версия 5.7.0.6.0

  • Проверена совместимость с Pangle SDK версии 5.7.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • Pangle SDK версии 5.7.0.6.

Версия 5.6.0.8.0

  • Проверенная совместимость с Pangle SDK версии 5.6.0.8.
  • Выполнен рефакторинг метода +setCOPPA , заменив устаревшее свойство adConfiguration.childDirectedTreatment новым свойством GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment .

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • Pangle SDK версии 5.6.0.8.

Версия 5.5.0.9.0

  • Проверенная совместимость с Pangle SDK версии 5.5.0.9.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.13.0.
  • Pangle SDK версии 5.5.0.9.

Версия 5.5.0.7.0

  • Проверенная совместимость с Pangle SDK версии 5.5.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.12.0.
  • Pangle SDK версии 5.5.0.7.

Версия 5.5.0.5.0

  • Проверенная совместимость с Pangle SDK версии 5.5.0.5.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.11.0.
  • Pangle SDK версии 5.5.0.5.

Версия 5.4.1.1.0

  • Добавлена ​​поддержка ставок для формата объявлений при открытии приложения.
  • Проверенная совместимость с Pangle SDK версии 5.4.1.1.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.10.0.
  • Pangle SDK версии 5.4.1.1.

Версия 5.4.0.9.0

  • Проверенная совместимость с Pangle SDK версии 5.4.0.9.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.9.0.
  • Pangle SDK версии 5.4.0.9.

Версия 5.4.0.8.0

  • Исправлена ​​проблема, из-за которой GADPangleNetworkExtras не соответствовал протоколу GADAdNetworkExtras .
  • Реализован метод протокола adDidShowFail в межстраничных объявлениях, объявлениях с вознаграждением и объявлениях при запуске приложения.
  • Проверенная совместимость с Pangle SDK версии 5.4.0.8.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.9.0.
  • Pangle SDK версии 5.4.0.8.

Версия 5.3.1.2.0

  • Проверенная совместимость с Pangle SDK версии 5.3.1.2.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.8.0.
  • Pangle SDK версии 5.3.1.2.

Версия 5.3.1.0.0

  • Проверенная совместимость с Pangle SDK версии 5.3.1.0.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.8.0.
  • Pangle SDK версии 5.3.1.0.

Версия 5.2.1.1.0

  • Проверенная совместимость с Pangle SDK версии 5.2.1.1.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.7.0.
  • Pangle SDK версии 5.2.1.1.

Версия 5.2.0.9.0

  • Проверенная совместимость с Pangle SDK версии 5.2.0.9.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.5.0.
  • Pangle SDK версии 5.2.0.9.

Версия 5.2.0.8.0

  • Проверенная совместимость с Pangle SDK версии 5.2.0.8.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.5.0.
  • Pangle SDK версии 5.2.0.8.

Версия 5.2.0.7.0

  • Добавлена ​​каскадная поддержка форматов открытой рекламы, баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативных объявлений.
  • Проверенная совместимость с Pangle SDK версии 5.2.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.5.0.
  • Pangle SDK версии 5.2.0.7.

Версия 5.2.0.6.0

  • Проверенная совместимость с Pangle SDK версии 5.2.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.5.0.
  • Pangle SDK версии 5.2.0.6.

Версия 5.1.1.0.0

  • Проверенная совместимость с Pangle SDK версии 5.1.1.0.
  • Добавлена ​​поддержка архитектуры симулятора arm64 .
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.4.0.
  • Pangle SDK версии 5.1.1.0.

Версия 5.1.0.6.0

  • Проверенная совместимость с Pangle SDK версии 5.1.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.3.0.
  • Pangle SDK версии 5.1.0.6.

Версия 5.0.1.0.0

  • Проверенная совместимость с Pangle SDK версии 5.0.1.0.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.2.0.
  • Pangle SDK версии 5.0.1.0.

Версия 5.0.0.8.0

  • Проверенная совместимость с Pangle SDK версии 5.0.0.8.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.2.0.
  • Pangle SDK версии 5.0.0.8.

Версия 5.0.0.7.0

  • Проверенная совместимость с Pangle SDK версии 5.0.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.1.0.
  • Pangle SDK версии 5.0.0.7.

Версия 5.0.0.6.0

  • Проверенная совместимость с Pangle SDK версии 5.0.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.1.0.
  • Pangle SDK версии 5.0.0.6.

Версия 4.9.1.0.0

  • Удалена поддержка архитектуры armv7 .
  • Проверенная совместимость с Pangle SDK версии 4.9.1.0.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.0.0.
  • Pangle SDK версии 4.9.1.0.

Версия 4.9.0.8.0

  • Проверенная совместимость с Pangle SDK версии 4.9.0.8.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.14.0.
  • Pangle SDK версии 4.9.0.8.

Версия 4.9.0.7.0

  • Проверенная совместимость с Pangle SDK версии 4.9.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.14.0.
  • Pangle SDK версии 4.9.0.7.

Версия 4.9.0.6.0

  • Проверена совместимость с Pangle SDK версии 4.9.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.14.0.
  • Pangle SDK версии 4.9.0.6.

Версия 4.8.1.0.0

  • Проверенная совместимость с Pangle SDK версии 4.8.1.0.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.14.0.
  • Pangle SDK версии 4.8.1.0.

Версия 4.8.0.9.0

  • Проверена совместимость с Pangle SDK версии 4.8.0.9.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.13.0.
  • Pangle SDK версии 4.8.0.9.

Версия 4.8.0.7.0

  • Проверенная совместимость с Pangle SDK версии 4.8.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.13.0.
  • Pangle SDK версии 4.8.0.7.

Версия 4.8.0.6.0

  • Проверенная совместимость с Pangle SDK версии 4.8.0.6.
  • Исправлена ​​проблема, из-за которой основной поток блокировался при загрузке изображения значка собственного объявления.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.13.0.
  • Pangle SDK версии 4.8.0.6.

Версия 4.7.0.7.0

  • Проверенная совместимость с Pangle SDK версии 4.7.0.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.11.0.
  • Pangle SDK версии 4.7.0.7.

Версия 4.7.0.6.0

  • Проверенная совместимость с Pangle SDK версии 4.7.0.6.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.11.0.
  • Pangle SDK версии 4.7.0.6.

Версия 4.7.0.5.0

  • Проверенная совместимость с Pangle SDK версии 4.7.0.5.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.11.0.
  • Pangle SDK версии 4.7.0.5.

Версия 4.7.0.4.0

  • Проверенная совместимость с Pangle SDK версии 4.7.0.4.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.10.0.
  • Pangle SDK версии 4.7.0.4.

Версия 4.6.2.2.0

  • Методы setGDPR() и setCCPA() из класса GADMediationAdapterPangle переименованы в setGDPRConsent() и setDoNotSell соответственно.
  • Проверенная совместимость с Pangle SDK версии 4.6.2.2.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.10.0.
  • Pangle SDK версии 4.6.2.2.

Версия 4.6.1.8.0

  • Проверенная совместимость с Pangle SDK версии 4.6.1.8.
  • Добавлена ​​поддержка ставок для собственного формата объявлений.
  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.9.0.
  • Pangle SDK версии 4.6.1.8.

Версия 4.5.2.8.0

  • Проверенная совместимость с Pangle SDK версии 4.5.2.8.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.7.0.
  • Pangle SDK версии 4.5.2.8.

Версия 4.5.2.7.0

  • Проверенная совместимость с Pangle SDK версии 4.5.2.7.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.7.0.
  • Pangle SDK версии 4.5.2.7.

Версия 4.5.2.5.0

  • Проверенная совместимость с Pangle SDK версии 4.5.2.5.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.6.0.
  • Pangle SDK версии 4.5.2.5.

Версия 4.5.2.4.0

  • Проверенная совместимость с Pangle SDK версии 4.5.2.4.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.6.0.
  • Pangle SDK версии 4.5.2.4.

Версия 4.5.2.3.0

  • Проверенная совместимость с Pangle SDK версии 4.5.2.3.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.6.0.
  • Pangle SDK версии 4.5.2.3.

Версия 4.5.1.3.0

  • Проверенная совместимость с Pangle SDK версии 4.5.1.3.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.5.0.
  • Pangle SDK версии 4.5.1.3.

Версия 4.3.1.9.0

  • Проверенная совместимость с Pangle SDK версии 4.3.1.9.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.3.0.
  • Pangle SDK версии 4.3.1.9.

Версия 4.3.0.5.0

  • Проверенная совместимость с Pangle SDK версии 4.3.0.5.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.2.0.
  • Pangle SDK версии 4.3.0.5.

Версия 4.3.0.4.0

  • Изначальный выпуск!
  • Добавлена ​​поддержка ставок для форматов баннеров (включая MREC), межстраничных объявлений и объявлений с вознаграждением.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.1.0.
  • Pangle SDK версии 4.3.0.4.