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

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

Выберите платформу: Android (бета-версия)

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

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

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

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

Требования

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

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

Новейший Google Mobile Ads SDK
Заполните руководство по началу медиации.

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

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

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

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

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

Запишите идентификатор приложения (App ID) .

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

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

Торги

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

После создания рекламного места запишите идентификатор рекламного места (Ad Placement ID) .

Водопад

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

После создания рекламного места запишите идентификатор рекламного места (Ad Placement ID) .

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

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

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

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

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

Далее введите идентификатор приложения (App ID) и идентификатор места размещения рекламы (Ad Placement ID) , полученные в предыдущем разделе. Затем нажмите «Готово» .

Водопад

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

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

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

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

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

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

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

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

В файл gradle на уровне приложения добавьте следующие зависимости реализации:

Котлин

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

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.1.0'
    implementation 'com.google.ads.mediation:pangle:7.9.1.2.0'
}

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

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

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

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

Начиная с версии Pangle SDK 7.9.0.9, Pangle автоматически считывает согласия GDPR, установленные платформами управления согласием, поддерживающими спецификацию Google Additional Consent , включая UMP SDK .

Законы штатов США о защите частной жизни

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

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

Java

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)

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

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

Обфускация ProGuard

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

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

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

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

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

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

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

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

Отображение рекламы

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

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

¹ The Pangle adapter does not provide direct access to the main image asset for its native ads. Instead, the adapter populates the MediaView with a video or an image.

коды ошибок

Если адаптер не получает объявление от 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	SDK Pangle вернул ошибку. Дополнительные сведения см. в документации Pangle.