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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

Найдите ключ 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, вы можете выбрать его. В противном случае нажмите Добавить сопоставление .

Далее введите App ID и Ad Placement ID, полученные в предыдущем разделе. Затем нажмите Done .

Водопад

Под карточкой Waterfall в разделе Ad Sources выберите Add Ad Source . Затем выберите Pangle .

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

Далее введите App ID и Ad Placement ID, полученные в предыдущем разделе. Затем нажмите Done .

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

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

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

CocoaPods (рекомендуется)

Добавьте следующую строку в Podfile вашего проекта:
```
pod 'GoogleMobileAdsMediationPangle'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Загрузите последнюю версию Pangle SDK для iOS и свяжите все файлы и пакеты .framework в вашем проекте.
Загрузите последнюю версию адаптера Pangle по ссылке в журнале изменений и добавьте PangleAdapter.xcframework в свой проект.

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

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

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

Быстрый

import PangleAdapter
// ...

GADMediationAdapterPangle.setGDPRConsent(0)

Objective-C

#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setGDPRConsent:0];

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

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

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

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

Быстрый

import PangleAdapter
// ...

GADMediationAdapterPangle.setPAConsent(0)

Objective-C

#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setPAConsent:0];

Шаг 5: Добавьте требуемый код

Интеграция SKAdNetwork

Следуйте документации Pangle , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

GADMediationAdapterPangle

Вот коды и сопутствующие сообщения, выдаваемые адаптером Pangle, когда реклама не загружается:

Код ошибки	Домен	Причина
101	com.google.ads.mediation.pangle	Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор размещения).
102	com.google.ads.mediation.pangle	Запрошенный размер объявления не соответствует поддерживаемому Pangle размеру баннера.
-1-60000	Отправлено Pangle SDK	Pangle SDK вернул ошибку. Подробности смотрите в документации Pangle.