В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из myTarget с помощью медиации , включая каскадную интеграцию. В нем рассказывается, как добавить myTarget в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер myTarget в приложение Unity.
Поддерживаемые интеграции и форматы объявлений
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением |
Требования
- Юнити 4 или выше
- Последняя версия Google Mobile Ads SDK
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе myTarget.
Сначала зарегистрируйтесь или войдите в свою учетную запись myTarget. Перейдите на страницу «Приложения», нажав «ПРИЛОЖЕНИЯ» в заголовке. Добавьте свое приложение, нажав «ДОБАВИТЬ ПРИЛОЖЕНИЕ» .
Если ваше приложение поддерживает платформы Android и iOS, вам необходимо настроить каждую из них отдельно.
Андроид
Затем укажите URL-адрес вашего приложения в Google Play .
iOS
Затем укажите URL-адрес iTunes ** для вашего приложения.
При добавлении приложения myTarget требует от вас создать рекламный блок, прежде чем вы сможете завершить процесс.
Баннер
Выберите БАННЕР из доступных форматов объявлений и нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .
Межстраничный
Выберите МЕЖОБЪЯВЛЕННЫЙ из доступных форматов объявлений, а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .
Награжден
Выберите ВИДЕО С ВОЗНАГРАЖДЕНИЕМ из доступных форматов объявлений, а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .
Родной
Выберите НАТИВНЫЙ из доступных форматов объявлений, а затем нажмите «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .
На странице сведений о вашем рекламном блоке запишите идентификатор вашего рекламного места, который можно найти в настройках рекламного блока как slot_id . Этот идентификатор рекламного места будет использоваться для настройки рекламного блока AdMob в следующем разделе.
Помимо slot_id вам также понадобится токен постоянного доступа myTarget для настройки идентификатора рекламного блока AdMob. Перейдите на вкладку «Профиль» и выберите «Токены доступа» . Нажмите «Создать токен» или «Показать токен» , чтобы просмотреть свой токен постоянного доступа myTarget.
Включите тестовый режим
Следуйте инструкциям в документации myTarget , чтобы добавить и настроить тестовое устройство в пользовательском интерфейсе myTarget.
Шаг 2. Настройте спрос myTarget в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять Mail.ru в соответствии с GDPR и списком рекламных партнеров США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Mail.ru в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе AdMob .
Шаг 3. Импортируйте myTarget SDK и адаптер.
Загрузите последнюю версию плагина-посредника Google Mobile Ads для myTarget по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsMyTargetMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMyTargetMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Реализуйте настройки конфиденциальности в myTarget SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для myTarget версии 2.1.0 включает методы SetUserConsent()
и SetUserAgeRestricted()
. В следующем примере кода показано, как передать информацию о согласии пользователя в myTarget SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Если известно, что пользователь относится к категории с ограничением по возрасту, вы также можете вызвать метод SetUserAgeRestricted()
.
MyTarget.SetUserAgeRestricted(true);
Дополнительную информацию см. в руководстве myTarget по конфиденциальности и GDPR .
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для myTarget версии 3.13.3 включает метод SetCCPAUserConsent(bool)
. В следующем примере кода показано, как передать информацию о согласии пользователя в myTarget SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
Свяжитесь со службой поддержки myTarget для получения дополнительной информации.
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции myTarget не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации myTarget , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе myTarget .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отmyTarget, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений myTarget (Waterfall) .
Коды ошибок
Если адаптеру не удается получить объявление от myTarget, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
Вот коды и сопутствующие сообщения, выдаваемые адаптером myTarget, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
100 | myTarget SDK вернул ошибку. |
101 | Параметры сервера myTarget, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому myTarget. |
103 | Запрос объявления не является запросом единого нативного объявления. |
104 | Загруженное нативное объявление из myTarget отличается от запрошенного нативного объявления. |
105 | В загруженном нативном объявлении из myTarget отсутствуют некоторые необходимые ресурсы (например, изображение или значок). |
iOS
Код ошибки | Причина |
---|---|
100 | В myTarget SDK пока нет доступной рекламы. |
101 | Параметры сервера myTarget, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | Адаптер myTarget не поддерживает запрошенный формат объявления. |
103 | Пытался показать незагруженное объявление myTarget. |
104 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому myTarget. |
105 | Отсутствуют необходимые ресурсы нативной рекламы. |
Журнал изменений плагина myTarget Unity Mediation
Версия 3.18.0
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер myTarget Android версии 5.22.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.17.1
- Поддерживает адаптер myTarget Android версии 5.21.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.17.0
- Поддерживает адаптер myTarget Android версии 5.21.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.16.2
- Поддерживает адаптер myTarget Android версии 5.20.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.16.1
- Поддерживает адаптер myTarget Android версии 5.20.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 3.16.0
- Поддерживает адаптер myTarget Android версии 5.20.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.21.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 3.15.0
- Поддерживает адаптер myTarget Android версии 5.20.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.20.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.7.0.
Версия 3.14.0
- Поддерживает адаптер myTarget Android версии 5.18.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.19.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.0.
Версия 3.13.2
- Поддерживает адаптер myTarget Android версии 5.16.5.0 .
- Поддерживает адаптер myTarget iOS версии 5.17.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 3.13.1
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/MyTarget/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.MyTarget
. - Поддерживает адаптер myTarget Android версии 5.16.4.1 .
- Поддерживает адаптер myTarget iOS версии 5.17.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 3.13.0
- Поддерживает адаптер myTarget Android версии 5.16.4.0 .
- Поддерживает адаптер myTarget iOS версии 5.17.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.0.0.
Версия 3.12.0
- Поддерживает адаптер myTarget Android версии 5.15.5.0 .
- Поддерживает адаптер myTarget iOS версии 5.16.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 3.11.4
- Поддерживает адаптер myTarget Android версии 5.15.4.0 .
- Поддерживает адаптер myTarget iOS версии 5.15.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 3.11.3
- Метод
IsConsent()
из классаMyTarget
переименован вGetUserConsent()
. - В класс
MyTarget
добавлены следующие методы:-
SetCCPAUserConsent(bool)
-
GetCCPAUserConsent()
-
- Поддерживает адаптер myTarget Android версии 5.15.3.0 .
- Поддерживает адаптер myTarget iOS версии 5.15.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 3.11.2
- Поддерживает адаптер myTarget Android версии 5.15.2.1 .
- Поддерживает адаптер myTarget iOS версии 5.15.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 3.11.1
- Поддерживает адаптер myTarget Android версии 5.15.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.15.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 3.11.0
- Поддерживает адаптер myTarget Android версии 5.15.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.15.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 3.10.2
- Поддерживает адаптер myTarget Android версии 5.14.4.0 .
- Поддерживает адаптер myTarget iOS версии 5.14.4.0 .
Версия 3.10.1
- Поддерживает адаптер myTarget Android версии 5.14.3.0 .
- Поддерживает адаптер myTarget iOS версии 5.14.2.0 .
Версия 3.10.0
- Поддерживает адаптер myTarget Android версии 5.14.2.0 .
- Поддерживает адаптер myTarget iOS версии 5.14.1.0 .
Версия 3.9.0
- Поддерживает адаптер myTarget Android версии 5.13.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.11.2.0 .
Версия 3.8.2
- Поддерживает адаптер myTarget Android версии 5.11.7.0 .
- Поддерживает адаптер myTarget iOS версии 5.9.10.0 .
Версия 3.8.1
- Поддерживает адаптер myTarget Android версии 5.11.5.0 .
- Поддерживает адаптер myTarget iOS версии 5.9.6.0 .
Версия 3.8.0
- Поддерживает адаптер myTarget Android версии 5.11.4.0 .
- Поддерживает адаптер myTarget iOS версии 5.9.5.0 .
Версия 3.7.0
- Поддерживает адаптер myTarget Android версии 5.10.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.7.5.0 .
Версия 3.6.1
- Метод
MyTarget.IsUserConsent()
переименован вMyTarget.IsConsent()
. - Поддерживает адаптер myTarget Android версии 5.9.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.7.2.0 .
Версия 3.6.0
- Поддерживает адаптер myTarget Android версии 5.9.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.7.0.0 .
Версия 3.5.2
- Поддерживает адаптер myTarget Android версии 5.8.3.0 .
- Поддерживает адаптер myTarget iOS версии 5.6.3.0 .
Версия 3.5.1
- Поддерживает адаптер myTarget Android версии 5.8.2.0 .
- Поддерживает адаптер myTarget iOS версии 5.6.1.0 .
Версия 3.5.0
- Поддерживает адаптер myTarget Android версии 5.8.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.6.0.0 .
Версия 3.4.0
- Поддерживает адаптер myTarget Android версии 5.8.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.5.2.0 .
Версия 3.3.0
- Поддерживает адаптер myTarget Android версии 5.7.0.0 .
- Поддерживает адаптер myTarget iOS версии 5.5.1.0 .
Версия 3.2.0
- Поддерживает адаптер myTarget Android версии 5.6.3.0 .
- Поддерживает адаптер myTarget iOS версии 5.4.9.0 .
Версия 3.1.0
- Поддерживает адаптер myTarget Android версии 5.4.6.0 .
- Поддерживает адаптер myTarget iOS версии 5.3.3.0 .
Версия 3.0.0
- Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
- Поддерживает адаптер myTarget Android версии 5.3.9.0.
- Поддерживает адаптер myTarget iOS версии 5.0.4.0.
Версия 2.3.2
- Поддерживает адаптер myTarget Android версии 5.2.5.0.
- Поддерживает адаптер myTarget iOS версии 4.8.9.0.
Версия 2.3.1
- Поддерживает адаптер myTarget Android версии 5.2.5.0.
- Поддерживает адаптер myTarget iOS версии 4.8.5.0.
Версия 2.3.0
- Поддерживает адаптер myTarget Android версии 5.2.2.0.
- Поддерживает адаптер myTarget iOS версии 4.8.0.0.
Версия 2.2.0
- Поддерживает адаптер myTarget Android версии 5.1.4.0.
- Поддерживает адаптер myTarget iOS версии 4.8.0.0.
Версия 2.1.2
- Поддерживает адаптер myTarget Android версии 5.1.3.0.
- Поддерживает адаптер myTarget iOS версии 4.7.11.0.
Версия 2.1.1
- Поддерживает адаптер myTarget Android версии 5.1.1.0.
- Поддерживает адаптер myTarget iOS версии 4.7.10.0.
Версия 2.1.0
- Поддерживает myTarget Android SDK версии 5.1.0.
- Поддерживает myTarget iOS SDK версии 4.7.9.
- Добавлены следующие методы:
-
MyTarget.SetUserConsent()
для пересылки статуса согласия пользователя в MyTarget SDK. -
MyTarget.SetUserAgeRestricted
Метод, который устанавливает флаг, указывающий, принадлежит ли пользователь к категории с возрастными ограничениями (т. е. младше 16 лет). -
MyTarget.IsUserConsent()
для получения текущего статуса согласия пользователя. -
MyTarget.IsUserAgeRestricted()
для получения флага, указывающего, что пользователь относится к категории с возрастными ограничениями (т. е. младше 16 лет).
-
Версия 2.0.1
- Поддерживает myTarget Android SDK версии 5.0.2.
- Поддерживает myTarget iOS SDK версии 4.7.8.
Версия 2.0.0
- Поддерживает myTarget Android SDK версии 5.0.0.
- Поддерживает myTarget iOS SDK версии 4.7.7.
Версия 1.1.0
- Поддерживает myTarget Android SDK версии 4.7.2.
- Поддерживает myTarget iOS SDK версии 4.7.6.
Версия 1.0.0
- Первый выпуск!
- Поддерживает myTarget Android SDK версии 4.6.27.
- Поддерживает myTarget iOS SDK версии 4.6.24.