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

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Pangle с помощью медиации , охватывая интеграцию как каскадной модели, так и биддинга. В нём также рассказывается, как добавить 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» в качестве типа ценообразования . Заполните оставшуюся часть формы и нажмите «Отправить» .

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

Водопад

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

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

Обновите файл 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 в пользовательском интерфейсе Менеджера объявлений

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

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

Торги

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

Водопад

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

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

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

Торги

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

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

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

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

Водопад

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

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

Торги

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

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

Водопад

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

Настроить ставки Pangle

Торги

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

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

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

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в 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.