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

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

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

This guide covers using GMA Next-Gen SDK with AdMob Mediation to show ads from Pangle in both waterfall and bidding configurations. You learn to add Pangle to your ad unit settings and integrate its SDK and adapter into your Android app.

Для использования источников назначения ставок Pangle US или Pangle KR создайте сопоставления источников рекламы для Pangle US и Pangle KR .

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

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

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

^1. Доступные источники рекламы в Pangle включают Pangle US, Pangle KR и Pangle ROW.

^2. Этот формат не поддерживается для следующих источников рекламы Pangle: Pangle US.

Интеграция ^Pangle US (торги) и Pangle KR (торги) находится в закрытой бета-версии. Для получения доступа обратитесь к своему менеджеру по работе с клиентами.

Предварительные требования

Прежде чем продолжить, проверьте следующее:

Android API уровня 24 или более поздней версии.

[Для участия в аукционе Pangle в США]: Используйте адаптер Pangle версии 7.2.0.2 или выше.
[Для ставок Pangle KR и Pangle ROW]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте адаптер Pangle версии 5.5.0.4.0 или более поздней ( рекомендуется последняя версия ).

Последняя версия GMA Next-Gen SDK .
Настройте медиацию AdMob .

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

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

Торги

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

Водопад

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

Click Integrations > SDK & API > Pangle Reporting API 2.0 . Take note of Role ID and Security Key .

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

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, set up an app-ads.txt file for your app .

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

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

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

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

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

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

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add Pangle as an ad source .

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

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

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

Associate this mediation group with one or more of your existing AdMob ad units. Then click Done .

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

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

Пэнгл, американские торги

Важно : Вы настраиваете источник рекламы для размещения ставок в Pangle US. Это сопоставление рекламных блоков предназначено только для Pangle US и не будет автоматически перенаправлять запросы на показ рекламы в другие источники рекламы Pangle.

В разделе «Источники рекламы» найдите карточку «Торги» и выберите «Добавить источник рекламы» . Затем выберите Pangle US SDK.
Select Acknowledge & agree , then select Save . For more information, see ad sources that support bidding and require setup with Pangle US.
Если у вас уже есть сопоставление для Pangle US, вы можете его выбрать. В противном случае выберите «Добавить сопоставление» .
Введите идентификатор приложения и идентификатор размещения рекламы, полученные в предыдущем разделе, а затем нажмите «Готово» .
Important : The App ID must be associated with the targeted app as in the Pangle UI.

Торги Пэнгл КР

Важно : Вы настраиваете источник рекламы для размещения ставок в Pangle KR. Это сопоставление рекламных блоков предназначено только для Pangle KR и не будет автоматически перенаправлять запросы на показ рекламы в другие источники рекламы Pangle.

In the Ad Sources section, find the Bidding card and select Add ad source . Then select Pangle KR SDK.
Выберите «Подтвердить и согласиться» , затем выберите «Сохранить» . Для получения дополнительной информации см. раздел «Источники рекламы, поддерживающие назначение ставок и требующие настройки в Pangle KR».
If you already have a mapping for Pangle KR, you can select it. Otherwise, select Add mapping .
Enter the App ID and Ad Placement ID obtained in the previous section, and then select Done .
Important : The App ID must be associated with the targeted app as in the Pangle UI.

Pangle ROW Bidding

Important : You are setting up a bidding ad source for Pangle ROW. This ad unit mapping is only for Pangle ROW and won't automatically forward ad requests to other Pangle bidding ad sources.

In the Ad Sources section, find the Bidding card and select Add ad source . Then select Pangle ROW SDK.
Select Acknowledge & agree , then select Save . For more information, see ad sources that support bidding and require setup with Pangle ROW.
Если у вас уже есть сопоставление для строки Pangle, вы можете его выбрать. В противном случае выберите «Добавить сопоставление» .
Enter the App ID and Ad Placement ID obtained in the previous section, and then select Done .
Important : The App ID must be associated with the targeted app as in the Pangle UI.

Водопад

Under the Waterfall card in the Ad Sources section, select Add Ad Source .

Select Pangle . Then enter an eCPM value for Pangle and click Continue .

If you already have a mapping for Pangle, you can select it. Otherwise, click Add mapping .

Next, enter the App ID and Ad Placement ID obtained in the previous section. Then click Done .

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

Follow the steps in European regulations settings and US state regulations settings to add Pangle DSP to the European and US state regulations ad partners list in the AdMob UI.

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

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

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

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

In your app-level gradle file, add the following implementation dependencies and configurations:

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:pangle:8.2.0.4.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1'
    implementation 'com.google.ads.mediation:pangle:8.2.0.4.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

Согласие ЕС и GDPR

В соответствии с Политикой 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. Установите информацию о согласии до инициализации GMA Next-Gen SDK чтобы гарантировать ее корректную передачу в SDK Pangle.

Java

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);PangleMediationSnippets.java

Котлин

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)PangleMediationSnippets.kt

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

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

Обфускация ProGuard

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

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

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

Make sure you register your test device for AdMob and enable test mode in Pangle UI.

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

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

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

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

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

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

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

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

коды ошибок

If the adapter fails to receive an ad from Pangle, you can check the underlying error from the ad response using ResponseInfo.getAdSourceResponses() under the following classes:

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.