В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Unity Ads с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить Unity Ads в конфигурацию медиации рекламного блока, а также как интегрировать Unity Ads SDK и адаптер в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер медиации для Unity Ads имеет следующие возможности:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничный | |
| Награжден | |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Unity Ads.
Зарегистрируйтесь или войдите в Unity Ads.
Создать проект
На панели управления Unity Ads перейдите в раздел «Проекты» и нажмите «Создать проект» .
Заполните форму и нажмите «Создать проект», чтобы добавить свой проект.
Перейдите в раздел «Монетизация» > «Начать» , затем нажмите «Начать» .
В модальном окне «Настройка проекта » выберите «Я планирую использовать Mediation и Google Admob для партнера-посредника» , затем нажмите «Далее» .
Выберите настройки рекламы и нажмите «Далее» .
Заполните форму и нажмите «Добавить проект» .
Обратите внимание на идентификатор игры .
Создать рекламный блок
Перейдите в «Монетизация» > «Рекламные блоки» , затем нажмите «Добавить рекламный блок» .
Введите название рекламного блока , затем выберите платформу и формат объявления .
Андроид
iOS
Наконец, нажмите «Создать» , чтобы сохранить рекламный блок.
Добавить место размещения
Торги
Свяжитесь с менеджером своего аккаунта Google, чтобы создать места размещения для ставок.
Водопад
После создания проекта перейдите в раздел «Монетизация» > «Плейсменты» . Чтобы создать новое место размещения, нажмите «Добавить место размещения» для своего рекламного блока.
Заполните необходимые данные и нажмите «Добавить место размещения» .
Обратите внимание на идентификатор места размещения .
Андроид
iOS
Найдите ключ API отчетов Unity Ads.
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо идентификатора игры и идентификатора места размещения , вам также понадобится ключ Unity Ads API и основной идентификатор организации для настройки идентификатора рекламного блока AdMob.
Перейдите в раздел «Монетизация» > «Настройка» > «Управление API» и запишите ключ доступа к API статистики монетизации .
Затем перейдите в раздел «Монетизация» > «Настройки организации» и запишите основной идентификатор организации .
Включите тестовый режим
Тестовый режим можно включить из панели управления Unity Ads . В настройках вашего проекта выберите вкладку «Тестирование» .
Вы можете принудительно включить тестовый режим для своего приложения, нажав кнопку «Изменить» на каждой платформе, отметив «Переопределить тестовый режим клиента» и выбрав «Включить тестовый режим» (т. е. использовать тестовые объявления) для всех устройств .
Андроид
iOS
Кроме того, вы можете включить тестовый режим для определенных устройств, нажав кнопку «Добавить тестовое устройство» .
Заполните форму и нажмите Сохранить .
Шаг 2. Настройте спрос на Unity Ads в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Добавлять Unity Ads в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить Unity Ads в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте Unity Ads SDK и адаптер.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиUnity Ads SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_unity: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляUnity Ads , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиUnity Ads SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_unity: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляUnity Ads , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в Unity Ads SDK
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setGDPRConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
Дополнительные сведения и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API данных» и «Соблюдение GDPR» .
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setCCPAConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции Unity Ads с Android дополнительный код не требуется.
iOS
Интеграция со SKAdNetwork
Следуйте документации Unity Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для AdMob и включили тестовый режим в пользовательском интерфейсе Unity Ads.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Unity Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Unity Ads (Bidding) и Unity Ads (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Unity Ads, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo в следующих классах:
Андроид
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Вот коды и сопутствующие сообщения, выдаваемые адаптером UnityAds, когда объявление не загружается:
Андроид
| Код ошибки | Причина |
|---|---|
| 0-10 | UnityAds SDK возвратил ошибку. См. код для более подробной информации. |
| 101 | Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют/недействительны. |
| 102 | UnityAds вернул место размещения со статусом NO_FILL. |
| 103 | UnityAds вернул место размещения в состоянии ОТКЛЮЧЕНО. |
| 104 | UnityAds попыталась показать рекламу с нулевым контекстом. |
| 105 | Контекст, используемый для инициализации, загрузки и/или показа рекламы из Unity Ads, не является экземпляром Activity. |
| 106 | UnityAds попыталась показать рекламу, которая еще не готова к показу. |
| 107 | UnityAds не поддерживается на устройстве. |
| 108 | UnityAds может загружать только одно объявление на одно место размещения одновременно. |
| 109 | UnityAds завершил работу с состоянием ОШИБКА. |
| 200-204 | Баннер UnityAds: конкретная ошибка. См. код для более подробной информации. |
iOS
| 0-9 | UnityAds SDK возвратил ошибку. Дополнительную информацию см. в документации Unity. |
| 101 | Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют/недействительны. |
| 102 | Устройство не поддерживается UnityAds. |
| 103 | UnityAds завершил представление с состоянием ошибки kUnityAdsFinishStateError. |
| 104 | Объект объявления Unity равен нулю после вызова его инициализатора. |
| 105 | Не удалось показать Unity Ads, поскольку объявление не готово. |
| 106 | UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateNoFill. |
| 107 | UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateDisabled. |
| 108 | Объявление для этого места размещения уже загружено. UnityAds SDK не поддерживает загрузку нескольких объявлений для одного места размещения. |
Журнал изменений адаптера Unity Ads Flutter Mediation
Версия 1.1.0
- Проверенная совместимость с адаптером Unity Android версии 4.12.3.0.
- Проверенная совместимость с адаптером Unity iOS версии 4.12.3.1.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.
Версия 1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Unity Android версии 4.10.0.0.
- Проверенная совместимость с адаптером Unity iOS версии 4.10.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.
В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Unity Ads с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить Unity Ads в конфигурацию медиации рекламного блока, а также как интегрировать Unity Ads SDK и адаптер в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер медиации для Unity Ads имеет следующие возможности:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничный | |
| Награжден | |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Unity Ads.
Зарегистрируйтесь или войдите в Unity Ads.
Создать проект
На панели управления Unity Ads перейдите в раздел «Проекты» и нажмите «Создать проект» .
Заполните форму и нажмите «Создать проект», чтобы добавить свой проект.
Перейдите в раздел «Монетизация» > «Начать» , затем нажмите «Начать» .
В модальном окне «Настройка проекта » выберите «Я планирую использовать Mediation и Google Admob для партнера-посредника» , затем нажмите «Далее» .
Выберите настройки рекламы и нажмите «Далее» .
Заполните форму и нажмите «Добавить проект» .
Обратите внимание на идентификатор игры .
Создать рекламный блок
Перейдите в «Монетизация» > «Рекламные блоки» , затем нажмите «Добавить рекламный блок» .
Введите название рекламного блока , затем выберите платформу и формат объявления .
Андроид
iOS
Наконец, нажмите «Создать» , чтобы сохранить рекламный блок.
Добавить место размещения
Торги
Свяжитесь с менеджером своего аккаунта Google, чтобы создать места размещения для ставок.
Водопад
После создания проекта перейдите в раздел «Монетизация» > «Плейсменты» . Чтобы создать новое место размещения, нажмите «Добавить место размещения» для своего рекламного блока.
Заполните необходимые данные и нажмите «Добавить место размещения» .
Обратите внимание на идентификатор места размещения .
Андроид
iOS
Найдите ключ API отчетов Unity Ads.
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо идентификатора игры и идентификатора места размещения , вам также понадобится ключ Unity Ads API и основной идентификатор организации для настройки идентификатора рекламного блока AdMob.
Перейдите в раздел «Монетизация» > «Настройка» > «Управление API» и запишите ключ доступа к API статистики монетизации .
Затем перейдите в раздел «Монетизация» > «Настройки организации» и запишите основной идентификатор организации .
Включите тестовый режим
Тестовый режим можно включить из панели управления Unity Ads . В настройках вашего проекта выберите вкладку «Тестирование» .
Вы можете принудительно включить тестовый режим для своего приложения, нажав кнопку «Изменить» на каждой платформе, отметив «Переопределить тестовый режим клиента» и выбрав «Включить тестовый режим» (т. е. использовать тестовые объявления) для всех устройств .
Андроид
iOS
Кроме того, вы можете включить тестовый режим для определенных устройств, нажав кнопку «Добавить тестовое устройство» .
Заполните форму и нажмите Сохранить .
Шаг 2. Настройте спрос на Unity Ads в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Добавлять Unity Ads в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить Unity Ads в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте Unity Ads SDK и адаптер.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиUnity Ads SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_unity: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляUnity Ads , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиUnity Ads SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_unity: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляUnity Ads , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в Unity Ads SDK
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setGDPRConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
Дополнительные сведения и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API данных» и «Соблюдение GDPR» .
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setCCPAConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции Unity Ads с Android дополнительный код не требуется.
iOS
Интеграция со SKAdNetwork
Следуйте документации Unity Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для AdMob и включили тестовый режим в пользовательском интерфейсе Unity Ads.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Unity Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Unity Ads (Bidding) и Unity Ads (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Unity Ads, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo в следующих классах:
Андроид
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Вот коды и сопутствующие сообщения, выдаваемые адаптером UnityAds, когда объявление не загружается:
Андроид
| Код ошибки | Причина |
|---|---|
| 0-10 | UnityAds SDK возвратил ошибку. См. код для более подробной информации. |
| 101 | Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют/недействительны. |
| 102 | UnityAds вернул место размещения со статусом NO_FILL. |
| 103 | UnityAds вернул место размещения в состоянии ОТКЛЮЧЕНО. |
| 104 | UnityAds попыталась показать рекламу с нулевым контекстом. |
| 105 | Контекст, используемый для инициализации, загрузки и/или показа рекламы из Unity Ads, не является экземпляром Activity. |
| 106 | UnityAds попыталась показать рекламу, которая еще не готова к показу. |
| 107 | UnityAds не поддерживается на устройстве. |
| 108 | UnityAds может загружать только одно объявление на одно место размещения одновременно. |
| 109 | UnityAds завершил работу с состоянием ОШИБКА. |
| 200-204 | Баннер UnityAds: конкретная ошибка. См. код для более подробной информации. |
iOS
| 0-9 | UnityAds SDK возвратил ошибку. Дополнительную информацию см. в документации Unity. |
| 101 | Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют/недействительны. |
| 102 | Устройство не поддерживается UnityAds. |
| 103 | UnityAds завершил представление с состоянием ошибки kUnityAdsFinishStateError. |
| 104 | Объект объявления Unity равен нулю после вызова его инициализатора. |
| 105 | Не удалось показать Unity Ads, поскольку объявление не готово. |
| 106 | UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateNoFill. |
| 107 | UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateDisabled. |
| 108 | Объявление для этого места размещения уже загружено. UnityAds SDK не поддерживает загрузку нескольких объявлений для одного места размещения. |
Журнал изменений адаптера Unity Ads Flutter Mediation
Версия 1.1.0
- Проверенная совместимость с адаптером Unity Android версии 4.12.3.0.
- Проверенная совместимость с адаптером Unity iOS версии 4.12.3.1.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.
Версия 1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Unity Android версии 4.10.0.0.
- Проверенная совместимость с адаптером Unity iOS версии 4.10.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.