В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из AdColony с помощью посредничества , включая интеграцию ставок и водопада. В нем рассказывается, как добавить AdColony в конфигурацию медиации рекламного блока и как интегрировать AdColony SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник AdMob для AdColony имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден |
Требования
- Unity 5.6 или выше
- Последняя версия Google Mobile Ads SDK
- [Для ставок]: плагин посредничества Google Mobile Ads для AdColony 1.0.5 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе AdColony.
Зарегистрируйтесь и войдите в свою учетную запись AdColony. Добавьте свое приложение на панель издателя AdColony , нажав кнопку «Настроить новое приложение» .
Заполните форму и нажмите «Создать» внизу страницы, чтобы добавить свое приложение в AdColony.
Андроид
iOS
После создания приложения вы можете получить свой идентификатор приложения , перейдя в раздел «Монетизация» > «Приложения» в разделе «Основная информация о приложении ».
Андроид
iOS
Затем создайте новую рекламную зону, нажав кнопку «Настроить новую рекламную зону» в разделе «Рекламные зоны» на странице вашего приложения. Мы рекомендуем создать новую рекламную зону для медиации с помощью AdMob даже если она у вас уже есть.
Андроид
iOS
Для получения дополнительных инструкций по созданию рекламного места выберите вкладку, соответствующую предпочитаемому вами формату объявления.
Баннер
- Установить зону активна? на Да .
Введите имя для своей рекламной зоны.
Выберите «Баннер» в качестве размера рекламной зоны .
Введите значение ограничения ежедневной игры .
Межстраничный
- Установить зону активна? на Да .
Введите имя для своей рекламной зоны.
В качестве типа зоны выберите «Преролл/Межстраничная реклама» .
Введите значение ограничения ежедневной игры .
Награжден
- Установить зону активна? на Да .
Введите имя для своей рекламной зоны.
В качестве типа зоны выберите Value Exchange/V4VC .
Установить только клиентскую сторону? выберите «Да» и введите имя виртуальной валюты , максимальное количество видео в день на пользователя и сумму вознаграждения .
Введите значение ограничения ежедневной игры .
По завершении нажмите кнопку «Создать» , чтобы создать рекламную зону.
После создания рекламной зоны вы сможете найти свой идентификатор зоны в разделе «Интеграция» рекламной зоны. Идентификатор зоны будет использоваться на следующем этапе.
Найдите свой ключ API AdColony
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Вам понадобится ключ API AdColony для настройки идентификатора рекламного блокаAdMob . Перейдите к настройкам учетной записи на панели издателя AdColony , чтобы найти свой ключ API.
Включите тестовый режим
Чтобы включить тестовую рекламу в AdColony, перейдите на панель управления AdColony и выберите «Монетизация» > «Приложения» . Выберите свою зону, для которой вы хотите включить тестовые объявления, в разделе «Рекламные зоны» вашего приложения. Тестовые объявления можно включить, установив флажок Да для параметра Показывать только тестовые объявления? в разделе «Развитие» .
Шаг 2. Настройте запрос AdColony в пользовательском интерфейсе AdMob .
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавьте AdColony в список рекламных партнеров GDPR и государственных нормативов США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить AdColony в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе AdMob .
Шаг 3. Импортируйте AdColony SDK и адаптер.
Загрузите последнюю версию плагина посредничества Google Mobile Ads для AdColony по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsAdColonyMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsAdColonyMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Реализуйте настройки конфиденциальности в AdColony SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны обеспечить предоставление определенной информации и получение от пользователей в Европейской экономической зоне (ЕЭЗ) определенных разрешений на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для AdColony версии 2.6.1 добавил класс AdColonyAppOptions
с методами SetPrivacyFrameworkRequired()
и SetPrivacyConsentString()
, чтобы вы могли передать согласие AdColony SDK. В следующем примере кода показано, как передать информацию о согласии адаптеру AdColony, которая затем используется в методе инициализации AdColony. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в SDK AdColony.
using GoogleMobileAds.Api.Mediation.AdColony;
// ...
AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");
Дополнительную информацию и значения, которые можно указать в этом методе, см. в статье AdColony о конфиденциальности потребителей и в руководстве по реализации законов о конфиденциальности .
Законы о конфиденциальности штатов США
Законы о конфиденциальности в штатах США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе) с возможностью отказа предлагается через заметную ссылку «Не продавать мою личную информацию» на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для AdColony версии 2.6.1 добавил класс AdColonyAppOptions
с методами SetPrivacyFrameworkRequired()
и SetPrivacyConsentString()
, чтобы вы могли передать согласие AdColony SDK. В следующем примере кода показано, как передать информацию о согласии адаптеру AdColony, которая затем используется в методе инициализации AdColony. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в SDK AdColony.
using GoogleMobileAds.Api.Mediation.AdColony;
// ...
AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");
Дополнительную информацию и значения, которые можно указать в этом методе, см. в статье AdColony о конфиденциальности потребителей и в руководстве по реализации законов о конфиденциальности .
Шаг 5. Добавьте необходимый код
Андроид
Для интеграции AdColony не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации AdColony , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе AdColony .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отAdColony, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений AdColony (Bidding) and AdColony (Waterfall) .
Дополнительные шаги
Андроид
Разрешения
Для оптимальной производительности AdColony рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml
, расположенный в каталоге Assets/Plugins/Android/GoogleMobileAdsPlugin
вашего проекта Unity.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />
iOS
Для интеграции iOS не требуется никаких дополнительных действий.
Сетевые параметры
Пакет посредничества AdColony поддерживает дополнительные параметры конфигурации и запроса, которые можно передать адаптеру с помощью классов AdColonyMediationExtras
и AdColonyAppOptions
.
Класс AdColonyMediationExtras
включает следующие методы:
-
SetShowPrePopup(bool)
- Определяет, показывать ли всплывающее окно перед показом рекламы. Установите значение false, если вы не хотите показывать всплывающее окно перед показом рекламы.
-
SetShowPostPopup(bool)
- Определяет, показывать ли всплывающее окно после показа рекламы. Установите значение false, если вы не хотите показывать всплывающее окно после показа рекламы.
Класс AdColonyAppOptions
включает следующие методы:
-
SetUserId(string)
- Устанавливает идентификатор пользователя для AdColony SDK, который предоставляет дополнительную аналитику рекламному серверу AdColony.
-
SetTestMode(bool)
- Определяет, включать ли тестовый режим для AdColony SDK.
Ниже приведен пример кода, показывающий, как задать эти конфигурации и параметры запроса объявления:
// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);
// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);
AdRequest request = new AdRequest.Builder()
.AddMediationExtras(extras)
.Build();
Коды ошибок
Если адаптеру не удается получить объявление от AdColony, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter
iOS
GADMAdapterAdColony
GADMediationAdapterAdColony
Вот коды и сопутствующие сообщения, выдаваемые адаптером AdColony, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
100 | AdColony SDK возвратил ошибку. |
101 | Неверные параметры сервера (например, отсутствует идентификатор зоны). |
102 | Объявление уже было запрошено для того же идентификатора зоны. |
103 | AdColony SDK возвратил ошибку инициализации. |
104 | Запрошенный размер баннера не соответствует допустимому размеру объявления AdColony. |
105 | Ошибка презентации из-за того, что объявление не загружено. |
106 | Контекст, использованный для инициализации AdColony SDK, не был экземпляром Activity . |
iOS
Код ошибки | Причина |
---|---|
0–3 | AdColony SDK возвратил ошибку. Более подробную информацию смотрите в документации . |
101 | Неверные параметры сервера (например, отсутствует идентификатор зоны). |
102 | Контроллер корневого представления, представляющий рекламу, равен nil . |
103 | AdColony SDK возвратил ошибку инициализации. |
104 | AdColony SDK не поддерживает настройку дважды в течение пяти секунд. |
105 | Не удалось показать объявление. |
106 | Зона, используемая для вознаграждения, не является зоной вознаграждения на портале AdColony. |
Журнал изменений плагина AdColony Unity Mediation
Версия 2.6.3 (в разработке)
- Исправлено предупреждение о дублировании определения для
MediationExtras
.
Версия 2.6.2
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/AdColony/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.AdColony
. - Поддерживает адаптер AdColony Android версии 4.8.0.2 .
- Поддерживает адаптер AdColony для iOS версии 4.9.0.2 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 2.6.1
- API-интерфейсы конфиденциальности из класса
AdColonyAppOptions
обновлены до следующих методов для поддержки GDPR и CCPA:-
SetGDPRRequired(bool)
->SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
-
IsGDPRRequired()
->GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
-
SetGDPRConsentString(string)
->SetPrivacyConsentString(AdColonyPrivacyFramework, string)
-
GetGDPRConsentString()
->GetPrivacyConsentString(AdColonyPrivacyFramework)
-
- Поддерживает адаптер AdColony Android версии 4.8.0.1 .
- Поддерживает адаптер AdColony iOS версии 4.9.0.2 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 2.6.0
- Поддерживает адаптер AdColony Android версии 4.8.0.0 .
- Поддерживает адаптер AdColony для iOS версии 4.9.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.1.0.
Версия 2.5.0
- Поддерживает адаптер AdColony для Android версии 4.7.0.0 .
- Поддерживает адаптер AdColony iOS версии 4.8.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.4.1
- Поддерживает адаптер AdColony для Android версии 4.6.5.0 .
- Поддерживает адаптер AdColony для iOS версии 4.7.2.2 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.4.0
- Поддерживает адаптер AdColony Android версии 4.6.5.0 .
- Поддерживает адаптер AdColony для iOS версии 4.7.2.0 .
Версия 2.3.0
- Поддерживает адаптер AdColony для Android версии 4.5.0.0 .
- Поддерживает адаптер AdColony для iOS версии 4.6.1.0 .
Версия 2.2.0
- Поддерживает адаптер AdColony Android версии 4.2.4.0 .
- Поддерживает адаптер AdColony для iOS версии 4.4.1.0 .
Версия 2.1.0
- Поддерживает адаптер AdColony Android версии 4.2.0.0 .
- Поддерживает адаптер AdColony для iOS версии 4.3.0.0 .
Версия 2.0.3
- Переупаковал
adcolony-extras-library.jar
вadcolony-unity-android-library.aar
с использованием сборки.aar
для поддержки Unity 2020.- При обновлении до этой версии удалите
adcolony-extras-library.jar
из своего проекта.
- При обновлении до этой версии удалите
- Поддерживает адаптер AdColony Android версии 4.1.4.1 .
- Поддерживает адаптер AdColony для iOS версии 4.1.5.0 .
Версия 2.0.2
- Поддерживает адаптер AdColony Android версии 4.1.4.1 .
- Поддерживает адаптер AdColony для iOS версии 4.1.4.1 .
Версия 2.0.1
- Поддерживает адаптер AdColony Android версии 4.1.4.0 .
- Поддерживает адаптер AdColony для iOS версии 4.1.4.0 .
Версия 2.0.0
- Поддерживает адаптер AdColony Android версии 4.1.0.0 .
- Поддерживает адаптер AdColony iOS версии 4.1.2.0 .
Версия 1.0.6
- Поддерживает адаптер AdColony для Android версии 3.3.11.0 .
- Поддерживает адаптер AdColony для iOS версии 3.3.8.1.0 .
Версия 1.0.5
- Следующие методы перенесены из класса
AdColonyMediationExtras
Builder в классAdColonyAppOptions
:-
SetGDPRRequired()
-
SetGDPRConsentString()
-
SetUserId()
-
SetTestMode()
-
- В класс
AdColonyAppOptions
добавлены следующие методы:-
IsGDPRRequired()
-
GetGDPRConsentString()
-
GetUserId()
-
IsTestMode()
-
- Удален метод
SetZoneId()
из классаAdColonyMediationExtras
Builder. - Поддерживает адаптер AdColony Android версии 3.3.10.1.
- Поддерживает адаптер AdColony для iOS версии 3.3.7.2.
Версия 1.0.4
- Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
- Поддерживает адаптер AdColony Android версии 3.3.8.1.
- Поддерживает адаптер AdColony для iOS версии 3.3.6.1.
Версия 1.0.3
- Поддерживает адаптер AdColony Android версии 3.3.5.1.
- Поддерживает адаптер AdColony для iOS версии 3.3.5.0.
Версия 1.0.2
- Поддерживает AdColony Android SDK версии 3.3.4.
- Поддерживает AdColony iOS SDK версии 3.3.4.
-
SetTestMode()
из классаAdColonyMediationExtras
Builder теперь игнорируется для Android. Издатели теперь могут запрашивать тестовые объявления из AdColony для Android, указав тестовое устройство с помощьюAddTestDevice()
из классаAdRequest
Builder. - В класс
AdColonyMediationExtras
Builder добавлены следующие методы:-
SetGDPRRequired()
-
SetGDPRConsentString()
-
Версия 1.0.1
- Поддерживает AdColony Android SDK версии 3.3.0-unity.
- Поддерживает AdColony iOS SDK версии 3.3.0.
Версия 1.0.0
- Первый выпуск!
- Поддерживает AdColony Android SDK версии 3.3.0.
- Поддерживает AdColony iOS SDK версии 3.3.0.