Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

Требования

Android API уровня 23 или выше

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

Найдите ключ 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 для своего приложения .

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

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

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

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

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

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

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

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

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

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

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

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

Добавить Pangle в качестве источника рекламы

Торги

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

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

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

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

Затем введите идентификатор приложения и идентификатор места размещения рекламы, полученные в предыдущем разделе. Нажмите «Готово» .

Водопад

На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

Выберите Pangle . Введите значение eCPM для Pangle и нажмите «Продолжить» .

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

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

Шаг 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:24.4.0")
    implementation("com.google.ads.mediation:pangle:7.3.0.3.0")
}

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

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

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

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

Адаптер Pangle предоставляет метод PangleMediationAdapter.setGDPRConsent() , который передаёт информацию о согласии адаптеру Pangle, а затем в Pangle SDK. В следующем примере кода показано, как передать информацию о согласии в Pangle SDK. Задайте информацию о согласии до инициализации Google Mobile Ads SDK, чтобы обеспечить её корректную передачу в Pangle SDK.

Ява

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT);

Котлин

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT)

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

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

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

Адаптер Pangle предоставляет метод PangleMediationAdapter.setPAConsent() , который передаёт информацию о согласии адаптеру Pangle, а затем в Pangle SDK. В следующем примере кода показано, как передать информацию о согласии в Pangle SDK. Задайте информацию о согласии до инициализации Google Mobile Ads SDK, чтобы гарантировать её корректную передачу в Pangle SDK.

Ява

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

Котлин

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

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

Обфускация ProGuard

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

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

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

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

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

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