В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из PubMatic с помощью AdMob Mediation , включая интеграцию с аукционами. В нём также рассказывается, как добавить PubMatic в конфигурацию медиации рекламного блока и как интегрировать PubMatic SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор AdMob для PubMatic обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Открыть приложение | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 2019.4 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройка конфигураций в пользовательском интерфейсе PubMatic
Войдите в свою учетную запись PubMatic и выберите карту OpenWrap SDK .
Добавить новое приложение
Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .
Выберите платформу , а также URL-адрес App Store и название приложения для вашего приложения.
Андроид
В разделе «Путь интеграции» выберите Unity , а затем выберите AdMob - SDK Bidding в качестве дополнительного пути интеграции . Затем нажмите кнопку «Добавить приложение» .
iOS
В разделе «Путь интеграции» выберите Unity , а затем выберите AdMob - SDK Bidding в качестве дополнительного пути интеграции . Затем нажмите кнопку «Добавить приложение» .
Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .
Перед тем, как ваше приложение будет завершено, вам будут представлены соответствующие записи для добавления в app-ads.txt .
Дополнительную информацию о том, как реализовать app-ads.txt для PubMatic, см. в разделе Как реализовать app-ads.txt .
Идентификатор профиля
После создания приложения перейдите на вкладку «Приложения» и запишите идентификатор профиля вашего нового приложения.
Создать рекламный блок
На вкладке «Рекламные блоки» выберите приложение, созданное в предыдущем разделе, и нажмите кнопку «Создать рекламный блок» .
Заполните форму данными о вашем рекламном блоке и нажмите кнопку Сохранить .
Запишите новый идентификатор рекламного блока OpenWrap .
Получите свой идентификатор издателя
Перейдите на панель аналитики . Наведите курсор на значок профиля и запишите свой идентификатор .
Шаг 2: Настройте спрос PubMatic в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте PubMatic в список рекламных партнеров, соответствующих GDPR и государственным нормам США.
Следуйте инструкциям в настройках европейских и государственных нормативных актов США , чтобы добавить PubMatic в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе AdMob.
Шаг 3: Импортируйте PubMatic SDK и адаптер
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин-посредник Google Mobile Ads PubMatic OpenWrap SDK для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.pubmaticOpenUPM
В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .
На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:
- Имя:
OpenUPM - URL-адрес:
https://package.openupm.com - Область(ы):
com.google
Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.
Выберите пакет Google Mobile Ads PubMatic Mediation и нажмите «Установить» .
Пакет Unity
Загрузите последнюю версию плагина медиации Google Mobile Ads для PubMatic OpenWrap SDK по ссылке для загрузки в журнале изменений и извлеките пакет GoogleMobileAdsPubMaticMediation.unitypackage из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsPubMaticMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .
Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.
Шаг 4: Реализуйте настройки конфиденциальности в PubMatic SDK
Согласие ЕС и GDPR
Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (GDPR). Вы несёте ответственность за проверку распространения согласия на каждый источник рекламы в вашей цепочке посредников. Google не может автоматически передавать согласие пользователя таким сетям.
PubMatic автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделах «Передача GDPR» и «Согласие GDPR» .
Законы США о конфиденциальности
Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как этот термин определен в законе). Отказ осуществляется через заметную ссылку «Не продавайте мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вам необходимо указать каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей для обеспечения соблюдения правил.
PubMatic автоматически считывает согласие CCPA, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделе «Установка строки CCPA» .
Шаг 5: Добавьте необходимый код
Андроид
Для интеграции PubMatic дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации PubMatic , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 6: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от PubMatic OpenWrap SDK, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений PubMatic (Bidding ).
Коды ошибок
Если адаптеру не удается получить рекламу от PubMatic, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo в следующих классах:
Андроид
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
iOS
GADMediationAdapterPubMatic
Вот коды и сопутствующие сообщения, выдаваемые адаптером PubMatic, когда реклама не загружается:
Андроид
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | В конфигурации сервера отсутствует требуемый идентификатор издателя. |
| 102 | com.google.ads.mediation.pubmatic | Недопустимая конфигурация объявления для загрузки. |
| 103 | com.google.ads.mediation.pubmatic | Не удалось представить рекламу, так как она не была готова. |
| 1001-5002 | Отправлено PubMatic SDK | PubMatic SDK вернул ошибку. Подробнее см. в документации PubMatic. |
iOS
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | В конфигурации сервера отсутствует требуемый идентификатор издателя. |
| 102 | com.google.ads.mediation.pubmatic | Запрос на сбор сигналов торгов не выполнен, поскольку в параметрах запроса указано несколько форматов, не указано ни одного формата или указан неподдерживаемый формат. |
| 103 | com.google.ads.mediation.pubmatic | Недопустимая конфигурация объявления для загрузки. |
| 104 | com.google.ads.mediation.pubmatic | Не удалось показать рекламное объявление, так как оно не было готово. |
| 105 | com.google.ads.mediation.pubmatic | Не удалось показать объявление с вознаграждением, так как оно не было готово. |
| 106 | com.google.ads.mediation.pubmatic | Не удалось загрузить один из источников собственных рекламных изображений. |
| 1001-5002 | Отправлено PubMatic SDK | PubMatic SDK вернул ошибку. Подробнее см. в документации PubMatic. |
Журнал изменений плагина-медиатора PubMatic Unity
Версия 1.1.0
- Поддерживает адаптер PubMatic Android версии 4.9.1.0 .
- Поддерживает адаптер PubMatic iOS версии 4.8.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.5.0.
Версия 1.0.0
- Первый релиз!
- Поддерживает адаптер PubMatic Android версии 4.8.0.0 .
- Поддерживает адаптер PubMatic iOS версии 4.8.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.4.2.