Эта страница переведена с помощью Cloud Translation API.

Интегрируйте Pangle с назначением ставок

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

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

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

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

¹ Интеграция Waterfall находится в стадии открытого бета-тестирования.

² Интеграция ставок для этого формата находится на стадии открытого бета-тестирования.

Требования

Android API уровня 21 или выше
[Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер Pangle 5.5.0.4.0 или выше ( рекомендуется последняя версия ).

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

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

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

Шаг 2. Настройте спрос Pangle в интерфейсе Менеджера рекламы.

Войдите в свою учетную запись Менеджера рекламы .

Добавьте Pangle в компании

Торги

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

Водопад

Перейдите в «Администратор» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите Рекламную сеть .

Выберите Pangle в качестве рекламной сети , введите уникальное имя и включите посредничество .

Вам не нужно вводить имя пользователя или пароль . Нажмите «Сохранить», когда закончите.

Включить безопасный обмен сигналами

Торги

Перейдите в «Администратор» > «Глобальные настройки» . Перейдите на вкладку настроек аккаунта Ad Exchange , проверьте и включите параметр «Безопасный обмен сигналами» . Нажмите Сохранить .

Водопад

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

Делитесь защищенным сигналом по запросам ставок

Торги

Перейдите в «Инвентарь» > «Защитные сигналы» . В разделе «Безопасные сигналы » найдите Pangle DSP и включите «Включить интеграцию приложений» .

Нажмите Сохранить .

Водопад

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

Разрешить безопасный обмен сигналами для назначения ставок через SDK

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для назначения ставок через SDK» .

Нажмите Сохранить .

Водопад

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

Настройка ставок Pangle

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите «Перейти к назначению ставок SDK» .

Нажмите Новый участник торгов .

Выберите Pangle в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить назначение ставок SDK для этой системы назначения ставок.

Нажмите Готово .

Водопад

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

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите «Перейти к назначению ставок SDK» .

Выберите компанию для Pangle.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Новое сопоставление рекламных блоков» .

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

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите мобильное приложение .

Прокрутите вниз и нажмите «Добавить партнера по доходности» .

Выберите компанию, которую вы создали для Pangle в предыдущем разделе. Выберите «Медиация Mobile SDK» в качестве типа интеграции , Android в качестве платформы и «Активный» в качестве статуса .

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts уровня проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

Затем в файл build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии Pangle SDK и адаптера:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:pangle:6.4.0.6.0")
}

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

Загрузите последнюю версию Pangle SDK для Android , извлеките файл open_ad_sdk.aar из папки загруженного архива и добавьте его в свой проект.
Перейдите к артефактам адаптера Pangle в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера Pangle и добавьте его в свой проект.

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

Обфускация ProGuard

Если вы используете ProGuard для запутывания кода Android, следуйте инструкциям в документации Pangle, чтобы гарантировать, что код Pangle SDK не запутывается.

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

Вот коды и сопутствующие сообщения, выдаваемые адаптером 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.